Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

ShadowRoot — kořen stromu Shadow DOM

ShadowRoot představuje kořen stromu Shadow DOM přiřazeného k hostitelskému prvku. Umožňuje přístup k vnitřní struktuře komponenty. Režimy open a closed se liší přístupem přes host.shadowRoot, žádný z nich však nevytváří bezpečnostní hranici.

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

Syntaxe

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

ShadowRoot je kořen stromu Shadow DOM, specializovaný DocumentFragment přiřazený k hostitelskému prvku. Jeho vnitřní uzly tvoří samostatný strom: host.querySelector() je neprohledává, zatímco root.querySelector() hledá uvnitř tohoto stromu. Vlastnost root.host označuje hostitele.

Kořen vytvořte pomocí host.attachShadow({ mode: "open" }), nikoli pomocí new ShadowRoot(). Metoda kořen vrátí; při režimu open k němu zpřístupňuje přístup také host.shadowRoot. Při režimu closed tato vlastnost vrátí null, uložená reference však dál funguje. Režim closed omezuje přístup přes tuto vlastnost, ale nechrání před nedůvěryhodným kódem.

Shadow DOM podporuje zapouzdření komponent, nejde však o samostatný dokument ani o úplnou izolaci stylů: dědění CSS je stále důležité. Prvek slot může zobrazovat potomky hostitele, aniž by je přesunul do shadow stromu. K použití Shadow DOM na podporovaném hostiteli, například div, nemusíte registrovat vlastní prvek.

Jde o API webové platformy, nikoli o funkci konkrétní edice ECMAScriptu. Přítomnost Node 24 v repozitáři nedokládá podporu v prohlížeči. Příklad vyžaduje prohlížeč s attachShadow a porovnává oba režimy, aniž by měnil stránku.

Pří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ýsledek

true
true
true
Hello
true
true
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje