Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri