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

CKTIS / JavaScript

HTMLTemplateElement.content: o fragmento inerte do modelo

`template.content` dá acesso ao conteúdo inerte de um modelo como um `DocumentFragment`. Para reutilizar o modelo, copia a respetiva subárvore para o documento de destino e insere a cópia.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

template.content

content é uma propriedade de instância só de leitura de HTMLTemplateElement: devolve sempre o mesmo DocumentFragment, cujos nós podes consultar e alterar. A marcação dentro de um elemento template normal é analisada e colocada nesse fragmento, não como filhos do próprio elemento. Para procurar nós no conteúdo, usa template.content.querySelector(...), não template.querySelector(...).

Num documento HTML normal, ownerDocument do fragmento aponta para um documento separado sem contexto de navegação. Se o modelo já pertencer a um documento criado para guardar conteúdo de modelos, o fragmento reutiliza esse documento. Ligar o modelo à página não apresenta o seu conteúdo nem executa os scripts que ainda estão no fragmento. O facto de o conteúdo ser inerte não substitui a sanitização: HTML não fiável pode continuar a ser perigoso quando inserido. Usa textContent para texto simples.

Para manter o modelo reutilizável, chama document.importNode(template.content, true) no documento de destino e insere a cópia. true também copia os descendentes; omitir o argumento ou passar false dá uma cópia vazia do fragmento. Ao contrário de cloneNode(true), a importação usa o contexto do documento de destino, o que é relevante para o registo de elementos personalizados. Inserir um fragmento move os seus filhos, não o próprio fragmento, e deixa-o vazio. Se inserires o original, esvazias o modelo.

Esta é uma API do DOM de HTML, não faz parte do ECMAScript 2024. O suporte para JavaScript, por si só, não garante a disponibilidade da API.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Template content example</title>
</head>
<body>
  <script>
    (() => {
      const template = document.createElement('template');
      const paragraph = document.createElement('p');
      paragraph.textContent = 'Hello';

      const original = template.content;
      original.appendChild(paragraph);

      const host = document.createElement('div');
      host.appendChild(template);
      document.body.appendChild(host);

      const copy = document.importNode(original, true);
      const inserted = copy.firstElementChild;
      host.appendChild(copy);

      console.log(`template children: ${template.childNodes.length}`);
      console.log(`original children: ${original.childNodes.length}`);
      console.log(`inserted: ${inserted.isConnected}, ${inserted.textContent}`);
      console.log(`copy children: ${copy.childNodes.length}`);
      host.remove();
    })();
  </script>
</body>
</html>

Resultado

template children: 0
original children: 1
inserted: true, Hello
copy children: 0

Abre o ficheiro HTML num navegador e consulta a consola das ferramentas de desenvolvimento. O modelo não tem filhos diretos, o fragmento original conserva o parágrafo, a cópia inserida do parágrafo fica ligada ao documento e o fragmento copiado fica vazio.

Lições relacionadas

  • JavaScript · Lição 16 · Avançado · Versão: 4

Fontes