CKTIS / JavaScript
ShadowRoot — korzeń drzewa Shadow DOM
ShadowRoot reprezentuje korzeń drzewa Shadow DOM powiązanego z elementem gospodarzem. Pozwala zarządzać wewnętrzną strukturą komponentu. Tryby open i closed różnią się dostępem przez host.shadowRoot, ale nie tworzą granicy bezpieczeństwa.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const root = host.attachShadow({ mode: "open" });
const sameRoot = host.shadowRoot;
root.append(document.createElement("span"));ShadowRoot to korzeń drzewa Shadow DOM, wyspecjalizowany DocumentFragment powiązany z elementem gospodarzem. Wewnętrzne węzły tworzą osobne drzewo: host.querySelector() ich nie przeszukuje, natomiast root.querySelector() działa wewnątrz niego. Właściwość root.host wskazuje gospodarza.
Korzeń tworzysz przez host.attachShadow({ mode: "open" }), nie przez new ShadowRoot(). Metoda zwraca korzeń; przy open udostępnia go także host.shadowRoot. Przy closed ta właściwość zwraca null, lecz zachowana referencja nadal działa. closed ogranicza dostęp przez tę właściwość, nie stanowi zabezpieczenia przed niezaufanym kodem.
Shadow DOM służy enkapsulacji komponentów, ale nie jest osobnym dokumentem ani pełną izolacją stylów: dziedziczenie CSS nadal ma znaczenie. Element slot może prezentować dzieci gospodarza bez przenoszenia ich do drzewa shadow. Nie musisz rejestrować custom element, aby użyć Shadow DOM na obsługiwanym gospodarzu, takim jak div.
To API platformy WWW, nie funkcja konkretnej edycji ECMAScript. Obecność Node 24 w repozytorium nie potwierdza obsługi w przeglądarce. Przykład wymaga przeglądarki z attachShadow i porównuje oba tryby bez modyfikowania strony.
Przykłady
(() => {
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);
})();Wynik
true true true Hello true true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.