CKTIS / HTML
shadowrootcustomelementregistry — odložena dodelitev registra
Logični atribut elementa template, ki deklarativni koren shadow pusti brez registra elementov po meri. Omogoča poznejšo dodelitev registra z initialize(), namesto samodejne uporabe registra dokumenta.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<template shadowrootmode="open" shadowrootcustomelementregistry>…</template>shadowrootcustomelementregistry je logični atribut elementa template, ki se uporablja z deklarativnim Shadow DOM. Sam ne ustvari korena shadow: potreben je tudi veljaven shadowrootmode, na primer open. Pomembna je prisotnost atributa; vrednost "false" ga ne izklopi in ni veljaven zapis logičnega atributa HTML.
Ko razčlenjevalnik ustvari ta koren, prisotnost atributa nastavi njegov register na null in ohrani to stanje do izrecne inicializacije. Brez atributa razčlenjevalnik uporabi register dokumenta gostitelja. Atribut ne ustvari novega CustomElementRegistry, ne izbere registra po imenu in ne registrira definicij elementov.
Skript lahko ustvari register z new CustomElementRegistry(), doda definicijo z define() in pokliče registry.initialize(root). Ta metoda dodeli register korenu in potomcem, katerih register je null, nato pa poskusi nadgraditi elemente glede na definicije. Že dodeljenega registra na ta način ni mogoče zamenjati.
Ustrezna lastnost HTMLTemplateElement.shadowRootCustomElementRegistry odraža atribut kot DOMString, ne kot boolean; standard namenoma pušča prostor za razširitve. Primer zahteva implementacijo vseh uporabljenih mehanizmov — podpora samo za deklarativni Shadow DOM ne zadostuje.
Primeri
<!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>Rezultat
before: false after: true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.