CKTIS / HTML
shadowrootmode — DOM fantôme déclaratif
L’attribut shadowrootmode de l’élément template permet au parseur HTML de créer une racine fantôme déclarative. Ses valeurs open et closed déterminent le mode d’accès à cette racine.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<template shadowrootmode="open|closed">…</template>shadowrootmode est un attribut à valeurs énumérées de template, et non un attribut booléen. Il accepte open ou closed. L’absence de l’attribut, une valeur vide et une valeur invalide correspondent toutes à l’état None : à lui seul, l’attribut ne déclenche alors pas la création d’une racine fantôme.
Lors de l’analyse d’un document HTML, une déclaration valide crée une racine fantôme sur l’élément parent si celui-ci peut accueillir un DOM fantôme. Le contenu de la déclaration est placé dans la racine fantôme, tandis que le template lui-même ne devient pas un enfant DOM de l’hôte. Si l’hôte possède déjà une racine fantôme ou si l’ajout d’une racine est interdit, le parseur laisse un template ordinaire.
Le mode open permet de récupérer la racine via host.shadowRoot ; pour closed, cette propriété renvoie null. Les deux modes créent un DOM fantôme : closed ne signifie pas que le contenu ne sera pas affiché.
Il s’agit d’un mécanisme du parseur, et non d’un commutateur rétroactif : ajouter shadowrootmode à un template existant ne crée pas de racine fantôme. Affecter le balisage à innerHTML n’active pas non plus le DOM fantôme déclaratif. Ouvrez l’exemple comme un document HTML plutôt que de l’insérer via innerHTML.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Declarative shadow DOM</title>
<div id="host"><template shadowrootmode="open"><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
const host = document.getElementById('host');
document.getElementById('result').textContent = [
host.shadowRoot.mode,
host.shadowRoot.querySelector('span').textContent,
String(host.querySelector('template'))
].join('\n');
</script>
</html>Résultat
open Hello null
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.