CKTIS / JavaScript
Element.attachShadow — připojení stromu Shadow DOM
Element.attachShadow() připojí kořen Shadow DOM k podporovanému prvku a vrátí ShadowRoot. Povinný režim open nebo closed řídí přístup přes host.shadowRoot, ale nepředstavuje bezpečnostní hranici.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const root = element.attachShadow({ mode: "open" });Element.attachShadow() vytvoří strom Shadow DOM přiřazený k hostitelskému prvku a vrátí jeho ShadowRoot. Jde o samostatný strom: jeho uzly se nestávají běžnými potomky hostitele. Proto host.querySelector() jeho obsah neprohledává; metodu zavolejte na vráceném kořeni.
Možnost mode je povinná. Při hodnotě "open" zpřístupňuje host.shadowRoot kořen; při "closed" vrací null. V obou režimech vrací kořen také attachShadow(), takže uložený odkaz stále umožňuje jeho úpravy. Režim "closed" nechrání důvěrná data.
Hostitelem nemůže být každý prvek: div je podporovaný, ale například input nikoli. Nepodporovaný hostitel nebo opětovné připojení k běžnému existujícímu kořeni způsobí NotSupportedError. Výjimkou je existující deklarativní kořen: odpovídající mode dovolí jeho opětovné použití, ale vymaže jeho obsah; neodpovídající režim způsobí chybu.
Jde o prohlížečové DOM API, nikoli o funkci konkrétní edice ECMAScriptu. V cílovém prohlížeči ověřte typeof Element.prototype.attachShadow === "function"; tento test nepotvrzuje podporu všech dalších možností. Node 24 v repozitáři nedokazuje podporu tohoto API.
Pří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ýsledek
true true Hello
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.