CKTIS / HTML
shadowrootcustomelementregistry — uitgestelde registrytoewijzing
Een booleaans attribuut van template dat een declaratieve shadow root zonder custom-elementregistry laat. Hiermee kan later via initialize() een registry worden toegewezen, in plaats van automatisch de registry van het document te gebruiken.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<template shadowrootmode="open" shadowrootcustomelementregistry>…</template>shadowrootcustomelementregistry is een booleaans attribuut van template dat met declaratieve Shadow DOM wordt gebruikt. Het maakt zelf geen shadow root aan: ook een geldige shadowrootmode, zoals open, is vereist. Het gaat om de aanwezigheid van het attribuut; de waarde "false" schakelt het niet uit en is geen geldige HTML-syntaxis voor een booleaans attribuut.
Wanneer de parser deze root aanmaakt, stelt de aanwezigheid van het attribuut de registry ervan in op null en blijft die toestand behouden tot expliciete initialisatie. Zonder het attribuut gebruikt de parser de documentregistry van de host. Het attribuut maakt geen nieuwe CustomElementRegistry aan, kiest geen registry op basis van een naam en registreert geen elementdefinities.
Een script kan een registry aanmaken met new CustomElementRegistry(), een definitie toevoegen met define() en registry.initialize(root) aanroepen. Deze methode wijst de registry toe aan de root en afstammelingselementen waarvan de registry null is, en probeert daarna elementen op basis van de definities te upgraden. Een al toegewezen registry kan niet op deze manier worden vervangen.
De overeenkomstige eigenschap HTMLTemplateElement.shadowRootCustomElementRegistry weerspiegelt het attribuut als DOMString, niet als boolean; de standaard laat bewust ruimte voor uitbreiding. Het voorbeeld vereist implementaties van alle gebruikte mechanismen — ondersteuning voor alleen declaratieve Shadow DOM is niet voldoende.
Voorbeelden
<!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>Resultaat
before: false after: true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.