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

CKTIS / JavaScript

Element.attachShadow — pripojenie stromu Shadow DOM

Element.attachShadow() pripojí koreň Shadow DOM k podporovanému prvku a vráti ShadowRoot. Povinný režim open alebo closed riadi prístup cez host.shadowRoot, ale nepredstavuje 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 = element.attachShadow({ mode: "open" });

Element.attachShadow() vytvorí strom Shadow DOM priradený k hostiteľskému prvku a vráti jeho ShadowRoot. Ide o samostatný strom: jeho uzly sa nestávajú bežnými potomkami hostiteľa. Preto host.querySelector() jeho obsah neprehľadáva; metódu zavolajte na vrátenom koreni.

Možnosť mode je povinná. Pri hodnote "open" sprístupňuje host.shadowRoot koreň; pri "closed" vracia null. V oboch režimoch vracia koreň aj attachShadow(), takže uložený odkaz stále umožňuje jeho úpravy. Režim "closed" nechráni dôverné údaje.

Hostiteľom nemôže byť každý prvok: div je podporovaný, ale napríklad input nie. Nepodporovaný hostiteľ alebo opätovné pripojenie k bežnému existujúcemu koreňu spôsobí NotSupportedError. Výnimkou je existujúci deklaratívny koreň: zodpovedajúci mode umožní jeho opätovné použitie, ale vymaže jeho obsah; nezhodný režim spôsobí chybu.

Ide o prehliadačové DOM API, nie o funkciu konkrétnej edície ECMAScriptu. V cieľovom prehliadači overte typeof Element.prototype.attachShadow === "function"; tento test nepotvrdzuje podporu všetkých ďalších možností. Node 24 v repozitári nedokazuje podporu tohto API.

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(host.shadowRoot === root);
  console.log(host.querySelector("span") === null);
  console.log(root.querySelector("span").textContent);
})();

Výsledok

true
true
Hello

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje