KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Element.attachShadow — een Shadow DOM-boom koppelen

Element.attachShadow() koppelt een Shadow DOM-root aan een ondersteund element en retourneert een ShadowRoot. De verplichte modus open of closed bepaalt de toegang via host.shadowRoot, maar vormt geen 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 = element.attachShadow({ mode: "open" });

Element.attachShadow() maakt een Shadow DOM-boom die hoort bij een host-element en retourneert de bijbehorende ShadowRoot. Dit is een aparte boom: de knooppunten ervan worden geen gewone kinderen van de host. Daarom doorzoekt host.querySelector() de inhoud niet; roep de methode aan op de geretourneerde root.

De optie mode is verplicht. Met "open" geeft host.shadowRoot toegang tot de root; met "closed" retourneert deze null. In beide modi retourneert attachShadow() de root, zodat je die met een bewaarde verwijzing nog steeds kunt aanpassen. "closed" beveiligt geen vertrouwelijke gegevens.

Niet elk element kan als host dienen: div wordt ondersteund, maar bijvoorbeeld input niet. Een niet-ondersteunde host of opnieuw koppelen aan een gewone, al bestaande root veroorzaakt NotSupportedError. Een bestaande declaratieve root vormt een uitzondering: een overeenkomende mode maakt hergebruik mogelijk, maar wist de inhoud; een afwijkende modus veroorzaakt een fout.

Dit is een browser-DOM-API, geen functie van een bepaalde ECMAScript-editie. Controleer typeof Element.prototype.attachShadow === "function" in de doelbrowser; deze test toont niet aan dat elke aanvullende optie wordt ondersteund. Node 24 in de repository bewijst niet dat deze API wordt ondersteund.

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(host.shadowRoot === root);
  console.log(host.querySelector("span") === null);
  console.log(root.querySelector("span").textContent);
})();

Resultaat

true
true
Hello

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