template – modèle

<template id="row-template">…</template>

Un modèle : du HTML que le navigateur analyse, mais n’affiche ni n’exécute. Les images n’y sont pas chargées, les scripts ne s’y lancent pas. JavaScript trouve le contenu du modèle dans la propriété content, le clone, complète les données et l’insère dans la page – par exemple une ligne de tableau ou une fiche produit pour chaque élément.

  • Affichage par défaut : display: none
  • Balise de fermeture : obligatoire
  • Contenu : quelconque – y compris des éléments qui exigent ailleurs un parent précis (tr, li, option)
  • Où il peut figurer : partout dans head et body, même à l’intérieur d’un tableau ou d’un select
  • Interface DOM : HTMLTemplateElement

Attributs

  • shadowrootmode – open ou closed : le modèle devient directement l’arbre fantôme (Shadow DOM) de son parent. Cela ne fonctionne qu’au chargement de la page, pas via innerHTML. Prise en charge : Chrome 111, Firefox 123, Safari 16.4 (état : octobre 2026).

Exemples

Un modèle d’élément de liste et un script qui en crée les éléments à partir de données :

<ul id="pastries"></ul>
<template id="item">
  <li><strong class="name"></strong> – <span class="price"></span> €</li>
</template>
<script>
  var data = [['Croissant', '1,20'], ['Pain au levain', '4,50']];
  var template = document.getElementById('item');
  data.forEach(function (d) {
    var copy = template.content.cloneNode(true);
    copy.querySelector('.name').textContent = d[0];
    copy.querySelector('.price').textContent = d[1];
    document.getElementById('pastries').appendChild(copy);
  });
</script>

Points d’attention

  • Les éléments du modèle ne sont pas des enfants de template, mais du fragment template.content. template.children est vide et document.querySelector() ne regarde pas dans le modèle.
  • Clonez avec content.cloneNode(true) (ou document.importNode()). Insérer content lui-même vide le modèle – la deuxième fois, il n’y aura plus rien à insérer.
  • Insérez les données avec textContent, pas avec innerHTML. Sinon, un texte venant des visiteurs pourrait introduire son propre HTML dans la page (XSS).

Prise en charge par les navigateurs

Baseline – largement disponible : dans tous les navigateurs courants depuis novembre 2015, considéré comme largement disponible depuis mai 2018. Depuis la version : Chrome 26, Firefox 22, Safari 8. État : octobre 2026 (MDN browser-compat-data).

Voir aussi :
script – script
noscript – contenu sans JavaScript
data-* – données personnalisées (attribut)