CKTIS / HTML
shadowrootcustomelementregistry — atribuição diferida do registo
Atributo booleano de template que deixa uma raiz shadow declarativa sem um registo de elementos personalizados. Permite atribuir um registo mais tarde através de initialize(), em vez de utilizar automaticamente o registo do documento.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<template shadowrootmode="open" shadowrootcustomelementregistry>…</template>shadowrootcustomelementregistry é um atributo booleano de template, utilizado com Shadow DOM declarativo. Não cria, por si só, uma raiz shadow: também é necessário um shadowrootmode válido, como open. O que conta é a presença do atributo; atribuir-lhe o valor "false" não o desativa e não constitui uma sintaxe válida para um atributo booleano HTML.
Quando o analisador cria esta raiz, a presença do atributo define o respetivo registo como null e mantém esse estado até à inicialização explícita. Sem o atributo, o analisador utiliza o registo do documento do anfitrião. O atributo não cria um novo CustomElementRegistry, não seleciona um registo pelo nome nem regista definições de elementos.
Um script pode criar um registo com new CustomElementRegistry(), adicionar uma definição com define() e chamar registry.initialize(root). Este método atribui o registo à raiz e aos elementos descendentes cujos registos sejam null e, em seguida, tenta atualizar os elementos com base nas definições. Um registo já atribuído não pode ser substituído desta forma.
A propriedade correspondente HTMLTemplateElement.shadowRootCustomElementRegistry reflete o atributo como DOMString, e não como boolean; a norma deixa deliberadamente margem para extensões. O exemplo requer implementações de todos os mecanismos utilizados — o suporte apenas para Shadow DOM declarativo não é suficiente.
Exemplos
<!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>Resultado
before: false after: true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.