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.