CKTIS / JavaScript
Element.after() — broers en zussen na een element invoegen
Element.after voegt knooppunten en tekst in als broers en zussen van het element, doorgaans direct erna. Het voegt geen kinderen toe aan dat element.
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.after(...nodes)Element.after is een instantiemethode die in de DOM-standaard wordt aangeboden door de ChildNode-mixin, niet door ECMAScript. Als het element een bovenliggend knooppunt heeft, voegt element.after(...nodes) knooppunten en tekst doorgaans direct na het element in. Bij het voorbereiden van de in te voegen knooppunten kan het element zelf echter worden verplaatst, ook als het niet rechtstreeks als argument is meegegeven. Als a het enige kind van een DocumentFragment met de naam f is en b een losstaand element is, haalt a.after(b, f) het element a uit f en plaatst het na b. Daarna voegt de methode beide in f in, in de volgorde b, a. Wordt het element zelf als argument meegegeven, dan maakt zijn plaats in de argumentenlijst uit: als a en b twee verschillende elementen met hetzelfde bovenliggende knooppunt zijn, plaatst a.after(b, a) het element b direct vóór a.
Tekenreeksen worden omgezet in Text-knooppunten zonder dat ze als HTML worden geïnterpreteerd. Bestaande knooppunten worden verplaatst, niet gekopieerd. De methode retourneert undefined; als het element geen bovenliggend knooppunt heeft, wordt er niets ingevoegd. Het bovenliggende knooppunt hoeft niet met het document verbonden te zijn.
Een ongeldige boomstructuur veroorzaakt HierarchyRequestError. In tegenstelling tot append() voegt after() geen kinderen toe aan het element waarop de methode wordt aangeroepen. Dit is een API van de DOM-omgeving: de Node.js-versie alleen bevestigt niet dat deze beschikbaar is.
Voorbeelden
const parent = document.createElement('div');
const first = document.createElement('span');
first.textContent = 'A';
const last = document.createElement('span');
last.textContent = 'C';
parent.append(first, last);
const middle = document.createElement('strong');
middle.textContent = 'B';
const result = first.after(' / ', middle);
console.log(parent.textContent);
console.log(first.nextSibling.nodeType === Node.TEXT_NODE);
console.log(middle.nextSibling === last);
console.log(result === undefined);Resultaat
A / BC true true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die voor precies deze versie is vastgelegd.