CKTIS / JavaScript
Element.attachShadow — dołączanie drzewa Shadow DOM
Element.attachShadow() dołącza korzeń Shadow DOM do obsługiwanego elementu i zwraca ShadowRoot. Wymagany tryb open lub closed określa dostęp przez host.shadowRoot, a nie granicę 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 = element.attachShadow({ mode: "open" });Element.attachShadow() tworzy drzewo Shadow DOM powiązane z elementem-gospodarzem i zwraca jego ShadowRoot. To osobne drzewo: jego węzły nie stają się zwykłymi dziećmi gospodarza. Dlatego host.querySelector() nie przeszukuje jego wnętrza; użyj metody na zwróconym korzeniu.
Opcja mode jest wymagana. Dla "open" właściwość host.shadowRoot udostępnia korzeń; dla "closed" zwraca null. W obu trybach attachShadow() zwraca korzeń, więc zachowana referencja nadal pozwala go modyfikować. "closed" nie jest zabezpieczeniem poufnych danych.
Nie każdy element może być gospodarzem: div jest obsługiwany, ale na przykład input nie. Nieobsługiwany gospodarz lub ponowne dołączenie do zwykłego, istniejącego korzenia powoduje NotSupportedError. Wyjątek dotyczy istniejącego deklaratywnego korzenia: zgodny mode pozwala go ponownie wykorzystać, ale usuwa jego zawartość; niezgodny tryb powoduje błąd.
To przeglądarkowe API DOM, a nie funkcja określonej edycji ECMAScript. Sprawdź typeof Element.prototype.attachShadow === "function" w docelowej przeglądarce; ten test nie potwierdza obsługi każdej dodatkowej opcji. Node 24 w repozytorium nie dowodzi obsługi tego API.
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(host.shadowRoot === root);
console.log(host.querySelector("span") === null);
console.log(root.querySelector("span").textContent);
})();Wynik
true true Hello
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.