CKTIS / JavaScript
ShadowRoot — koreň stromu Shadow DOM
ShadowRoot predstavuje koreň stromu Shadow DOM priradeného k hostiteľskému prvku. Umožňuje prístup k vnútornej štruktúre komponentu. Režimy open a closed sa líšia prístupom cez host.shadowRoot, no ani jeden nevytvára bezpečnostnú hranicu.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const root = host.attachShadow({ mode: "open" });
const sameRoot = host.shadowRoot;
root.append(document.createElement("span"));ShadowRoot je koreň stromu Shadow DOM, špecializovaný DocumentFragment priradený k hostiteľskému prvku. Jeho vnútorné uzly tvoria samostatný strom: host.querySelector() ich neprehľadáva, zatiaľ čo root.querySelector() hľadá v jeho vnútri. Vlastnosť root.host označuje hostiteľa.
Koreň vytvor pomocou host.attachShadow({ mode: "open" }), nie pomocou new ShadowRoot(). Metóda koreň vráti; pri režime open k nemu sprístupňuje prístup aj host.shadowRoot. Pri režime closed táto vlastnosť vráti null, no uložená referencia naďalej funguje. Režim closed obmedzuje prístup cez túto vlastnosť, ale nechráni pred nedôveryhodným kódom.
Shadow DOM podporuje zapuzdrenie komponentov, nejde však o samostatný dokument ani o úplnú izoláciu štýlov: dedenie CSS je stále dôležité. Prvok slot môže zobrazovať potomkov hostiteľa bez toho, aby ich presunul do shadow stromu. Na použitie Shadow DOM na podporovanom hostiteľovi, napríklad div, nemusíš registrovať vlastný prvok.
Ide o API webovej platformy, nie o funkciu konkrétneho vydania ECMAScriptu. Prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadači. Príklad vyžaduje prehliadač s attachShadow a porovnáva oba režimy bez úpravy stránky.
Príklady
(() => {
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);
})();Výsledok
true true true Hello true true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.