CKTIS / JavaScript
HTMLTemplateElement.content: het inerte sjabloonfragment
`template.content` geeft toegang tot de inerte inhoud van een sjabloon als `DocumentFragment`. Om het sjabloon opnieuw te gebruiken, kopieer je de deelboom naar het doeldocument en voeg je de kopie in.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
template.contentcontent is een alleen-lezen instantie-eigenschap van HTMLTemplateElement: je krijgt steeds hetzelfde DocumentFragment terug, maar je kunt de knopen erin lezen en wijzigen. Markup binnen een gewoon template-element wordt in dat fragment geparseerd. De resulterende knopen zijn dus geen kinderen van het element zelf. Zoek in de inhoud met template.content.querySelector(...), niet met template.querySelector(...).
In een normaal HTML-document verwijst ownerDocument van het fragment naar een apart document zonder browsecontext. Als het sjabloon al bij een document hoort dat voor sjablooninhoud is aangemaakt, gebruikt het fragment dat document. Ook als je het sjabloon aan de pagina koppelt, wordt de inhoud niet weergegeven en worden scripts die nog in het fragment staan niet uitgevoerd. Inert betekent niet opgeschoond: onbetrouwbare HTML kan bij het invoegen nog steeds gevaarlijk zijn. Gebruik textContent voor platte tekst.
Om het sjabloon opnieuw te kunnen gebruiken, roep je document.importNode(template.content, true) aan op het doeldocument en voeg je daarna de kopie in. true kopieert ook de afstammelingen; als je het argument weglaat of false meegeeft, krijg je een lege kopie van het fragment. Anders dan cloneNode(true) gebruikt de import de context van het doeldocument, wat van belang is voor het register van aangepaste elementen. Bij het invoegen van een fragment verplaats je de kinderen, niet het fragment zelf, en blijft het fragment leeg achter. Voeg je het origineel in, dan maak je het sjabloon leeg.
Dit is een HTML-DOM-API en geen onderdeel van ECMAScript 2024. Ondersteuning voor JavaScript alleen garandeert niet dat deze API beschikbaar is.
Voorbeelden
<!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>Resultaat
template children: 0 original children: 1 inserted: true, Hello copy children: 0
Open het HTML-bestand in een browser en bekijk de uitvoer in de console van de ontwikkelaarstools. Het sjabloon heeft geen directe kinderen, het oorspronkelijke fragment behoudt zijn alinea, de ingevoegde kopie van de alinea is verbonden met het document en het gekopieerde fragment is leeg.
Gerelateerde lessen
- JavaScript · Les 16 · Gevorderd · Versie: 4