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.