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.