WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Element.attachShadow — einen Shadow-DOM-Baum anhängen

Element.attachShadow() hängt an ein unterstütztes Element eine Shadow-DOM-Wurzel an und gibt ein ShadowRoot zurück. Der erforderliche Modus open oder closed steuert den Zugriff über host.shadowRoot, bildet aber keine Sicherheitsgrenze.

Version: 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() erstellt einen Shadow-DOM-Baum, der einem Host-Element zugeordnet ist, und gibt dessen ShadowRoot zurück. Dabei handelt es sich um einen separaten Baum: Seine Knoten werden nicht zu gewöhnlichen Kindern des Hosts. Deshalb durchsucht host.querySelector() nicht dessen Inneres; rufe die Methode stattdessen auf der zurückgegebenen Wurzel auf.

Die Option mode ist erforderlich. Bei "open" stellt host.shadowRoot die Wurzel bereit; bei "closed" gibt es null zurück. In beiden Modi gibt attachShadow() die Wurzel zurück, sodass eine gespeicherte Referenz weiterhin Änderungen daran ermöglicht. "closed" schützt keine vertraulichen Daten.

Nicht jedes Element kann als Host dienen: div wird unterstützt, input beispielsweise nicht. Ein nicht unterstützter Host oder das erneute Anhängen an eine gewöhnliche, bereits vorhandene Wurzel verursacht NotSupportedError. Eine vorhandene deklarative Wurzel ist eine Ausnahme: Bei übereinstimmendem mode kann sie wiederverwendet werden, wobei ihr Inhalt gelöscht wird; bei einem abweichenden Modus tritt ein Fehler auf.

Dies ist eine Browser-DOM-API und keine Funktion einer bestimmten ECMAScript-Ausgabe. Prüfe typeof Element.prototype.attachShadow === "function" im Zielbrowser; damit ist die Unterstützung jeder zusätzlichen Option nicht nachgewiesen. Node 24 im Repository belegt nicht, dass diese API unterstützt wird.

Beispiele

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

Ergebnis

true
true
Hello

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen