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.