CKTIS / HTML
shadowrootcustomelementregistry — assegnazione differita del registro
Attributo booleano di template che lascia una radice shadow dichiarativa senza un registro di elementi personalizzati. Consente di assegnare un registro in seguito tramite initialize(), invece di usare automaticamente quello del documento.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<template shadowrootmode="open" shadowrootcustomelementregistry>…</template>shadowrootcustomelementregistry è un attributo booleano di template, usato con Shadow DOM dichiarativo. Non crea da solo una radice shadow: serve anche un shadowrootmode valido, per esempio open. Conta la presenza dell’attributo; assegnargli il valore "false" non lo disattiva e non è una sintassi valida per un attributo booleano HTML.
Quando il parser crea questa radice, la presenza dell’attributo imposta il suo registro a null e mantiene questo stato fino all’inizializzazione esplicita. Senza l’attributo, il parser usa il registro del documento dell’host. L’attributo non crea un nuovo CustomElementRegistry, non seleziona un registro tramite nome e non registra definizioni di elementi.
Uno script può creare un registro con new CustomElementRegistry(), aggiungere una definizione con define() e chiamare registry.initialize(root). Questo metodo assegna il registro alla radice e agli elementi discendenti il cui registro è null, poi prova ad aggiornare gli elementi in base alle definizioni. Un registro già assegnato non può essere sostituito in questo modo.
La proprietà corrispondente HTMLTemplateElement.shadowRootCustomElementRegistry riflette l’attributo come DOMString, non come boolean; lo standard lascia intenzionalmente spazio a estensioni. L’esempio richiede l’implementazione di tutti i meccanismi che usa: il solo supporto per Shadow DOM dichiarativo non è sufficiente.
Esempi
<!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>Risultato
before: false after: true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.