CKTIS / JavaScript
HTMLTemplateElement.content: il frammento inerte del template
`template.content` espone il contenuto inerte di un template come `DocumentFragment`. Per riutilizzare il template, copia il suo sottoalbero nel documento di destinazione e inserisci la copia.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
template.contentcontent è una proprietà di istanza di sola lettura di HTMLTemplateElement: restituisce sempre lo stesso DocumentFragment, di cui puoi leggere e modificare i nodi. Il markup all’interno di un normale elemento template viene analizzato e inserito in quel frammento, non come figli dell’elemento stesso. Per cercare nodi nel contenuto, usa template.content.querySelector(...), non template.querySelector(...).
In un normale documento HTML, ownerDocument del frammento è un documento separato senza contesto di navigazione. Se il template appartiene già a un documento creato per ospitare il contenuto dei template, il frammento riutilizza quel documento. Collegare il template alla pagina non mostra il contenuto e non esegue gli script che si trovano ancora nel frammento. Il fatto che il contenuto sia inerte non sostituisce la sanitizzazione: HTML non attendibile può restare pericoloso quando viene inserito. Usa textContent per il testo semplice.
Per poter riutilizzare il template, chiama document.importNode(template.content, true) sul documento di destinazione e inserisci la copia. true copia anche i discendenti; se ometti l’argomento o passi false, ottieni una copia vuota del frammento. A differenza di cloneNode(true), l’importazione usa il contesto del documento di destinazione, rilevante per il registro degli elementi personalizzati. Inserire un frammento ne sposta i figli, non il frammento stesso, che rimane vuoto. Se inserisci l’originale, svuoti il template.
Questa è un’API del DOM HTML, non fa parte di ECMAScript 2024. Il solo supporto di JavaScript non garantisce che l’API sia disponibile.
Esempi
<!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>Risultato
template children: 0 original children: 1 inserted: true, Hello copy children: 0
Apri il file HTML in un browser e controlla la console degli strumenti di sviluppo. Il template non ha figli diretti, il frammento originale conserva il paragrafo, la copia inserita del paragrafo è collegata al documento e il frammento copiato è vuoto.
Lezioni correlate
- JavaScript · Lezione 16 · Avanzato · Versione: 4