CKTIS / JavaScript
HTMLTemplateElement: nieaktywna zawartość szablonu
HTMLTemplateElement przechowuje zawartość szablonu w osobnym DocumentFragment dostępnym przez content. Zawartość nie jest renderowana w szablonie; można ją skopiować przez document.importNode() i wstawić do dokumentu bez zużywania oryginału.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const template = document.createElement("template");
template.content.append(document.createElement("p"));
const fragment = document.importNode(template.content, true);
document.body.append(fragment);Template inert content oznacza zawartość zwykłego elementu template, przechowywaną do późniejszego użycia zamiast renderowaną w miejscu deklaracji. Interfejs HTMLTemplateElement udostępnia ją przez content jako DocumentFragment. To API przeglądarkowego DOM, a nie funkcja ECMAScript; sama obecność Node.js 24 nie potwierdza jego dostępności.
Węzły szablonu należy wyszukiwać przez template.content.querySelector(), nie przez template.querySelector(). Parsowana zawartość trafia do fragmentu, a nie do zwykłych dzieci elementu. Właściwość content jest tylko do odczytu, ale sam fragment można modyfikować. Ta nieaktywność nie jest tym samym co globalny atrybut inert, który ogranicza interakcje z istniejącymi elementami.
Użyj document.importNode(template.content, true), aby skopiować całe poddrzewo w kontekście dokumentu docelowego. Ma to znaczenie dla tworzenia elementów niestandardowych, ponieważ zawartość szablonu należy do osobnego dokumentu. Wstawienie fragmentu przenosi jego dzieci do celu i opróżnia fragment. Wstawienie bezpośrednio template.content zużyłoby więc zawartość szablonu zamiast zachować ją do ponownego użycia.
Podstawowy interfejs i content są szeroko dostępne w przeglądarkach od listopada 2015 roku; nowsze funkcje wymagają osobnego sprawdzenia zgodności. Przykład dotyczy zwykłego szablonu, nie deklaratywnego Shadow DOM: podczas parsowania odpowiednia deklaracja z shadowrootmode może utworzyć ShadowRoot zamiast HTMLTemplateElement.
Przykłady
(() => {
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();
})();Wynik
before: 0 rendered: Hello, template! template: Hello fragment children: 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.