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

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

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

Източници