Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła