CKTIS / JavaScript
Element.append — knooppunten en tekst toevoegen
`Element.append` voegt knooppunten en tekst toe aan het einde van een element en geeft `undefined` terug. Als `a` en `b` verschillende elementen zijn, staan na een geslaagde aanroep van `element.append(a, b, a)` achteraan `b` en daarna `a`: bij de laatste vermelding van `a` wordt het knooppunt verplaatst in plaats van gekopieerd. Is `a` daarentegen een `DocumentFragment` met één tekstknooppunt en is `b` een apart element, dan komt het tekstknooppunt bij de eerste vermelding van `a` vóór `b` te staan en raakt het fragment leeg. De laatste vermelding voegt niets toe en het fragment zelf wordt niet ingevoegd.
Versie: 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 komt uit de ParentNode-mixin van de DOM-standaard, niet uit ECMAScript. De methode voegt nul of meer argumenten toe na het laatste onderliggende knooppunt van het element.
Tekenreeksen worden Text-knooppunten, geen HTML-opmaak. Een bestaand knooppunt wordt verplaatst, niet gekopieerd. Een DocumentFragment voegt zijn onderliggende knooppunten toe en wordt leeg.
In tegenstelling tot appendChild accepteert append meerdere argumenten, waaronder tekst, en geeft het undefined terug. Een ongeldige hiërarchie, zoals een element in zichzelf invoegen, veroorzaakt HierarchyRequestError.
Voorbeelden
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);Resultaat
Status: OK! 3 undefined
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.