Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła