Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLTemplateElement: contenuto inerte del modello

HTMLTemplateElement memorizza il contenuto del modello in un DocumentFragment separato, accessibile tramite content. Il contenuto non viene visualizzato all’interno del modello; lo si può copiare con document.importNode() e inserire nel documento senza consumare l’originale.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

const template = document.createElement("template");
template.content.append(document.createElement("p"));
const fragment = document.importNode(template.content, true);
document.body.append(fragment);

Il contenuto inerte del modello è il contenuto di un normale elemento template, conservato per essere usato in seguito anziché visualizzato nel punto in cui è dichiarato. L’interfaccia HTMLTemplateElement espone questo contenuto tramite content come DocumentFragment. Si tratta di un’API DOM del browser, non di una funzionalità ECMAScript; la sola presenza di Node.js 24 non ne dimostra la disponibilità.

Cerca i nodi del modello con template.content.querySelector(), non con template.querySelector(). Il contenuto analizzato appartiene al fragment, non ai normali figli dell’elemento. La proprietà content è di sola lettura, ma il fragment stesso può essere modificato. Questa inerzia non è la stessa cosa dell’attributo globale inert, che limita l’interazione con gli elementi esistenti.

Usa document.importNode(template.content, true) per copiare l’intero sottoalbero nel contesto del documento di destinazione. Questo è importante per la creazione di elementi personalizzati, perché il contenuto del modello appartiene a un documento separato. Quando si inserisce un fragment, i suoi figli vengono spostati nella destinazione e il fragment viene svuotato. Inserendo direttamente template.content, quindi, si consumerebbe il contenuto del modello invece di conservarlo per riutilizzarlo.

L’interfaccia di base e content sono ampiamente disponibili nei browser da novembre 2015; le funzionalità più recenti richiedono verifiche di compatibilità separate. L’esempio riguarda un modello normale, non lo Shadow DOM dichiarativo: durante l’analisi, una dichiarazione appropriata che usa shadowrootmode può creare un ShadowRoot al posto di un HTMLTemplateElement.

Esempi

(() => {
  const template = document.createElement("template");
  const paragraph = document.createElement("p");
  paragraph.textContent = "Hello";
  template.content.append(paragraph);

  const host = document.createElement("section");
  document.body.append(host);
  console.log(`before: ${host.childElementCount}`);

  const fragment = document.importNode(template.content, true);
  fragment.querySelector("p").textContent = "Hello, template!";
  host.append(fragment);

  console.log(`rendered: ${host.textContent}`);
  console.log(`template: ${template.content.textContent}`);
  console.log(`fragment children: ${fragment.childNodes.length}`);
  host.remove();
})();

Risultato

before: 0
rendered: Hello, template!
template: Hello
fragment children: 0

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti