CKTIS / HTML
shadowrootcustomelementregistry — odgođena dodjela registra
Booleov atribut elementa template koji deklarativni korijen shadow ostavlja bez registra prilagođenih elemenata. Omogućuje naknadnu dodjelu registra putem initialize(), umjesto automatske upotrebe registra dokumenta.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<template shadowrootmode="open" shadowrootcustomelementregistry>…</template>shadowrootcustomelementregistry je booleov atribut elementa template, koji se upotrebljava s deklarativnim Shadow DOM-om. Sam po sebi ne stvara korijen shadow: potreban je i valjan shadowrootmode, primjerice open. Važna je prisutnost atributa; vrijednost "false" ne isključuje njegovo djelovanje i nije valjan zapis booleova HTML atributa.
Kada parser stvori taj korijen, prisutnost atributa postavlja njegov registar na null i čuva to stanje do izričite inicijalizacije. Bez atributa parser upotrebljava registar dokumenta domaćina. Atribut ne stvara novi CustomElementRegistry, ne odabire registar prema nazivu i ne registrira definicije elemenata.
Skripta može stvoriti registar pomoću new CustomElementRegistry(), dodati definiciju pomoću define() i pozvati registry.initialize(root). Ta metoda dodjeljuje registar korijenu i potomcima čiji je registar null, a zatim pokušava nadograditi elemente prema definicijama. Registar koji je već dodijeljen ne može se zamijeniti na ovaj način.
Odgovarajuće svojstvo HTMLTemplateElement.shadowRootCustomElementRegistry odražava atribut kao DOMString, a ne kao boolean; standard namjerno ostavlja mogućnost proširenja. Primjer zahtijeva implementaciju svih mehanizama koje upotrebljava — sama podrška za deklarativni Shadow DOM nije dovoljna.
Primjeri
<!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>Rezultat
before: false after: true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.