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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.