CKTIS / JavaScript
HTMLTemplateElement: inerte template-inhoud
HTMLTemplateElement slaat template-inhoud op in een afzonderlijk DocumentFragment dat via content toegankelijk is. De inhoud wordt niet in de template weergegeven; kopieer deze met document.importNode() en voeg haar in het document in zonder het origineel op te gebruiken.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const template = document.createElement("template");
template.content.append(document.createElement("p"));
const fragment = document.importNode(template.content, true);
document.body.append(fragment);Inerte template-inhoud is de inhoud van een gewoon template-element, die wordt bewaard voor later gebruik in plaats van te worden weergegeven op de plek waar deze is gedeclareerd. De interface HTMLTemplateElement stelt deze inhoud via content beschikbaar als een DocumentFragment. Dit is een browser-DOM-API, geen ECMAScript-functie; alleen de aanwezigheid van Node.js 24 toont niet aan dat deze beschikbaar is.
Zoek templateknooppunten met template.content.querySelector(), niet met template.querySelector(). Geparseerde inhoud hoort bij het fragment, niet bij de gewone kinderen van het element. De eigenschap content is alleen-lezen, maar het fragment zelf kan wel worden aangepast. Deze inertie is niet hetzelfde als het globale attribuut inert, dat interactie met bestaande elementen beperkt.
Gebruik document.importNode(template.content, true) om de volledige deelboom te kopiëren in de context van het doeldocument. Dit is belangrijk voor het maken van aangepaste elementen, omdat template-inhoud bij een afzonderlijk document hoort. Als je een fragment invoegt, worden de kinderen ervan naar de bestemming verplaatst en wordt het fragment leeggemaakt. Als je template.content rechtstreeks invoegt, verbruik je de template-inhoud dus in plaats van deze voor hergebruik te bewaren.
De kerninterface en content zijn sinds november 2015 breed beschikbaar in browsers; voor nieuwere functies zijn afzonderlijke compatibiliteitscontroles nodig. Het voorbeeld gaat over een gewone template, niet over declaratieve Shadow DOM: tijdens het parsen kan een passende declaratie met shadowrootmode een ShadowRoot maken in plaats van een HTMLTemplateElement.
Voorbeelden
(() => {
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();
})();Resultaat
before: 0 rendered: Hello, template! template: Hello fragment children: 0
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.