CKTIS / JavaScript
Element.append — dodajanje vozlišč in besedila
`Element.append` doda vozlišča in besedilo na konec elementa ter vrne `undefined`. Če sta `a` in `b` različna elementa, sta po uspešnem klicu `element.append(a, b, a)` na koncu najprej `b` in nato `a`: ob zadnji pojavitvi `a` se vozlišče premakne, ne kopira. Če pa je `a` fragment `DocumentFragment` z enim samim besedilnim vozliščem in je `b` ločen element, se ob prvi pojavitvi `a` besedilno vozlišče postavi pred `b`, fragment pa se izprazni. Ob zadnji pojavitvi se nič ne doda, sam fragment pa se ne vstavi.
Različica: 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 izvira iz mešanice ParentNode standarda DOM, ne iz ECMAScripta. Doda nič ali več argumentov za zadnjim otrokom elementa.
Nizi postanejo vozlišča Text, ne oznake HTML. Obstoječe vozlišče se premakne, ne kopira. DocumentFragment doda svoje otroke in se izprazni.
V nasprotju z appendChild metoda append sprejme več argumentov, tudi besedilo, in vrne undefined. Neveljavna hierarhija, na primer vstavljanje elementa vase, povzroči HierarchyRequestError.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.