Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

HTMLTemplateElement.content: neaktivni fragment predloge

`template.content` omogoča dostop do neaktivne vsebine predloge kot objekta `DocumentFragment`. Če želiš predlogo znova uporabiti, kopiraj njeno poddrevo v ciljni dokument in vstavi kopijo.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

template.content

content je lastnost primerka HTMLTemplateElement samo za branje: vedno vrne isti DocumentFragment, katerega vozlišča lahko bereš in spreminjaš. Oznake znotraj navadnega elementa template se razčlenijo v vozlišča tega fragmenta, ne v otroke samega elementa. Za iskanje vozlišč po vsebini uporabi template.content.querySelector(...), ne template.querySelector(...).

V navadnem dokumentu HTML ownerDocument fragmenta kaže na ločen dokument brez konteksta brskanja. Če predloga že pripada dokumentu, ustvarjenemu za shranjevanje vsebine predlog, fragment uporabi isti dokument. Tudi če predlogo priključiš strani, se njena vsebina ne prikaže in skripti, ki so še v fragmentu, se ne izvedejo. Neaktivnost ne nadomesti čiščenja HTML-ja: nezaupanja vreden HTML je lahko ob vstavljanju še vedno nevaren. Za golo besedilo uporabi textContent.

Če želiš predlogo znova uporabiti, na ciljnem dokumentu pokliči document.importNode(template.content, true) in vstavi kopijo. true kopira tudi potomce; če argument izpustiš ali podaš false, dobiš prazno kopijo fragmenta. Za razliko od cloneNode(true) uvoz uporabi kontekst ciljnega dokumenta, kar je pomembno za register elementov po meri. Vstavljanje fragmenta premakne njegove otroke, ne fragmenta samega, in fragment ostane prazen. Če vstaviš izvirnik, izprazniš predlogo.

To je API za HTML DOM, ne del ECMAScripta 2024. Sama podpora za JavaScript še ne zagotavlja, da je API na voljo.

Primeri

<!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

Odpri datoteko HTML v brskalniku in preveri izpis v konzoli orodij za razvijalce. Predloga nima neposrednih otrok, izvirni fragment obdrži odstavek, vstavljena kopija odstavka je povezana z dokumentom, kopirani fragment pa je prazen.

Povezane lekcije

  • JavaScript · Lekcija 16 · Napredna · Različica: 4

Viri