CKTIS / JavaScript
ShadowRoot.append — добавяне на възли и текст към shadow дърво
ShadowRoot.append добавя възли и текст в края на shadow дърво. Методът се наследява от DocumentFragment и не е отделна реализация. Научете как се преместват възли, как фрагментът се изпразва и каква е разликата спрямо appendChild().
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
shadowRoot.append(...nodesOrStrings);
fragment.append(...nodesOrStrings);ShadowRoot.append е наследеният метод DocumentFragment.append: ShadowRoot наследява от DocumentFragment. Извикването root.append(...) добавя съдържание след последното дете на shadow корена, а не сред обикновените деца на хост елемента. Обикновеният фрагмент служи за сглобяване на поддърво, преди то да бъде вмъкнато на целевото място.
Методът приема множество възли и низове в реда на аргументите. Низовете стават възли Text; не се парсват като HTML. Съществуващ възел се премества, а не се копира. Подаването на обикновен DocumentFragment премества децата му и оставя фрагмента празен; самият фрагмент не става дете на корена.
Резултатът е undefined. За разлика от append(), appendChild() приема един възел, не поддържа директно низове като аргументи и връща добавения възел или изпразнения фрагмент. Невалидно вмъкване, например такова, което създава цикъл, може да предизвика DOMException HierarchyRequestError.
Това е DOM API, а не функция на конкретно издание на ECMAScript. MDN отбелязва DocumentFragment.append() като широко достъпен в браузърите от април 2018 г.; използването му върху shadow корен изисква и поддръжка на Shadow DOM. Самото наличие на Node 24 в хранилище не доказва поддръжка на тези браузърни API.
Примери
(() => {
const host = document.createElement("div");
const root = host.attachShadow({ mode: "open" });
const fragment = document.createDocumentFragment();
const label = document.createElement("strong");
label.textContent = "DOM";
fragment.append("Hello ", label);
const result = root.append(fragment, "!");
console.log(root.textContent);
console.log(root.childNodes.length);
console.log(fragment.childNodes.length);
console.log(label.parentNode === root);
console.log(host.childNodes.length);
console.log(result === undefined);
})();Резултат
Hello DOM! 3 0 true 0 true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.