CKTIS / HTML
template — um modelo de fragmento HTML
O elemento `template` contém um fragmento HTML inerte que um script pode copiar e inserir no documento. O seu conteúdo está acessível através de `content`, não como filhos normais do elemento.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<template id="item-template"><li></li></template>O elemento template declara um fragmento HTML para utilização posterior. Um modelo normal não apresenta o seu conteúdo; este permanece inerte, pelo que os scripts nele contidos não são executados enquanto ali estiver armazenado. São necessárias as etiquetas de abertura e de fecho.
A propriedade content de HTMLTemplateElement expõe um DocumentFragment. Os elementos escritos entre as etiquetas pertencem a esse fragmento, e não aos filhos normais de template. Procure-os com template.content.querySelector(...); adicionar filhos diretamente a template viola o seu modelo de conteúdo.
Utilize template.content.cloneNode(true) para copiar a estrutura em profundidade. Preencha a cópia e insira-a no documento. A inserção de um fragmento move os seus filhos, deixando o próprio fragmento vazio. Inserir o content original em vez de uma cópia esvaziaria o modelo.
O DOM sombra declarativo é uma utilização distinta: shadowrootmode pode levar o analisador a criar uma raiz sombra em vez de um modelo normal. O exemplo abaixo não utiliza esse atributo.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Template example</title>
</head>
<body>
<template id="item-template"><li></li></template>
<ul id="items"></ul>
<script>
const template = document.getElementById('item-template');
const items = document.getElementById('items');
for (const name of ['Ada', 'Lin']) {
const fragment = template.content.cloneNode(true);
fragment.querySelector('li').textContent = name;
items.appendChild(fragment);
}
</script>
</body>
</html>Resultado
• Ada • Lin
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.