Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti