База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

ShadowRoot — коренът на дърво Shadow DOM

ShadowRoot представя корена на дърво Shadow DOM, свързано с хост елемент. Той дава достъп до вътрешната структура на компонент. Режимите open и closed се различават по достъпа чрез host.shadowRoot, но нито един от тях не създава граница на сигурност.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

const root = host.attachShadow({ mode: "open" });
const sameRoot = host.shadowRoot;
root.append(document.createElement("span"));

ShadowRoot е коренът на дърво Shadow DOM и специализиран DocumentFragment, свързан с хост елемент. Вътрешните му възли образуват отделно дърво: host.querySelector() не ги търси, докато root.querySelector() търси в него. Свойството root.host указва хоста.

Създай корен с host.attachShadow({ mode: "open" }), а не с new ShadowRoot(). Методът връща корена; при режим open достъп до него дава и host.shadowRoot. При режим closed това свойство връща null, но запазена препратка продължава да работи. closed ограничава достъпа чрез това свойство, но не защитава от недоверен код.

Shadow DOM позволява капсулиране на компоненти, но не е отделен документ и не осигурява пълна изолация на стиловете: наследяването на CSS продължава да има значение. Елемент slot може да показва децата на хоста, без да ги премества в shadow дървото. Не е необходимо да регистрираш персонализиран елемент, за да използваш Shadow DOM при поддържан хост, например div.

Това е API на уеб платформата, а не функция на конкретно издание на ECMAScript. Наличието на Node 24 в хранилище не доказва поддръжка в браузърите. Примерът изисква браузър с attachShadow и сравнява двата режима, без да променя страницата.

Примери

(() => {
  const host = document.createElement("div");
  const root = host.attachShadow({ mode: "open" });
  const label = document.createElement("span");
  label.textContent = "Hello";
  root.append(label);

  console.log(root instanceof ShadowRoot);
  console.log(host.shadowRoot === root);
  console.log(root.host === host);
  console.log(root.querySelector("span").textContent);
  console.log(host.querySelector("span") === null);

  const closedHost = document.createElement("div");
  const closedRoot = closedHost.attachShadow({ mode: "closed" });
  console.log(closedHost.shadowRoot === null);
  console.log(closedRoot.host === closedHost);
})();

Резултат

true
true
true
Hello
true
true
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници