Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

ShadowRoot — korijen stabla Shadow DOM

ShadowRoot predstavlja korijen stabla Shadow DOM povezanog s elementom domaćinom. Omogućuje pristup unutarnjoj strukturi komponente. Načini open i closed razlikuju se po pristupu putem host.shadowRoot, ali nijedan ne stvara sigurnosnu granicu.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

const root = host.attachShadow({ mode: "open" });
const sameRoot = host.shadowRoot;
root.append(document.createElement("span"));

ShadowRoot je korijen stabla Shadow DOM, specijalizirani DocumentFragment povezan s elementom domaćinom. Njegovi unutarnji čvorovi čine zasebno stablo: host.querySelector() ne pretražuje ih, dok root.querySelector() pretražuje unutar njega. Svojstvo root.host označava domaćina.

Korijen stvori pomoću host.attachShadow({ mode: "open" }), a ne pomoću new ShadowRoot(). Metoda vraća korijen; u načinu open pristup mu omogućuje i host.shadowRoot. U načinu closed to svojstvo vraća null, no spremljena referenca i dalje funkcionira. Način closed ograničava pristup putem tog svojstva, ali ne štiti od nepouzdanog koda.

Shadow DOM omogućuje enkapsulaciju komponenti, ali nije zaseban dokument niti pruža potpunu izolaciju stilova: nasljeđivanje CSS-a i dalje je važno. Element slot može prikazati djecu domaćina bez njihova premještanja u shadow stablo. Ne moraš registrirati prilagođeni element da bi upotrijebio Shadow DOM na podržanom domaćinu, primjerice div.

Ovo je API web-platforme, a ne značajka određenog izdanja ECMAScripta. Prisutnost Node 24 u repozitoriju ne potvrđuje podršku u pregledniku. Primjer zahtijeva preglednik s attachShadow i uspoređuje oba načina bez izmjene stranice.

Primjeri

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

Rezultat

true
true
true
Hello
true
true
true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori