CKTIS / HTML
shadowrootserializable — sérialiser une racine shadow déclarative
L’attribut booléen shadowrootserializable marque une racine shadow déclarative pour la sérialisation via getHTML({ serializableShadowRoots: true }). Il ne l’inclut pas automatiquement dans le résultat ordinaire de getHTML() ni dans le innerHTML de l’hôte.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<template shadowrootmode="open" shadowrootserializable>…</template>shadowrootserializable est un attribut booléen de l’élément template. Lorsque l’analyseur crée une racine shadow déclarative à partir de shadowrootmode="open" ou shadowrootmode="closed", la présence de cet attribut active son indicateur de sérialisation. shadowrootserializable seul, sans shadowrootmode valide, ne crée pas de racine shadow. Pour désactiver cette option, omettez l’attribut ; shadowrootserializable="false" compte tout de même comme présent.
L’appel host.getHTML({ serializableShadowRoots: true }) inclut la racine shadow marquée sous forme de balisage déclaratif template, avec son contenu. L’appel ordinaire host.getHTML() et la lecture de host.innerHTML omettent la racine shadow de l’hôte. L’option shadowRoots de getHTML() permet de sélectionner explicitement les racines à sérialiser, indépendamment de leur indicateur de sérialisation.
La sérialisation n’est pas un clonage : shadowrootserializable ne remplace pas shadowrootclonable. Ce n’est pas non plus un mécanisme de protection des données. Une racine marquée en mode closed peut aussi apparaître dans la sérialisation de son hôte. N’y stockez donc pas de secrets en supposant que ce mode empêchera leur exportation.
Chargez l’exemple comme un document HTML afin que l’analyseur crée la racine shadow déclarative. Affecter le même balisage à innerHTML ne la créera pas. Les trois vérifications montrent l’omission par défaut de la racine ainsi que la présence de son attribut et de son contenu lorsque la sérialisation est activée.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>shadowrootserializable</title>
<div id="host"><template shadowrootmode="open" shadowrootserializable><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
const host = document.getElementById('host');
const html = host.getHTML({ serializableShadowRoots: true });
document.getElementById('result').textContent = [
host.getHTML() === '',
html.includes('shadowrootserializable=""'),
html.includes('<span>Hello</span>')
].join('\n');
</script>
</html>Résultat
true true true
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.