Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje