KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

ShadowRoot — de wortel van een Shadow DOM-boom

ShadowRoot stelt de wortel voor van een Shadow DOM-boom die bij een hostelement hoort. Hiermee krijg je toegang tot de interne structuur van een component. De modi open en closed verschillen in toegang via host.shadowRoot, maar vormen geen van beide een beveiligingsgrens.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const root = host.attachShadow({ mode: "open" });
const sameRoot = host.shadowRoot;
root.append(document.createElement("span"));

ShadowRoot is de wortel van een Shadow DOM-boom, een gespecialiseerde DocumentFragment die bij een hostelement hoort. De interne knooppunten vormen een aparte boom: host.querySelector() doorzoekt ze niet, terwijl root.querySelector() binnen die boom zoekt. De eigenschap root.host verwijst naar de host.

Maak een wortel met host.attachShadow({ mode: "open" }), niet met new ShadowRoot(). De methode retourneert de wortel; bij open geeft ook host.shadowRoot er toegang toe. Bij closed retourneert die eigenschap null, maar een bewaarde verwijzing blijft werken. closed beperkt de toegang via die eigenschap, maar beschermt niet tegen niet-vertrouwde code.

Shadow DOM ondersteunt de inkapseling van componenten, maar is geen afzonderlijk document en biedt geen volledige isolatie van stijlen: CSS-overerving blijft van belang. Een slot-element kan de kinderen van de host weergeven zonder ze naar de shadow-boom te verplaatsen. Je hoeft geen custom element te registreren om Shadow DOM te gebruiken op een ondersteunde host, zoals div.

Dit is een API van het webplatform, geen functie van een bepaalde ECMAScript-editie. De aanwezigheid van Node 24 in een repository bewijst geen browserondersteuning. Het voorbeeld vereist een browser met attachShadow en vergelijkt beide modi zonder de pagina te wijzigen.

Voorbeelden

(() => {
  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);
})();

Resultaat

true
true
true
Hello
true
true
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen