CKTIS / HTML
shadowrootcustomelementregistry — attribution différée du registre
Attribut booléen de template qui laisse une racine shadow déclarative sans registre d’éléments personnalisés. Il permet d’attribuer un registre ultérieurement avec initialize(), au lieu d’utiliser automatiquement celui du document.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<template shadowrootmode="open" shadowrootcustomelementregistry>…</template>shadowrootcustomelementregistry est un attribut booléen de template, utilisé avec le Shadow DOM déclaratif. Il ne crée pas à lui seul une racine shadow : un shadowrootmode valide, par exemple open, est également nécessaire. C’est la présence de l’attribut qui compte ; lui donner la valeur "false" ne le désactive pas et ne correspond pas à la syntaxe valide d’un attribut booléen HTML.
Lorsque le parseur crée cette racine, la présence de l’attribut définit son registre à null et maintient cet état jusqu’à une initialisation explicite. Sans l’attribut, le parseur utilise le registre du document de l’hôte. L’attribut ne crée pas de nouveau CustomElementRegistry, ne sélectionne pas un registre par son nom et n’enregistre pas de définitions d’éléments.
Un script peut créer un registre avec new CustomElementRegistry(), ajouter une définition avec define() et appeler registry.initialize(root). Cette méthode attribue le registre à la racine et aux éléments descendants dont le registre vaut null, puis tente de mettre à niveau les éléments à l’aide des définitions. Un registre déjà attribué ne peut pas être remplacé de cette manière.
La propriété correspondante HTMLTemplateElement.shadowRootCustomElementRegistry reflète l’attribut sous la forme d’un DOMString, et non d’un boolean ; la norme laisse délibérément une possibilité d’extension. L’exemple nécessite une implémentation de tous les mécanismes utilisés : la prise en charge du seul Shadow DOM déclaratif ne suffit pas.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Deferred custom element registry</title>
<div id="host">
<template shadowrootmode="open" shadowrootcustomelementregistry>
<demo-item></demo-item>
</template>
</div>
<pre id="result"></pre>
<script>
const root = document.getElementById('host').shadowRoot;
const item = root.querySelector('demo-item');
class DemoItem extends HTMLElement {}
const registry = new CustomElementRegistry();
registry.define('demo-item', DemoItem);
const before = item instanceof DemoItem;
registry.initialize(root);
const after = item instanceof DemoItem;
document.getElementById('result').textContent =
`before: ${before}\nafter: ${after}`;
</script>
</html>Résultat
before: false after: 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.