Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Element.append — pripájanie uzlov a textu

`Element.append` pridáva uzly a text na koniec elementu a vracia `undefined`. Ak sú `a` a `b` dva rôzne elementy, po úspešnom volaní `element.append(a, b, a)` je na konci najprv `b` a za ním `a`: pri poslednom výskyte `a` sa uzol presunie, nie skopíruje. Ak je však `a` fragment `DocumentFragment` s jediným textovým uzlom a `b` je samostatný element, prvý výskyt `a` umiestni textový uzol pred `b` a vyprázdni fragment. Posledný výskyt nič nepridá a samotný fragment sa nevloží.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

element.append(...nodes)

Element.append pochádza z mixinu ParentNode štandardu DOM, nie z ECMAScriptu. Pridáva nula alebo viac argumentov za posledného potomka elementu.

Reťazce sa menia na uzly Text, nie na HTML značky. Existujúci uzol sa presunie, nie skopíruje. DocumentFragment pridá svoje deti a vyprázdni sa.

Na rozdiel od appendChild prijíma append viacero argumentov vrátane textu a vracia undefined. Neplatná hierarchia, napríklad vloženie elementu do seba samého, spôsobí HierarchyRequestError.

Príklady

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);

Výsledok

Status: OK!
3
undefined

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje