Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

HTMLTemplateElement: neaktívny obsah šablóny

HTMLTemplateElement ukladá obsah šablóny v samostatnom DocumentFragment, ktorý je dostupný cez content. Obsah sa v šablóne nevykresľuje; možno ho skopírovať pomocou document.importNode() a vložiť do dokumentu bez spotrebovania originálu.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const template = document.createElement("template");
template.content.append(document.createElement("p"));
const fragment = document.importNode(template.content, true);
document.body.append(fragment);

Neaktívny obsah šablóny označuje obsah bežného prvku template, ktorý sa uchováva na neskoršie použitie namiesto vykreslenia na mieste deklarácie. Rozhranie HTMLTemplateElement sprístupňuje tento obsah cez content ako DocumentFragment. Ide o rozhranie DOM prehliadača, nie o funkciu ECMAScriptu; samotná prítomnosť Node.js 24 nedokazuje jeho dostupnosť.

Uzly šablóny vyhľadávajte pomocou template.content.querySelector(), nie pomocou template.querySelector(). Naparsovaný obsah patrí do fragmentu, nie medzi bežných potomkov prvku. Vlastnosť content je iba na čítanie, ale samotný fragment možno meniť. Táto neaktivita nie je to isté ako globálny atribút inert, ktorý obmedzuje interakciu s existujúcimi prvkami.

Pomocou document.importNode(template.content, true) skopírujte celý podstrom v kontexte cieľového dokumentu. Je to dôležité pri vytváraní vlastných prvkov, pretože obsah šablóny patrí do samostatného dokumentu. Vložením fragmentu sa jeho potomkovia presunú do cieľa a fragment sa vyprázdni. Priamym vložením template.content by sa teda obsah šablóny spotreboval namiesto toho, aby sa zachoval na opakované použitie.

Základné rozhranie a content sú v prehliadačoch široko dostupné od novembra 2015; novšie funkcie si vyžadujú samostatné kontroly kompatibility. Príklad sa týka bežnej šablóny, nie deklaratívneho Shadow DOM: pri parsovaní môže vhodná deklarácia používajúca shadowrootmode vytvoriť ShadowRoot namiesto HTMLTemplateElement.

Prí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ýsledok

before: 0
rendered: Hello, template!
template: Hello
fragment children: 0

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje