CKTIS / JavaScript
Element.attachShadow — collegare un albero Shadow DOM
Element.attachShadow() collega una radice Shadow DOM a un elemento supportato e restituisce uno ShadowRoot. La modalità obbligatoria, open o closed, controlla l’accesso tramite host.shadowRoot, ma non costituisce 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 = element.attachShadow({ mode: "open" });Element.attachShadow() crea un albero Shadow DOM associato a un elemento host e ne restituisce lo ShadowRoot. È un albero separato: i suoi nodi non diventano normali figli dell’host. Di conseguenza, host.querySelector() non cerca al suo interno; chiama invece il metodo sulla radice restituita.
L’opzione mode è obbligatoria. Con "open", host.shadowRoot espone la radice; con "closed", restituisce null. In entrambe le modalità, attachShadow() restituisce la radice, quindi un riferimento conservato permette comunque di modificarla. "closed" non protegge i dati riservati.
Non tutti gli elementi possono fungere da host: div è supportato, mentre input, per esempio, non lo è. Un host non supportato o un nuovo collegamento a una normale radice già esistente causa NotSupportedError. Una radice dichiarativa esistente è un’eccezione: una mode corrispondente consente di riutilizzarla, ma ne cancella il contenuto; una modalità diversa causa un errore.
Questa è un’API DOM del browser, non una funzionalità di una specifica edizione di ECMAScript. Controlla typeof Element.prototype.attachShadow === "function" nel browser di destinazione; questo controllo non dimostra il supporto di ogni opzione aggiuntiva. La presenza di Node 24 nel repository non dimostra il supporto di questa API.
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(host.shadowRoot === root);
console.log(host.querySelector("span") === null);
console.log(root.querySelector("span").textContent);
})();Risultato
true true Hello
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.