CKTIS / HTML
shadowrootcustomelementregistry — asignación diferida del registro
Atributo booleano de template que deja una raíz shadow declarativa sin un registro de elementos personalizados. Permite asignar un registro más adelante mediante initialize(), en vez de usar automáticamente el registro del documento.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<template shadowrootmode="open" shadowrootcustomelementregistry>…</template>shadowrootcustomelementregistry es un atributo booleano de template que se usa con Shadow DOM declarativo. No crea por sí solo una raíz shadow: también se necesita un shadowrootmode válido, como open. Lo que importa es la presencia del atributo; asignarle el valor "false" no lo desactiva y no es una sintaxis válida para un atributo booleano de HTML.
Cuando el analizador crea esta raíz, la presencia del atributo establece su registro en null y mantiene ese estado hasta que se inicializa explícitamente. Sin el atributo, el analizador usa el registro del documento del host. El atributo no crea un nuevo CustomElementRegistry, no selecciona un registro por nombre ni registra definiciones de elementos.
Un script puede crear un registro con new CustomElementRegistry(), añadir una definición con define() y llamar a registry.initialize(root). Este método asigna el registro a la raíz y a los elementos descendientes cuyos registros sean null; después, intenta actualizar los elementos según las definiciones. Un registro ya asignado no se puede sustituir de esta manera.
La propiedad correspondiente HTMLTemplateElement.shadowRootCustomElementRegistry refleja el atributo como DOMString, no como boolean; el estándar deja deliberadamente margen para ampliaciones. El ejemplo requiere que se implementen todos los mecanismos que utiliza: la compatibilidad únicamente con Shadow DOM declarativo no basta.
Ejemplos
<!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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.