CKTIS / JavaScript
ShadowRoot — koren drevesa Shadow DOM
ShadowRoot predstavlja koren drevesa Shadow DOM, povezanega z gostiteljskim elementom. Omogoča dostop do notranje strukture komponente. Načina open in closed se razlikujeta po dostopu prek host.shadowRoot, vendar nobeden ne ustvari varnostne meje.
Različica: 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 koren drevesa Shadow DOM, specializiran DocumentFragment, povezan z gostiteljskim elementom. Njegova notranja vozlišča tvorijo ločeno drevo: host.querySelector() jih ne išče, medtem ko root.querySelector() išče znotraj njega. Lastnost root.host označuje gostitelja.
Koren ustvari z host.attachShadow({ mode: "open" }), ne z new ShadowRoot(). Metoda vrne koren; pri načinu open do njega omogoča dostop tudi host.shadowRoot. Pri načinu closed ta lastnost vrne null, vendar shranjena referenca še vedno deluje. Način closed omeji dostop prek te lastnosti, ne zaščiti pa pred nezaupanja vredno kodo.
Shadow DOM podpira enkapsulacijo komponent, vendar ni ločen dokument in ne zagotavlja popolne izolacije slogov: dedovanje CSS je še vedno pomembno. Element slot lahko prikaže otroke gostitelja, ne da bi jih premaknil v drevo shadow. Za uporabo Shadow DOM na podprtem gostitelju, kot je div, ti ni treba registrirati elementa po meri.
To je API spletne platforme, ne funkcija določene izdaje ECMAScripta. Prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalniku. Primer zahteva brskalnik z attachShadow in primerja oba načina, ne da bi spreminjal stran.
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.