<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é
Exemple
#<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>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
#<template id="modele">
…
</template>Attributs
#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).openpermet aux scripts de regarder à l’intérieur viaelement.shadowRoot, alors queclosedne 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 | closedTransforme 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.
<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>CSS par défaut
#La plupart des navigateurs affichent cet élément avec ces styles par défaut :
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
textContentplutôt queinnerHTML. Vous vous protégez ainsi de l’injection de code étranger. - N’oubliez pas l’argument de
cloneNode(true). Sanstrue, 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
#- <slot>Un emplacement dans un composant web où arrive le contenu écrit entre ses balises.
- <script>Intègre du code JavaScript dans la page ou le charge depuis un fichier pour donner du comportement à la page.
- <dialog>Une boîte de dialogue ou fenêtre modale : confirmation, formulaire ou message affiché au-dessus du reste de la page.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.