Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje