Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Element.attachShadow — pripenjanje drevesa Shadow DOM

Element.attachShadow() pripne koren Shadow DOM na podprt element in vrne ShadowRoot. Obvezni način open ali closed določa dostop prek host.shadowRoot, vendar ne predstavlja varnostne meje.

Različica: 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() ustvari drevo Shadow DOM, povezano z gostiteljskim elementom, in vrne njegov ShadowRoot. To je ločeno drevo: njegova vozlišča ne postanejo običajni otroci gostitelja. Zato host.querySelector() ne išče po njegovi notranjosti; metodo pokličite na vrnjenem korenu.

Možnost mode je obvezna. Pri "open" host.shadowRoot razkrije koren; pri "closed" vrne null. V obeh načinih attachShadow() vrne koren, zato ga lahko še vedno spreminjate, če ohranite sklic nanj. "closed" ne varuje zaupnih podatkov.

Gostitelj ne more biti vsak element: div je podprt, input pa na primer ne. Nepodprt gostitelj ali ponovna priključitev na običajen že obstoječi koren povzroči NotSupportedError. Izjema je obstoječi deklarativni koren: ujemajoči se mode omogoča ponovno uporabo, vendar izbriše njegovo vsebino; neujemajoči se način povzroči napako.

To je brskalniški DOM API, ne funkcija določene izdaje ECMAScript. V ciljnem brskalniku preverite typeof Element.prototype.attachShadow === "function"; ta preizkus ne potrjuje podpore za vsako dodatno možnost. Node 24 v repozitoriju ne dokazuje podpore za ta API.

Primeri

(() => {
  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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri