CKTIS / JavaScript
Element.after() — Geschwister nach einem Element einfügen
Element.after fügt Knoten und Text als Geschwisterknoten ein, normalerweise unmittelbar nach dem Element. Es fügt diesem Element keine Kinder hinzu.
Version: 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 ist eine Instanzmethode, die im DOM-Standard durch das ChildNode-Mixin bereitgestellt wird, nicht durch ECMAScript. Hat das Element einen Elternknoten, fügt element.after(...nodes) Knoten und Text normalerweise unmittelbar nach dem Element ein. Beim Vorbereiten der einzufügenden Knoten kann das Element selbst jedoch verschoben werden, auch wenn es nicht direkt als Argument übergeben wird. Ist a das einzige Kind eines DocumentFragment namens f und ist b ein separates Element, so verschiebt a.after(b, f) das Element a aus f an die Position nach b und fügt dann beide in der Reihenfolge b, a in f ein. Wird das Element selbst als Argument übergeben, kommt es auf seine Position in der Argumentliste an: Sind a und b zwei verschiedene Elemente mit demselben Elternknoten, platziert a.after(b, a) das Element b unmittelbar vor a.
Zeichenfolgen werden ohne HTML-Parsing zu Text-Knoten. Vorhandene Knoten werden verschoben, nicht kopiert. Die Methode gibt undefined zurück; hat das Element keinen Elternknoten, wird nichts eingefügt. Der Elternknoten muss nicht mit dem Dokument verbunden sein.
Eine ungültige Baumhierarchie führt zu HierarchyRequestError. Anders als append() fügt after() keine Kinder in das Element ein, auf dem die Methode aufgerufen wird. Dies ist eine API der DOM-Umgebung: Die Node.js-Version allein belegt nicht, dass sie verfügbar ist.
Beispiele
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);Ergebnis
A / BC true true true
Der gezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der für genau diese Version dokumentierten Methode überprüft.