Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori