Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje