Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes