CKTIS / JavaScript
HTMLTemplateElement.content: neaktivni fragment predloška
`template.content` omogućuje pristup neaktivnom sadržaju predloška kao objektu `DocumentFragment`. Za ponovnu upotrebu predloška kopiraj njegovo podstablo u odredišni dokument i umetni kopiju.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
template.contentcontent je svojstvo instance HTMLTemplateElement samo za čitanje: uvijek vraća isti DocumentFragment, čije čvorove možeš čitati i mijenjati. Oznake unutar običnog elementa template raščlanjuju se u čvorove tog fragmenta, a ne u djecu samog elementa. Za traženje čvorova u sadržaju upotrijebi template.content.querySelector(...), a ne template.querySelector(...).
U običnom HTML dokumentu ownerDocument fragmenta upućuje na zaseban dokument bez konteksta pregledavanja. Ako predložak već pripada dokumentu stvorenom za pohranu sadržaja predložaka, fragment koristi taj isti dokument. Ni povezivanje predloška sa stranicom ne prikazuje sadržaj niti pokreće skripte koje su još u fragmentu. Neaktivnost nije zamjena za čišćenje HTML-a: nepouzdani HTML i dalje može biti opasan nakon umetanja. Za običan tekst upotrijebi textContent.
Kako bi predložak ostao spreman za ponovnu upotrebu, pozovi document.importNode(template.content, true) na odredišnom dokumentu pa umetni kopiju. true kopira i potomke; ako izostaviš argument ili proslijediš false, dobivaš praznu kopiju fragmenta. Za razliku od cloneNode(true), uvoz koristi kontekst odredišnog dokumenta, što je važno za registar prilagođenih elemenata. Umetanjem fragmenta premještaš njegovu djecu, a ne sam fragment, koji ostaje prazan. Ako umetneš izvornik, ispraznit ćeš predložak.
To je API za HTML DOM, a ne dio ECMAScripta 2024. Sama podrška za JavaScript ne jamči dostupnost ovog API-ja.
Primjeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Template content example</title>
</head>
<body>
<script>
(() => {
const template = document.createElement('template');
const paragraph = document.createElement('p');
paragraph.textContent = 'Hello';
const original = template.content;
original.appendChild(paragraph);
const host = document.createElement('div');
host.appendChild(template);
document.body.appendChild(host);
const copy = document.importNode(original, true);
const inserted = copy.firstElementChild;
host.appendChild(copy);
console.log(`template children: ${template.childNodes.length}`);
console.log(`original children: ${original.childNodes.length}`);
console.log(`inserted: ${inserted.isConnected}, ${inserted.textContent}`);
console.log(`copy children: ${copy.childNodes.length}`);
host.remove();
})();
</script>
</body>
</html>Rezultat
template children: 0 original children: 1 inserted: true, Hello copy children: 0
Otvori HTML datoteku u pregledniku i provjeri ispis u konzoli razvojnih alata. Predložak nema izravne djece, izvorni fragment zadržava odlomak, umetnuta kopija odlomka povezana je s dokumentom, a kopirani je fragment prazan.
Povezane lekcije
- JavaScript · Lekcija 16 · Napredno · Verzija: 4