CKTIS / JavaScript
HTMLTemplateElement: neaktivna vsebina predloge
HTMLTemplateElement shranjuje vsebino predloge v ločenem DocumentFragment, dostopnem prek content. Vsebina se znotraj predloge ne izriše; kopirate jo lahko z document.importNode() in vstavite v dokument, ne da bi porabili izvirnik.
Različica: 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);Neaktivna vsebina predloge pomeni vsebino običajnega elementa template, ki je shranjena za poznejšo uporabo, namesto da bi se izrisala na mestu deklaracije. Vmesnik HTMLTemplateElement to vsebino prek content izpostavi kot DocumentFragment. To je API DOM brskalnika, ne funkcija ECMAScripta; že sama prisotnost Node.js 24 ne dokazuje njegove razpoložljivosti.
Vozlišča predloge iščite z template.content.querySelector(), ne z template.querySelector(). Razčlenjena vsebina pripada fragmentu, ne običajnim otrokom elementa. Lastnost content je samo za branje, sam fragment pa je mogoče spreminjati. Ta neaktivnost ni isto kot globalni atribut inert, ki omejuje interakcijo z obstoječimi elementi.
Uporabite document.importNode(template.content, true), da kopirate celotno poddrevo v kontekstu ciljnega dokumenta. To je pomembno pri ustvarjanju komponent po meri, saj vsebina predloge pripada ločenemu dokumentu. Ob vstavitvi fragmenta se njegovi otroci premaknejo na cilj, fragment pa se izprazni. Če bi neposredno vstavili template.content, bi tako porabili vsebino predloge, namesto da bi jo ohranili za ponovno uporabo.
Osnovni vmesnik in content sta v brskalnikih široko podprta od novembra 2015; novejše funkcije zahtevajo ločeno preverjanje združljivosti. Primer obravnava običajno predlogo, ne deklarativnega Shadow DOM: med razčlenjevanjem lahko ustrezna deklaracija z uporabo shadowrootmode ustvari ShadowRoot namesto HTMLTemplateElement.
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.