Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources