CKTIS / JavaScript
HTMLTemplateElement.content: neaktívny fragment šablóny
`template.content` sprístupňuje neaktívny obsah šablóny ako `DocumentFragment`. Ak chcete šablónu použiť znova, skopírujte jej podstrom do cieľového dokumentu a vložte kópiu.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
template.contentcontent je vlastnosť inštancie HTMLTemplateElement určená len na čítanie: vždy vráti ten istý DocumentFragment, ktorého uzly môžete čítať a meniť. Značky vo vnútri bežného prvku template sa pri spracovaní uložia do tohto fragmentu, nie ako potomkovia samotného prvku. Na vyhľadávanie uzlov v obsahu použite template.content.querySelector(...), nie template.querySelector(...).
V bežnom dokumente HTML odkazuje ownerDocument fragmentu na samostatný dokument bez kontextu prehliadania. Ak šablóna už patrí do dokumentu vytvoreného na uchovávanie obsahu šablón, fragment použije ten istý dokument. Ani pripojenie šablóny k stránke nezobrazí jej obsah a nespustí skripty, ktoré zostali vo fragmente. Neaktívnosť nenahrádza sanitizáciu: nedôveryhodné HTML môže byť po vložení stále nebezpečné. Na obyčajný text používajte textContent.
Ak chcete šablónu zachovať na ďalšie použitie, zavolajte document.importNode(template.content, true) na cieľovom dokumente a vložte kópiu. true kopíruje aj potomkov; vynechaním argumentu alebo zadaním false získate prázdnu kópiu fragmentu. Na rozdiel od cloneNode(true) import používa kontext cieľového dokumentu, čo je dôležité pre register vlastných prvkov. Vložením fragmentu presuniete jeho priamych potomkov, nie samotný fragment, a fragment ostane prázdny. Vložením originálu vyprázdnite šablónu.
Ide o rozhranie HTML DOM, nie o súčasť ECMAScriptu 2024. Samotná podpora JavaScriptu nezaručuje dostupnosť tohto rozhrania.
Príklady
<!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>Výsledok
template children: 0 original children: 1 inserted: true, Hello copy children: 0
Otvorte súbor HTML v prehliadači a skontrolujte výstup v konzole vývojárskych nástrojov. Šablóna nemá priamych potomkov, pôvodný fragment si ponechá odsek, vložená kópia odseku je pripojená k dokumentu a skopírovaný fragment je prázdny.
Súvisiace lekcie
- JavaScript · Lekcia 16 · Pokročilá · Verzia: 4