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.