Shadow root nie izoluje wszystkiego. Co przechodzi przez granicę?

4 listopada 2026

Ciemny ekran laptopa z podświetlaną na czerwono klawiaturą. Kod źródłowy, jakby cień korzenia, wylewa się z ekranu.

Wstawiasz widget do sklepu albo panelu klienta i po chwili jego przyciski zmieniają wygląd przez globalny CSS strony. Shadow root zwykle pozwala odizolować strukturę i style komponentu, ale nie odcina go od całego otoczenia. To, co przechodzi przez granicę, zależy między innymi od dziedziczenia CSS, slotów i obsługi zdarzeń.

Drzewo DOM z elementami DIV, SLOT i P. Widoczny jest shadow root, shadow host i shadow boundary.

Shadow root izoluje wnętrze komponentu, ale nie wszystkie jego połączenia z resztą strony

  • open pozwala odczytać root przez właściwość element.shadowRoot; closed zwraca tam null.
  • CSS zewnętrznej strony nie trafia zwykłymi selektorami do wnętrza, lecz część wartości nadal może być dziedziczona.
  • Zdarzenia mogą przekraczać granicę drzewa, a zdarzenia własne często wymagają opcji composed: true.
  • Angular domyślnie emuluje izolację stylów; ViewEncapsulation.ShadowDom tworzy natywny shadow root.

Root tworzy osobne drzewo, a host pozostaje jego łącznikiem ze stroną

Element, do którego dołączasz shadow tree, nazywa się hostem, a sam shadow root jest korzeniem odrębnego drzewa DOM. Ta granica ogranicza przypadkowe konflikty selektorów i identyfikatorów, co przydaje się w komponencie osadzanym na stronach o nieznanych stylach. Nie znaczy to jednak, że komponent staje się osobną stroną.

Root utworzysz metodą attachShadow(), zwykle wewnątrz własnego elementu HTML:

class InfoCard extends HTMLElement {
  constructor() {
    super();

    const root = this.attachShadow({ mode: "open" });
    root.innerHTML = `
      
      

Treść komponentu

`; } } customElements.define("info-card", InfoCard);

Przy trybie open kod strony może dostać się do roota przez host.shadowRoot. W trybie closed ta właściwość zwraca null, ale nie należy traktować tego jako zabezpieczenia: tryb ogranicza dostęp przez ten interfejs, nie stanowi mechanizmu ochrony danych. Opisuje to dokumentacja MDN dotycząca właściwości shadowRoot.

Shadow DOM izoluje selektory, lecz dziedziczenie CSS nadal przenosi część wartości

Jeśli globalny arkusz zawiera regułę button { ... }, nie wystyluje wprost przycisku ukrytego w shadow tree. Właśnie ta przewidywalność jest powodem, dla którego uważam shadow DOM za dobry wybór dla komponentu dystrybuowanego poza jedną aplikacją. Granica nie zeruje jednak dziedziczenia: do wnętrza mogą przechodzić między innymi wartości typografii ustawione na hoście.

Najczęstsza pułapka ujawnia się przy motywach. Możesz wystawić kontrolowane punkty konfiguracji przez zmienne CSS, na przykład --card-color, a w środku użyć var(--card-color). Treść przekazana przez również zachowuje połączenie z dokumentem hosta: element przypisany do slotu pozostaje w zwykłym drzewie, więc jego style nie zachowują się tak, jakby został przeniesiony do shadow tree. Praktyczny opis izolacji, dziedziczenia i slotów zawiera przewodnik MDN o Shadow DOM.

Sytuacja Prawdopodobna przyczyna Co zrobić
Globalny selektor nie zmienia przycisku komponentu Przycisk znajduje się za granicą shadow tree Dodaj styl wewnątrz roota albo udostępnij kontrolowany interfejs, na przykład zmienną CSS lub ::part
Komponent dziedziczy font lub kolor z otoczenia Wartość może być dziedziczona mimo izolacji selektorów Ustal jawne wartości na hoście lub w komponencie; zmienne CSS zostaw jako celowe punkty konfiguracji
Obsługa zdarzenia na dokumencie nie widzi elementu wewnętrznego Ścieżka zdarzenia przechodzi przez granicę, a szczegóły zależą od typu zdarzenia i trybu roota Sprawdź composedPath() albo emituj własne zdarzenie z odpowiednimi opcjami

Zdarzenia przekraczają granicę tylko wtedy, gdy pozwalają na to ich właściwości

Kliknięcie zwykle dociera do elementów poza shadow tree, ale własne zdarzenie utworzone bez odpowiedniej konfiguracji może zatrzymać się wewnątrz. Dla komponentu, który ma informować aplikację o zmianie, możesz wysłać zdarzenie tak:

this.dispatchEvent(new CustomEvent("value-change", {
  detail: { value: this.value },
  bubbles: true,
  composed: true
}));

bubbles pozwala zdarzeniu bąbelkować, a composed umożliwia mu przekroczenie granicy shadow DOM. Przy diagnozowaniu nasłuchu przydaje się event.composedPath(), które pokazuje ścieżkę zdarzenia; zamknięty root ukrywa z niej swoje wewnętrzne węzły. To szczegół łatwy do przeoczenia, gdy komponent wizualnie działa, ale aplikacja nadrzędna nie reaguje.

