Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

shadowrootcustomelementregistry — odložené priradenie registra

Booleovský atribút elementu template, ktorý ponechá deklaratívny koreň shadow bez registra vlastných prvkov. Umožňuje priradiť register neskôr pomocou initialize(), namiesto automatického použitia registra dokumentu.

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

Syntax

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

shadowrootcustomelementregistry je booleovský atribút elementu template, ktorý sa používa s deklaratívnym Shadow DOM. Sám osebe nevytvára koreň shadow: potrebný je aj platný shadowrootmode, napríklad open. Rozhodujúca je prítomnosť atribútu; hodnota "false" jeho účinok nevypne a nie je platným zápisom booleovského atribútu HTML.

Keď parser vytvorí tento koreň, prítomnosť atribútu nastaví jeho register na null a zachová tento stav až do výslovnej inicializácie. Bez atribútu parser použije register dokumentu hostiteľa. Atribút nevytvára nový CustomElementRegistry, nevyberá register podľa názvu ani neregistruje definície prvkov.

Skript môže vytvoriť register pomocou new CustomElementRegistry(), pridať definíciu pomocou define() a zavolať registry.initialize(root). Táto metóda priradí register koreňu a potomkom, ktorých register má hodnotu null, a potom sa pokúsi aktualizovať prvky podľa definícií. Už priradený register sa takto nedá nahradiť.

Zodpovedajúca vlastnosť HTMLTemplateElement.shadowRootCustomElementRegistry odráža atribút ako DOMString, nie ako boolean; štandard zámerne ponecháva priestor na rozšírenie. Príklad vyžaduje implementáciu všetkých použitých mechanizmov — samotná podpora deklaratívneho Shadow DOM nestačí.

Prí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ýsledok

before: false
after: true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje