CKTIS / JavaScript
HTMLTemplateElement: neaktivní obsah šablony
HTMLTemplateElement ukládá obsah šablony v samostatném DocumentFragment, který je dostupný přes content. Obsah se uvnitř šablony nevykresluje; lze ho zkopírovat pomocí document.importNode() a vložit do dokumentu, aniž by se spotřeboval originál.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const template = document.createElement("template");
template.content.append(document.createElement("p"));
const fragment = document.importNode(template.content, true);
document.body.append(fragment);Neaktivní obsah šablony označuje obsah běžného prvku template, který se uchovává pro pozdější použití, místo aby se vykreslil v místě deklarace. Rozhraní HTMLTemplateElement zpřístupňuje tento obsah přes content jako DocumentFragment. Jde o rozhraní DOM prohlížeče, nikoli o funkci ECMAScriptu; samotná přítomnost Node.js 24 nedokládá jeho dostupnost.
Uzly šablony vyhledávejte pomocí template.content.querySelector(), nikoli template.querySelector(). Naparsovaný obsah patří do fragmentu, ne mezi běžné potomky prvku. Vlastnost content je jen pro čtení, ale samotný fragment lze měnit. Tato neaktivita není totéž co globální atribut inert, který omezuje interakci s existujícími prvky.
Pomocí document.importNode(template.content, true) zkopírujte celý podstrom v kontextu cílového dokumentu. To je důležité při vytváření vlastních prvků, protože obsah šablony patří do samostatného dokumentu. Vložením fragmentu se jeho potomci přesunou do cíle a fragment se vyprázdní. Přímým vložením template.content by se tedy obsah šablony spotřeboval místo toho, aby zůstal zachován pro opakované použití.
Základní rozhraní a content jsou v prohlížečích široce dostupné od listopadu 2015; novější funkce vyžadují samostatné ověření kompatibility. Příklad se týká běžné šablony, nikoli deklarativního Shadow DOM: při parsování může vhodná deklarace používající shadowrootmode vytvořit ShadowRoot místo HTMLTemplateElement.
Příklady
(() => {
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();
})();Výsledek
before: 0 rendered: Hello, template! template: Hello fragment children: 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.