Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori