Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.append — dodawanie węzłów i tekstu

`Element.append` dodaje węzły i tekst na końcu elementu i zwraca `undefined`. Jeśli `a` i `b` są różnymi elementami, po udanym wywołaniu `element.append(a, b, a)` na końcu znajdą się `b`, a po nim `a`: ostatnie wystąpienie `a` przenosi ten węzeł, zamiast go kopiować. Jeśli natomiast `a` jest `DocumentFragment` zawierającym jeden węzeł tekstowy, a `b` jest osobnym elementem, pierwsze wystąpienie `a` przenosi węzeł tekstowy przed `b` i opróżnia fragment. Ostatnie wystąpienie niczego nie dodaje, a sam fragment nie jest wstawiany.

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

element.append(...nodes)

Element.append pochodzi z miksinu ParentNode standardu DOM, nie z ECMAScript. Dodaje zero lub więcej argumentów po ostatnim dziecku elementu.

Ciągi znaków stają się węzłami Text, a nie kodem HTML. Istniejący węzeł zostaje przeniesiony, nie skopiowany. DocumentFragment przekazuje swoje dzieci i zostaje opróżniony.

W przeciwieństwie do appendChild, append przyjmuje wiele argumentów, w tym tekst, i zwraca undefined. Niedozwolona hierarchia, np. wstawienie elementu do niego samego, powoduje HierarchyRequestError.

Przykłady

const box = document.createElement('div');
const label = document.createElement('span');
label.textContent = 'OK';
const result = box.append('Status: ', label, '!');
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(result);

Wynik

Status: OK!
3
undefined

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

Źródła