CKTIS / JavaScript
HTMLTemplateElement.content : le fragment inerte du modèle
`template.content` donne accès au contenu inerte d’un modèle sous forme de `DocumentFragment`. Pour réutiliser le modèle, copiez son sous-arbre dans le document cible, puis insérez la copie.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
template.contentcontent est une propriété d’instance en lecture seule de HTMLTemplateElement : elle renvoie toujours le même DocumentFragment, dont on peut lire et modifier les nœuds. Le balisage à l’intérieur d’un élément template ordinaire est analysé dans ce fragment : les nœuds obtenus ne sont pas des enfants de l’élément lui-même. Pour chercher dans le contenu, utilisez template.content.querySelector(...), et non template.querySelector(...).
Dans un document HTML ordinaire, la propriété ownerDocument du fragment désigne un document distinct sans contexte de navigation. Si le modèle appartient déjà à un document créé pour stocker les contenus de modèles, le fragment réutilise ce document. Rattacher le modèle à la page n’affiche pas son contenu et n’exécute pas les scripts encore dans le fragment. Le caractère inerte ne remplace pas le nettoyage du HTML : du HTML non fiable peut rester dangereux une fois inséré. Utilisez textContent pour du texte brut.
Pour garder le modèle réutilisable, appelez document.importNode(template.content, true) sur le document cible, puis insérez la copie. true copie aussi les descendants ; omettre cet argument ou passer false donne une copie vide du fragment. Contrairement à cloneNode(true), l’importation utilise le contexte du document cible, ce qui compte pour le registre des éléments personnalisés. Insérer un fragment déplace ses enfants, pas le fragment lui-même, qui reste vide. Si vous insérez l’original, vous videz le modèle.
Il s’agit d’une API du DOM HTML, et non d’une fonctionnalité d’ECMAScript 2024. La prise en charge de JavaScript ne garantit pas à elle seule la disponibilité de cette API.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Template content example</title>
</head>
<body>
<script>
(() => {
const template = document.createElement('template');
const paragraph = document.createElement('p');
paragraph.textContent = 'Hello';
const original = template.content;
original.appendChild(paragraph);
const host = document.createElement('div');
host.appendChild(template);
document.body.appendChild(host);
const copy = document.importNode(original, true);
const inserted = copy.firstElementChild;
host.appendChild(copy);
console.log(`template children: ${template.childNodes.length}`);
console.log(`original children: ${original.childNodes.length}`);
console.log(`inserted: ${inserted.isConnected}, ${inserted.textContent}`);
console.log(`copy children: ${copy.childNodes.length}`);
host.remove();
})();
</script>
</body>
</html>Résultat
template children: 0 original children: 1 inserted: true, Hello copy children: 0
Ouvrez le fichier HTML dans un navigateur et consultez la console des outils de développement. Le modèle n’a pas d’enfants directs, le fragment d’origine conserve son paragraphe, la copie insérée du paragraphe est rattachée au document et le fragment copié est vide.
Leçons associées
- JavaScript · Leçon 16 · Avancé · Version : 4