База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

shadowrootcustomelementregistry — отложено присвояване на регистър

Булев атрибут на template, който оставя декларативен shadow корен без регистър на персонализирани елементи. Позволява регистърът да бъде присвоен по-късно чрез initialize(), вместо автоматично да се използва регистърът на документа.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

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

shadowrootcustomelementregistry е булев атрибут на template, използван с декларативен Shadow DOM. Той не създава самостоятелно shadow корен: необходим е и валиден shadowrootmode, например open. Важното е наличието на атрибута; стойността "false" не го изключва и не е валиден запис на булев HTML атрибут.

Когато парсерът създаде този корен, наличието на атрибута задава регистъра му като null и запазва това състояние до изрична инициализация. Без атрибута парсерът използва регистъра на документа на хоста. Атрибутът нито създава нов CustomElementRegistry, нито избира регистър по име, нито регистрира дефиниции на елементи.

Скрипт може да създаде регистър с new CustomElementRegistry(), да добави дефиниция с define() и да извика registry.initialize(root). Този метод присвоява регистъра на корена и на елементите потомци, чиито регистри са null, след което се опитва да надгради елементите според дефинициите. Вече присвоен регистър не може да бъде заменен по този начин.

Съответното свойство HTMLTemplateElement.shadowRootCustomElementRegistry отразява атрибута като DOMString, а не като boolean; стандартът умишлено оставя възможност за разширяване. Примерът изисква реализация на всички използвани механизми — поддръжката само на декларативен Shadow DOM не е достатъчна.

Примери

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

Резултат

before: false
after: true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници