CKTIS / JavaScript
Element.attachShadow — pridruživanje stabla Shadow DOM
Element.attachShadow() pridružuje korijen Shadow DOM-a podržanom elementu i vraća ShadowRoot. Obvezni način open ili closed određuje pristup putem host.shadowRoot, ali ne predstavlja sigurnosnu granicu.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const root = element.attachShadow({ mode: "open" });Element.attachShadow() stvara stablo Shadow DOM-a povezano s elementom domaćinom i vraća njegov ShadowRoot. To je zasebno stablo: njegovi čvorovi ne postaju obična djeca domaćina. Zato host.querySelector() ne pretražuje njegovu unutrašnjost; pozovite metodu na vraćenom korijenu.
Opcija mode je obvezna. Uz "open", host.shadowRoot izlaže korijen; uz "closed" vraća null. U oba načina attachShadow() vraća korijen pa ga spremljena referenca i dalje omogućuje mijenjati. "closed" ne štiti povjerljive podatke.
Domaćin ne može biti svaki element: div je podržan, ali input, primjerice, nije. Nepodržan domaćin ili ponovno pridruživanje običnom već postojećem korijenu uzrokuje NotSupportedError. Iznimka je postojeći deklarativni korijen: podudarni mode omogućuje ponovnu uporabu, ali briše njegov sadržaj; nepodudarni način uzrokuje pogrešku.
Ovo je preglednički DOM API, a ne značajka određenog izdanja ECMAScripta. U ciljnom pregledniku provjerite typeof Element.prototype.attachShadow === "function"; ta provjera ne potvrđuje podršku za svaku dodatnu opciju. Node 24 u repozitoriju ne dokazuje podršku za ovaj API.
Primjeri
(() => {
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);
})();Rezultat
true true Hello
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.