Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

ShadowRoot.append — dodawanie węzłów i tekstu do drzewa cienia

ShadowRoot.append dodaje węzły i tekst na końcu drzewa cienia. Jest metodą odziedziczoną po DocumentFragment, a nie osobną implementacją. Poznaj przenoszenie węzłów, opróżnianie fragmentu i różnicę względem appendChild().

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

shadowRoot.append(...nodesOrStrings);
fragment.append(...nodesOrStrings);

ShadowRoot.append to odziedziczona metoda DocumentFragment.append: ShadowRoot dziedziczy po DocumentFragment. Wywołanie root.append(...) dodaje zawartość po ostatnim dziecku korzenia cienia, a nie do zwykłych dzieci elementu gospodarza. Zwykły fragment służy natomiast do składania poddrzewa przed wstawieniem go w docelowe miejsce.

Metoda przyjmuje wiele węzłów i ciągów znaków w podanej kolejności. Ciągi stają się węzłami Text, nie są parsowane jako HTML. Istniejący węzeł zostaje przeniesiony, nie skopiowany. Przekazanie zwykłego DocumentFragment przenosi jego dzieci i pozostawia fragment pusty; sam fragment nie staje się dzieckiem korzenia.

Wynikiem jest undefined. W odróżnieniu od append(), appendChild() przyjmuje jeden węzeł, nie obsługuje bezpośrednio tekstowych argumentów i zwraca dodany węzeł albo opróżniony fragment. Nieprawidłowe wstawienie, na przykład powodujące cykl, może zgłosić HierarchyRequestError typu DOMException.

To interfejs DOM, nie funkcja konkretnej edycji ECMAScript. MDN oznacza DocumentFragment.append() jako szeroko dostępne między przeglądarkami od kwietnia 2018; użycie na korzeniu cienia wymaga również obsługi Shadow DOM. Sama obecność Node 24 w repozytorium nie potwierdza obsługi tych interfejsów przeglądarkowych.

Przykłady

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

Wynik

Hello DOM!
3
0
true
0
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła