CKTIS / HTML
template — un modèle de fragment HTML
L’élément `template` contient un fragment HTML inerte qu’un script peut copier et insérer dans le document. Son contenu est accessible via `content`, et non comme des enfants ordinaires de l’élément.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<template id="item-template"><li></li></template>L’élément template déclare un fragment HTML destiné à être utilisé ultérieurement. Un modèle ordinaire n’affiche pas son contenu : celui-ci reste inerte, si bien que les scripts qu’il contient ne s’exécutent pas tant qu’il y est stocké. Les balises ouvrante et fermante sont toutes deux nécessaires.
La propriété content de HTMLTemplateElement expose un DocumentFragment. Les éléments écrits entre les balises appartiennent à ce fragment, et non aux enfants ordinaires de template. Recherchez-les avec template.content.querySelector(...) ; ajouter directement des enfants à template enfreint son modèle de contenu.
Utilisez template.content.cloneNode(true) pour copier la structure en profondeur. Renseignez la copie puis insérez-la dans le document. L’insertion d’un fragment déplace ses enfants, laissant le fragment lui-même vide. Insérer le content d’origine au lieu d’une copie viderait le modèle.
Le DOM fantôme déclaratif constitue un usage distinct : shadowrootmode peut amener l’analyseur à créer une racine fantôme plutôt qu’un modèle ordinaire. L’exemple ci-dessous n’utilise pas cet attribut.
Exemples
<!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>Résultat
• Ada • Lin
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.