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.