WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

shadowrootcustomelementregistry — verzögerte Registry-Zuweisung

Ein boolesches Attribut von template, das eine deklarative Shadow Root zunächst ohne Custom-Element-Registry belässt. So kann später über initialize() eine Registry zugewiesen werden, anstatt automatisch die Registry des Dokuments zu verwenden.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<template shadowrootmode="open" shadowrootcustomelementregistry>…</template>

shadowrootcustomelementregistry ist ein boolesches Attribut von template, das mit deklarativem Shadow DOM verwendet wird. Es erstellt nicht selbst eine Shadow Root: Zusätzlich ist ein gültiger Wert für shadowrootmode, etwa open, erforderlich. Entscheidend ist, ob das Attribut vorhanden ist; der Wert "false" deaktiviert es nicht und ist keine gültige Schreibweise für ein boolesches HTML-Attribut.

Wenn der Parser diese Root erstellt, setzt das Vorhandensein des Attributs ihre Registry auf null und erhält diesen Zustand bis zur ausdrücklichen Initialisierung. Ohne das Attribut verwendet der Parser die Dokument-Registry des Hosts. Das Attribut erstellt weder eine neue CustomElementRegistry, noch wählt es eine Registry anhand eines Namens aus oder registriert Elementdefinitionen.

Ein Skript kann mit new CustomElementRegistry() eine Registry erstellen, mit define() eine Definition hinzufügen und registry.initialize(root) aufrufen. Diese Methode weist die Registry der Root und den Nachfahrenelementen zu, deren Registry null ist, und versucht anschließend, Elemente anhand der Definitionen zu aktualisieren. Eine bereits zugewiesene Registry kann auf diese Weise nicht ersetzt werden.

Die zugehörige Eigenschaft HTMLTemplateElement.shadowRootCustomElementRegistry bildet das Attribut als DOMString und nicht als boolean ab; der Standard lässt bewusst Raum für Erweiterungen. Das Beispiel setzt Implementierungen aller verwendeten Mechanismen voraus — Unterstützung für deklaratives Shadow DOM allein reicht nicht aus.

Beispiele

<!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>

Ergebnis

before: false
after: true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen