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

CKTIS / JavaScript

Element.attachShadow — прикачване на Shadow DOM дърво

Element.attachShadow() прикачва корен на Shadow DOM към поддържан елемент и връща ShadowRoot. Задължителният режим 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 = element.attachShadow({ mode: "open" });

Element.attachShadow() създава Shadow DOM дърво, свързано с хост елемент, и връща неговия ShadowRoot. Това е отделно дърво: възлите му не стават обикновени деца на хоста. Затова host.querySelector() не търси във вътрешността му; извикайте метода върху върнатия корен.

Опцията mode е задължителна. При "open" host.shadowRoot предоставя достъп до корена; при "closed" връща null. И в двата режима attachShadow() връща корена, така че запазена препратка все още позволява да го променяте. "closed" не защитава поверителни данни.

Не всеки елемент може да бъде хост: div се поддържа, но например input не се поддържа. Неподдържан хост или повторно прикачване към обикновен вече съществуващ корен причинява NotSupportedError. Съществуващ декларативен корен е изключение: съвпадащ mode позволява повторното му използване, но изчиства съдържанието му; различен режим причинява грешка.

Това е DOM API на браузъра, а не функция на конкретно издание на ECMAScript. Проверете typeof Element.prototype.attachShadow === "function" в целевия браузър; тази проверка не потвърждава поддръжката на всяка допълнителна опция. Наличието на Node 24 в хранилището не доказва поддръжка на този API.

Примери

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

Резултат

true
true
Hello

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

Източници