Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLTemplateElement.content: il frammento inerte del template

`template.content` espone il contenuto inerte di un template come `DocumentFragment`. Per riutilizzare il template, copia il suo sottoalbero nel documento di destinazione e inserisci la copia.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

template.content

content è una proprietà di istanza di sola lettura di HTMLTemplateElement: restituisce sempre lo stesso DocumentFragment, di cui puoi leggere e modificare i nodi. Il markup all’interno di un normale elemento template viene analizzato e inserito in quel frammento, non come figli dell’elemento stesso. Per cercare nodi nel contenuto, usa template.content.querySelector(...), non template.querySelector(...).

In un normale documento HTML, ownerDocument del frammento è un documento separato senza contesto di navigazione. Se il template appartiene già a un documento creato per ospitare il contenuto dei template, il frammento riutilizza quel documento. Collegare il template alla pagina non mostra il contenuto e non esegue gli script che si trovano ancora nel frammento. Il fatto che il contenuto sia inerte non sostituisce la sanitizzazione: HTML non attendibile può restare pericoloso quando viene inserito. Usa textContent per il testo semplice.

Per poter riutilizzare il template, chiama document.importNode(template.content, true) sul documento di destinazione e inserisci la copia. true copia anche i discendenti; se ometti l’argomento o passi false, ottieni una copia vuota del frammento. A differenza di cloneNode(true), l’importazione usa il contesto del documento di destinazione, rilevante per il registro degli elementi personalizzati. Inserire un frammento ne sposta i figli, non il frammento stesso, che rimane vuoto. Se inserisci l’originale, svuoti il template.

Questa è un’API del DOM HTML, non fa parte di ECMAScript 2024. Il solo supporto di JavaScript non garantisce che l’API sia disponibile.

Esempi

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

Risultato

template children: 0
original children: 1
inserted: true, Hello
copy children: 0

Apri il file HTML in un browser e controlla la console degli strumenti di sviluppo. Il template non ha figli diretti, il frammento originale conserva il paragrafo, la copia inserita del paragrafo è collegata al documento e il frammento copiato è vuoto.

Lezioni correlate

  • JavaScript · Lezione 16 · Avanzato · Versione: 4

Fonti