CKTIS / JavaScript
ShadowRoot — die Wurzel eines Shadow-DOM-Baums
ShadowRoot stellt die Wurzel eines Shadow-DOM-Baums dar, der einem Host-Element zugeordnet ist. Damit lässt sich die interne Struktur einer Komponente verwalten. Die Modi open und closed unterscheiden sich beim Zugriff über host.shadowRoot, bilden 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 = host.attachShadow({ mode: "open" });
const sameRoot = host.shadowRoot;
root.append(document.createElement("span"));ShadowRoot ist die Wurzel eines Shadow-DOM-Baums und ein spezialisiertes DocumentFragment, das einem Host-Element zugeordnet ist. Seine internen Knoten bilden einen eigenen Baum: host.querySelector() durchsucht sie nicht, während root.querySelector() innerhalb dieses Baums sucht. Die Eigenschaft root.host verweist auf den Host.
Erzeuge eine Wurzel mit host.attachShadow({ mode: "open" }), nicht mit new ShadowRoot(). Die Methode gibt die Wurzel zurück; bei open macht auch host.shadowRoot sie zugänglich. Bei closed gibt diese Eigenschaft null zurück, eine gespeicherte Referenz funktioniert jedoch weiterhin. closed schränkt den Zugriff über diese Eigenschaft ein, schützt aber nicht vor nicht vertrauenswürdigem Code.
Shadow DOM unterstützt die Kapselung von Komponenten, ist aber weder ein separates Dokument noch eine vollständige Isolation von Stilen: Die CSS-Vererbung bleibt relevant. Ein slot-Element kann die Kinder des Hosts darstellen, ohne sie in den Shadow-Baum zu verschieben. Du musst kein Custom Element registrieren, um Shadow DOM auf einem unterstützten Host wie div zu verwenden.
Dies ist eine Web-API und keine Funktion einer bestimmten ECMAScript-Ausgabe. Dass Node 24 in einem Repository vorhanden ist, belegt keine Browser-Unterstützung. Das Beispiel erfordert einen Browser mit attachShadow und vergleicht beide Modi, ohne die Seite zu verändern.
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(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);
})();Ergebnis
true true true Hello true true true
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.