<template> 大約在 2013 年進入人們視野,顧名思義,它用來宣告「這是一段模板」。
在此之前,我們想在 HTML 裡嵌入模板,常見寫法是這樣:
<script type="text/template">
// ...
</script>
但 text/template 並不是標準 MIME 類型,這只是社群約定俗成的用法。更早以前,也有人把未轉義的 HTML 塞進 <textarea> 或 <xmp>(已廢止但多數瀏覽器仍支援)裡,用來實作一些前端小技巧。這些做法都能跑,但都不規範——<template> 的出現就是為了讓這件事有個正式答案。今天的瀏覽器幾乎都已支援它,而宣告式 Shadow DOM 更是把這個元素的能力又往前推了一層。
先看同一張圖片用四種容器包起來的差異:
<script type="text/template">
<img src="mm1.jpg" />
</script>
<textarea style="display: none;">
<img src="mm1.jpg" />
</textarea>
<xmp style="display: none;">
<img src="mm1.jpg" />
</xmp>
<template>
<img src="mm1.jpg" />
</template>
<script> 的內容會被當成字串處理,所以天生不顯示;但編輯器裡有個惱人的問題——在 script 內寫模板 HTML 時,自動補全省的永遠是 </script>。<textarea> 是輸入域,裡面的片段會變成它的值,而且輸入域本身可見,必須額外加上 display: none。<xmp> 語義是 example,據說後來被 <pre> 取代而廢止,實際上目前所有瀏覽器都還支援,但它和 <pre> 不能劃上等號:<pre> 裡放 <img> 會顯示一張圖,<xmp> 呈現的則是一段 HTML 原始碼;同樣地,要讓它不顯示也得自己設 display: none。
回頭看 <template>——它沒有任何 display: none,卻什麼都不顯示。這正是它發揮了原本特性:預設隱藏,且內部內容絕對不會被渲染。這就是 <template> 的第一個特徵:標籤內容隱藏性。
除了內容天生隱藏,<template> 放在哪裡也沒有限制,跟 <script>、<style> 一樣,寫在 <head>、<body> 或 <frameset> 裡都可以。
肉眼看 template 裡明明有一堆子標籤,但慣性思維在這裡不管用。假設 template 變數是你取得的一個 template DOM:
template.childNodes; // 空的,什麼都沒有
想拿完整的 HTML 片段,用 innerHTML 即可。若你堅持要拿到「虛擬子元素」,就得請出 content 屬性——它會回傳一個文件片段(DocumentFragment),你可以把它理解成另一份 document,接著用該文件上的查詢 API 就能取得 template 內部的節點。例如抓第一張圖片:
var image_first = template.content.querySelector('img');
如果不認識 <template> 的瀏覽器把它當成普通自訂元素,内部的標籤就會照一般規則渲染出來;而支援它的瀏覽器則會讓內部內容直接「不參與渲染」。
也就是說,從 CSS 的角度看,<template> 就是個普通的、可以正常套樣式的元素;但從 HTML 的角度看,它有點像把內部標籤丟進另一個空間的能力。
預設情況下它是隱藏的,本質上就是 display 等於 none,驗證一下:
window.getComputedStyle(template).display; // "none"
所以若你想讓模板可見來除錯,自己覆寫即可:
template { display: block; }
如果你只是把模板當字串處理(像目前流行的前端框架那樣),template.innerHTML 就夠用了。但 <template> 比 <script> 強的地方在於:<script> 內部只能當字串讀取,而 template 的內容雖然存在「另一個空間」,卻依然能用節點方式取得,並且可以完整複製:
var clone = document.importNode(template.content, true);
document.body.appendChild(clone); // 直接附加節點,而非附加字串
差別就在這裡:你可以用 appendChild 掛上真正的節點,而不是只能無奈地塞字串。這個能力讓 template 特別適合處理重複的卡片、列表項、表單列這類結構。
<template> 的行為、表現與用法大致就是這樣。它是特殊場景下的利器,那種「把內容放進另一個空間」的設計也確實令人印象深刻——比起 <hgroup> 這類元素,它更實用、也更值得投入。