Nie zakładaj też, że każde zdarzenie zachowuje się jak kliknięcie: według dokumentacji MDN o właściwości composed zdarzenia interfejsu użytkownika są złożone, natomiast wiele zdarzeń tworzonych programowo domyślnie nie przekracza tej granicy. Własny event komponentu powinien więc jasno określać, czy ma być widoczny dla kodu spoza roota.

W Angularze wybór ShadowDom zmienia więcej niż sposób zapisu CSS

W Angularze podobny efekt izolacji możesz uzyskać bez natywnego shadow root. Domyślne ViewEncapsulation.Emulated modyfikuje selektory i dodaje atrybuty do elementów, by ograniczyć zasięg stylów; globalny CSS nadal może jednak wpływać na wnętrze komponentu. Z kolei ViewEncapsulation.ShadowDom korzysta z przeglądarkowego API i tworzy prawdziwą granicę drzewa.

To wybór między wygodną współpracą z resztą aplikacji a silniejszą izolacją. Dokumentacja Angular API dla ViewEncapsulation wskazuje też, że natywny tryb wpływa na propagację zdarzeń i obsługę slotów. Jeśli komponent pozostaje częścią jednej aplikacji Angular, zacząłbym od trybu emulowanego; dla elementu przeznaczonego do osadzania w różnych serwisach rozważyłbym natywny shadow root i osobno przetestował integrację zdarzeń oraz motywów.

Przy renderowaniu po stronie serwera root może powstać jeszcze przed JavaScriptem

Przy renderowaniu klientowym przeglądarka zobaczy wnętrze komponentu dopiero po uruchomieniu skryptu i wywołaniu attachShadow(). Jeśli ważne jest wcześniejsze pokazanie gotowej struktury, rozwiązaniem może być Declarative Shadow DOM: znacznik pozwala parserowi utworzyć root bez czekania na JavaScript.

To przydatne przy serwerowym renderowaniu własnych elementów i ograniczaniu błysku nieostylowanej treści, ale wymaga zgodności z używanym sposobem renderowania i późniejszej hydratacji komponentu. Wskazówki dotyczące tego wzorca publikuje Chrome for Developers. Jeśli aplikacja nie potrzebuje takiego scenariusza, imperatywne tworzenie roota pozostaje prostszym punktem wyjścia.

Wybierz shadow root wtedy, gdy kontrolujesz także jego interfejs

Shadow root rozwiązuje konkretny problem: ogranicza konflikty między wnętrzem komponentu a stroną, która go osadza. Najlepiej sprawdza się, gdy razem z izolacją projektu przewidzisz sposób ustawiania motywu, przekazywania treści i komunikacji zdarzeniami. Bez tych punktów integracji zewnętrzny CSS przestaje przeszkadzać, ale równie łatwo może utrudnić dostosowanie widgetu.

Praktyczna decyzja jest prosta: dla elementu używanego w jednym kontrolowanym projekcie zacznij od mechanizmu izolacji oferowanego przez framework; dla komponentu osadzanego na niezależnych stronach rozważ natywny root i zaprojektuj jego publiczne punkty stylowania. Wtedy granica działa jak dobrze zaprojektowane API, a nie jak mur, za którym trudno cokolwiek zmienić.

FAQ - Najczęstsze pytania

W trybie open kod strony może odczytać root przez element.shadowRoot. W trybie closed ta właściwość zwraca null, ale nie jest to zabezpieczenie danych, tylko ograniczenie dostępu przez ten interfejs.

Zwykły selektor zewnętrzny, taki jak button { ... }, nie wystyluje bezpośrednio elementu ukrytego w shadow tree. Część wartości, między innymi typografia, może jednak być dziedziczona, a kontrolowane zmiany motywu można udostępnić przez zmienne CSS, takie jak --card-color. Element przekazany przez pozostaje w zwykłym drzewie dokumentu i zachowuje połączenie ze stylami hosta.

Własne zdarzenie powinno mieć ustawione bubbles: true, aby bąbelkowało, oraz composed: true, aby mogło przekroczyć granicę shadow DOM. Do diagnozowania ścieżki zdarzenia służy event.composedPath(), przy czym zamknięty root ukrywa z niej swoje wewnętrzne węzły.

ViewEncapsulation.Emulated ogranicza zasięg stylów przez modyfikację selektorów i atrybuty, ale globalny CSS może nadal wpływać na komponent. ViewEncapsulation.ShadowDom tworzy natywny shadow root, dlatego warto rozważyć go przy komponencie osadzanym w różnych serwisach. W jednej kontrolowanej aplikacji Angular tryb emulowany może być prostszy, natomiast przy natywnym root należy osobno przetestować zdarzenia i motywy.
Oceń artykuł

Średnia: 4.3 / 5 · 10 ocen

Tagi

web components angular css shadow dom sloty

Udostępnij artykuł

Komentarze (0)
Dodaj komentarz