CKTIS / HTML
shadowrootcustomelementregistry — odroczone przypisanie rejestru
Atrybut logiczny elementu template, który pozostawia deklaratywny korzeń cienia bez rejestru elementów niestandardowych. Pozwala później przypisać rejestr przez initialize(), zamiast automatycznie korzystać z rejestru dokumentu.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<template shadowrootmode="open" shadowrootcustomelementregistry>…</template>shadowrootcustomelementregistry jest atrybutem logicznym elementu template, używanym z deklaratywnym shadow DOM. Nie tworzy korzenia cienia samodzielnie: potrzebny jest również poprawny shadowrootmode, np. open. Liczy się obecność atrybutu; zapis z wartością "false" nie wyłącza jego działania i nie jest poprawnym zapisem wartości logicznej HTML.
Gdy parser tworzy taki korzeń, obecność atrybutu ustawia jego rejestr na null i zachowuje ten stan do jawnej inicjalizacji. Bez atrybutu parser używa rejestru dokumentu hosta. Atrybut nie tworzy nowego CustomElementRegistry, nie wskazuje rejestru przez nazwę i nie rejestruje definicji elementów.
Skrypt może utworzyć rejestr przez new CustomElementRegistry(), dodać definicję przez define() i wywołać registry.initialize(root). Metoda przypisuje rejestr korzeniowi i jego elementom potomnym mającym rejestr null, po czym próbuje przekształcić elementy zgodnie z definicjami. Już przypisanego rejestru nie można w ten sposób zastąpić.
Powiązana właściwość HTMLTemplateElement.shadowRootCustomElementRegistry odzwierciedla atrybut jako DOMString, a nie boolean; standard celowo pozostawia możliwość rozszerzenia. Przykład wymaga implementacji wszystkich użytych mechanizmów — sama obsługa deklaratywnego shadow DOM nie wystarcza.
Przykłady
<!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>Wynik
before: false after: true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.