CKTIS / JavaScript
Element.append — dodavanje čvorova i teksta
`Element.append` dodaje čvorove i tekst na kraj elementa i vraća `undefined`. Ako su `a` i `b` različiti elementi, nakon uspješnog poziva `element.append(a, b, a)` na kraju se nalazi najprije `b`, a zatim `a`: pri posljednjem pojavljivanju `a` čvor se premješta, a ne kopira. Ako je pak `a` fragment `DocumentFragment` s jednim tekstnim čvorom, a `b` zaseban element, pri prvom pojavljivanju `a` tekstni se čvor smješta ispred `b`, a fragment se prazni. Pri posljednjem pojavljivanju ništa se ne dodaje, a sam se fragment ne umeće.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
element.append(...nodes)Element.append potječe iz mixina ParentNode standarda DOM, a ne iz ECMAScripta. Dodaje nula ili više argumenata nakon posljednjeg djeteta elementa.
Nizovi znakova postaju čvorovi Text, a ne HTML oznake. Postojeći se čvor premješta, ne kopira. DocumentFragment dodaje svoju djecu i pritom se prazni.
Za razliku od appendChild, append prihvaća više argumenata, uključujući tekst, i vraća undefined. Nevaljana hijerarhija, primjerice umetanje elementa u samoga sebe, uzrokuje HierarchyRequestError.
Primjeri
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);Rezultat
Status: OK! 3 undefined
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.