CKTIS / JavaScript
Element.after() — wstawianie rodzeństwa za elementem
Element.after wstawia węzły i tekst jako rodzeństwo elementu, zwykle bezpośrednio za nim. Nie dodaje dzieci do tego elementu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
element.after(...nodes)Element.after to metoda instancji udostępniana przez domieszkę ChildNode w standardzie DOM, a nie w ECMAScript. Jeśli element ma rodzica, wywołanie element.after(...nodes) zwykle wstawia węzły i tekst bezpośrednio za nim. Jednak przygotowanie węzłów do wstawienia może przenieść sam element, nawet jeśli nie podano go bezpośrednio jako argumentu. Jeśli a jest jedynym dzieckiem fragmentu DocumentFragment o nazwie f, a b jest osobnym elementem, wywołanie a.after(b, f) przenosi a z f na pozycję za b, a następnie wstawia oba elementy do f w kolejności b, a. Jeśli sam element jest argumentem, jego pozycja na liście argumentów ma znaczenie: dla dwóch różnych elementów a i b mających tego samego rodzica wywołanie a.after(b, a) umieszcza b bezpośrednio przed a.
Napisy stają się węzłami Text, bez parsowania HTML. Istniejące węzły są przenoszone, nie kopiowane. Metoda zwraca undefined; gdy element nie ma rodzica, niczego nie wstawia. Rodzic nie musi być podłączony do dokumentu.
Niedozwolona hierarchia drzewa powoduje HierarchyRequestError. W odróżnieniu od append(), after() nie wstawia dzieci do elementu, na którym wywołano metodę. To API środowiska DOM: sama wersja Node.js nie potwierdza jego dostępności.
Przykłady
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);Wynik
A / BC true true true
Pokazany kod i podany wynik zweryfikowano w odizolowanym środowisku metodą udokumentowaną dla tej konkretnej wersji.