Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

template — un modello di frammento HTML

L’elemento `template` contiene un frammento HTML inerte che uno script può copiare e inserire nel documento. Il suo contenuto è accessibile tramite `content`, non come normali figli dell’elemento.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<template id="item-template"><li></li></template>

L’elemento template dichiara un frammento HTML da usare in seguito. Un template ordinario non mostra il proprio contenuto: questo rimane inerte, quindi gli script al suo interno non vengono eseguiti mentre vi è memorizzato. Sono necessari sia il tag di apertura sia quello di chiusura.

La proprietà content di HTMLTemplateElement espone un DocumentFragment. Gli elementi scritti tra i tag appartengono a quel frammento, non ai normali figli di template. Cercali con template.content.querySelector(...); aggiungere figli direttamente a template viola il suo modello di contenuto.

Usa template.content.cloneNode(true) per copiare la struttura in profondità. Completa la copia e inseriscila nel documento. L’inserimento di un frammento sposta i suoi figli, lasciando vuoto il frammento stesso. Inserire il content originale invece di una copia svuoterebbe il template.

Il DOM shadow dichiarativo è un uso distinto: shadowrootmode può far sì che il parser crei una shadow root invece di un template ordinario. L’esempio seguente non usa questo attributo.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Template example</title>
</head>
<body>
  <template id="item-template"><li></li></template>
  <ul id="items"></ul>
  <script>
    const template = document.getElementById('item-template');
    const items = document.getElementById('items');

    for (const name of ['Ada', 'Lin']) {
      const fragment = template.content.cloneNode(true);
      fragment.querySelector('li').textContent = name;
      items.appendChild(fragment);
    }
  </script>
</body>
</html>

Risultato

• Ada
• Lin

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti