CKTIS / JavaScript
HTMLTemplateElement.content: neaktivní fragment šablony
`template.content` zpřístupňuje neaktivní obsah šablony jako `DocumentFragment`. Chcete-li šablonu znovu použít, zkopírujte její podstrom do cílového dokumentu a vložte kopii.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
template.contentcontent je vlastnost instance HTMLTemplateElement pouze pro čtení: pokaždé vrací stejný DocumentFragment, jehož uzly lze číst i měnit. Značky uvnitř běžného prvku template se při zpracování uloží do tohoto fragmentu, nikoli jako potomci samotného prvku. K vyhledávání uzlů v obsahu použijte template.content.querySelector(...), nikoli template.querySelector(...).
V běžném dokumentu HTML odkazuje ownerDocument fragmentu na samostatný dokument bez kontextu procházení. Pokud už šablona patří do dokumentu vytvořeného pro obsah šablon, fragment použije tentýž dokument. Ani připojení šablony ke stránce nezobrazí její obsah a nespustí skripty, které zůstaly ve fragmentu. Neaktivita nenahrazuje sanitizaci: nedůvěryhodné HTML může být po vložení nadále nebezpečné. Pro prostý text používejte textContent.
Chcete-li šablonu zachovat pro další použití, zavolejte document.importNode(template.content, true) na cílovém dokumentu a vložte kopii. true kopíruje i potomky; vynecháním argumentu nebo předáním false získáte prázdnou kopii fragmentu. Na rozdíl od cloneNode(true) používá import kontext cílového dokumentu, což je důležité pro registr vlastních prvků. Vložením fragmentu přesunete jeho přímé potomky, nikoli fragment samotný, a fragment zůstane prázdný. Pokud vložíte originál, vyprázdníte šablonu.
Jde o rozhraní HTML DOM, nikoli o součást ECMAScriptu 2024. Samotná podpora JavaScriptu nezaručuje dostupnost tohoto rozhraní.
Pří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ýsledek
template children: 0 original children: 1 inserted: true, Hello copy children: 0
Otevřete soubor HTML v prohlížeči a výsledek zkontrolujte v konzoli vývojářských nástrojů. Šablona nemá přímé potomky, původní fragment si ponechá odstavec, vložená kopie odstavce je připojena k dokumentu a zkopírovaný fragment je prázdný.
Související lekce
- JavaScript · Lekce 16 · Pokročilá · Verze: 4