<template>

Un modèle HTML invisible qu’un script copie et insère dans la page.

Affichage
none
Balise fermante
Obligatoire
Contenu autorisé
Tout contenu, conservé mais non affiché
Sur cette page

Exemple

#
HTML
<ul id="courses"></ul>

<template id="course-row">
  <li><strong class="name"></strong> · nombre de leçons : <span class="lessons"></span></li>
</template>

<script>
  const courses = [
    { name: 'HTML à partir de zéro', lessons: 24 },
    { name: 'CSS et Flexbox', lessons: 18 },
    { name: 'JavaScript pour débuter', lessons: 32 }
  ]
  const template = document.getElementById('course-row')
  const list = document.getElementById('courses')

  courses.forEach((course) => {
    const item = template.content.cloneNode(true)
    item.querySelector('.name').textContent = course.name
    item.querySelector('.lessons').textContent = course.lessons
    list.append(item)
  })
</script>
Aperçu

Définition et utilisation

#

L’élément <template> conserve un fragment de HTML qui n’est ni affiché ni exécuté au chargement de la page. Les images d’un modèle ne sont pas téléchargées, les scripts ne s’exécutent pas, et document.querySelector ne trouve pas ses éléments. Le modèle attend que vous l’utilisiez en JavaScript.

Le contenu du modèle est accessible via la propriété content. Vous appelez template.content.cloneNode(true), complétez la copie avec des données et l’insérez dans le document. C’est ainsi que l’on construit des éléments répétitifs : lignes de tableau, cartes de produits, messages de chat.

Le modèle est aussi la base des composants web (Web Components). Avec l’attribut shadowrootmode, le navigateur le transforme immédiatement en Shadow DOM de l’élément dans lequel il se trouve, sans écrire de JavaScript.

Syntaxe

#
Syntaxe
<template id="modele">
  …
</template>

Attributs

#
  • shadowrootmode

    open | closed

    Transforme le modèle en Shadow DOM de l’élément parent dès le chargement de la page (ce qu’on appelle le Shadow DOM déclaratif). open permet aux scripts de regarder à l’intérieur via element.shadowRoot, alors que closed ne le permet pas. Les styles du Shadow DOM ne sortent pas, et les styles de la page n’y entrent pas, comme le montre l’exemple.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

shadowrootmode

open | closed

Transforme le modèle en Shadow DOM de l’élément parent dès le chargement de la page (ce qu’on appelle le Shadow DOM déclaratif). open permet aux scripts de regarder à l’intérieur via element.shadowRoot, alors que closed ne le permet pas. Les styles du Shadow DOM ne sortent pas, et les styles de la page n’y entrent pas, comme le montre l’exemple.

HTML
<style>
  p { color: #f97316; }
</style>
<p>Ce paragraphe est orange, car le style de la page s’y applique.</p>
<div>
  <template shadowrootmode="open">
    <p>Ce paragraphe est dans le Shadow DOM, donc le style de la page ne s’y applique pas.</p>
  </template>
</div>
Aperçu

CSS par défaut

#

La plupart des navigateurs affichent cet élément avec ces styles par défaut :

CSS
template {
  display: none;
}

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Quand vous complétez la copie du modèle avec des données, utilisez textContent plutôt que innerHTML. Vous vous protégez ainsi de l’injection de code étranger.
  • N’oubliez pas l’argument de cloneNode(true). Sans true, vous ne copiez que le fragment vide, sans les éléments qu’il contient.
  • Vous pouvez placer un modèle n’importe où dans le document, y compris dans <head> ou à l’intérieur d’un tableau. Il ne perturbera pas la mise en page, car il n’est pas affiché.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.