Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

shadowrootcustomelementregistry — odložené přiřazení registru

Booleovský atribut elementu template, který ponechá deklarativní kořen shadow bez registru vlastních prvků. Umožňuje přiřadit registr později pomocí initialize(), místo automatického použití registru dokumentu.

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

Syntaxe

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

shadowrootcustomelementregistry je booleovský atribut elementu template, který se používá s deklarativním Shadow DOM. Sám o sobě kořen shadow nevytváří: je potřeba také platný shadowrootmode, například open. Rozhodující je přítomnost atributu; hodnota "false" jeho účinek nevypne a není platným zápisem booleovského atributu HTML.

Když parser vytvoří tento kořen, přítomnost atributu nastaví jeho registr na null a tento stav zachová až do výslovné inicializace. Bez atributu parser použije registr dokumentu hostitele. Atribut nevytváří nový CustomElementRegistry, nevybírá registr podle názvu ani neregistruje definice prvků.

Skript může vytvořit registr pomocí new CustomElementRegistry(), přidat definici pomocí define() a zavolat registry.initialize(root). Tato metoda přiřadí registr kořenu a potomkům, jejichž registr má hodnotu null, a poté se pokusí prvky upgradovat podle definic. Již přiřazený registr tímto způsobem nahradit nelze.

Odpovídající vlastnost HTMLTemplateElement.shadowRootCustomElementRegistry odráží atribut jako DOMString, nikoli jako boolean; standard záměrně ponechává prostor pro rozšíření. Příklad vyžaduje implementaci všech použitých mechanismů — samotná podpora deklarativního Shadow DOM nestačí.

Příklady

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

Výsledek

before: false
after: true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje