Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

HTMLTemplateElement: neaktivni sadržaj predloška

HTMLTemplateElement pohranjuje sadržaj predloška u zasebnom DocumentFragmentu dostupnom putem content. Sadržaj se ne prikazuje unutar predloška; može se kopirati pomoću document.importNode() i umetnuti u dokument bez potrošnje izvornika.

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

Sintaksa

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

Neaktivni sadržaj predloška označava sadržaj običnog elementa template, koji se čuva za kasniju upotrebu umjesto da se prikazuje na mjestu deklaracije. Sučelje HTMLTemplateElement izlaže taj sadržaj putem content kao DocumentFragment. To je API DOM-a preglednika, a ne značajka ECMAScripta; sama prisutnost Node.js 24 ne potvrđuje njegovu dostupnost.

Čvorove predloška tražite pomoću template.content.querySelector(), a ne pomoću template.querySelector(). Parsirani sadržaj pripada fragmentu, a ne uobičajenoj djeci elementa. Svojstvo content samo je za čitanje, ali sam fragment može se mijenjati. Ta neaktivnost nije isto što i globalni atribut inert, koji ograničava interakciju s postojećim elementima.

Upotrijebite document.importNode(template.content, true) da biste kopirali cijelo podstablo u kontekstu ciljnog dokumenta. To je važno pri izradi prilagođenih elemenata jer sadržaj predloška pripada zasebnom dokumentu. Umetanjem fragmenta njegova se djeca premještaju na odredište, a fragment se prazni. Izravnim umetanjem template.content sadržaj predloška tako bi se potrošio umjesto da se sačuva za ponovnu upotrebu.

Osnovno sučelje i content široko su dostupni u preglednicima od studenoga 2015.; za novije značajke potrebne su zasebne provjere kompatibilnosti. Primjer se odnosi na običan predložak, a ne na deklarativni Shadow DOM: tijekom parsiranja odgovarajuća deklaracija koja upotrebljava shadowrootmode može stvoriti ShadowRoot umjesto HTMLTemplateElement.

Primjeri

(() => {
  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();
})();

Rezultat

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori