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.