CKTIS / JavaScript
ShadowRoot — la radice di un albero Shadow DOM
ShadowRoot rappresenta la radice di un albero Shadow DOM associato a un elemento host. Consente di accedere alla struttura interna di un componente. Le modalità open e closed differiscono per l’accesso tramite host.shadowRoot, ma nessuna delle due crea un confine di sicurezza.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
const root = host.attachShadow({ mode: "open" });
const sameRoot = host.shadowRoot;
root.append(document.createElement("span"));ShadowRoot è la radice di un albero Shadow DOM, un DocumentFragment specializzato associato a un elemento host. I suoi nodi interni formano un albero separato: host.querySelector() non li cerca, mentre root.querySelector() esegue la ricerca al suo interno. La proprietà root.host identifica l’host.
Crea una radice con host.attachShadow({ mode: "open" }), non con new ShadowRoot(). Il metodo restituisce la radice; con open, anche host.shadowRoot vi consente di accedere. Con closed, questa proprietà restituisce null, ma un riferimento conservato continua a funzionare. closed limita l’accesso tramite quella proprietà, ma non protegge dal codice non attendibile.
Shadow DOM supporta l’incapsulamento dei componenti, ma non è né un documento separato né un isolamento completo degli stili: l’ereditarietà CSS resta importante. Un elemento slot può presentare i figli dell’host senza spostarli nell’albero shadow. Non è necessario registrare un custom element per usare Shadow DOM su un host supportato, come div.
Questa è un’API della piattaforma web, non una funzionalità di una particolare edizione di ECMAScript. La presenza di Node 24 in un repository non dimostra il supporto nei browser. L’esempio richiede un browser con attachShadow e confronta entrambe le modalità senza modificare la pagina.
Esempi
(() => {
const host = document.createElement("div");
const root = host.attachShadow({ mode: "open" });
const label = document.createElement("span");
label.textContent = "Hello";
root.append(label);
console.log(root instanceof ShadowRoot);
console.log(host.shadowRoot === root);
console.log(root.host === host);
console.log(root.querySelector("span").textContent);
console.log(host.querySelector("span") === null);
const closedHost = document.createElement("div");
const closedRoot = closedHost.attachShadow({ mode: "closed" });
console.log(closedHost.shadowRoot === null);
console.log(closedRoot.host === closedHost);
})();Risultato
true true true Hello true true 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.