CKTIS / JavaScript
Element.after() — vložení sourozeneckých uzlů za element
Element.after vkládá uzly a text jako sourozence elementu, zpravidla bezprostředně za něj. Nepřidává tomuto elementu potomky.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.after(...nodes)Element.after je instanční metoda poskytovaná mixinem ChildNode ve standardu DOM, nikoli v ECMAScriptu. Pokud má element rodiče, element.after(...nodes) zpravidla vloží uzly a text bezprostředně za něj. Při přípravě uzlů ke vložení se ale může přesunout i samotný element, přestože není předán přímo jako argument. Je-li a jediným potomkem fragmentu DocumentFragment pojmenovaného f a b je samostatný element, volání a.after(b, f) přesune a z f na místo za b a poté oba elementy vloží do f v pořadí b, a. Pokud je argumentem i samotný element, záleží na jeho pozici v seznamu argumentů: mají-li dva různé elementy a a b stejného rodiče, a.after(b, a) umístí b bezprostředně před a.
Řetězce se převedou na uzly Text, aniž by se interpretovaly jako HTML. Existující uzly se přesunou, nezkopírují. Metoda vrací undefined; pokud element nemá rodiče, nic se nevloží. Rodič nemusí být připojený k dokumentu.
Neplatná hierarchie stromu způsobí HierarchyRequestError. Na rozdíl od append() metoda after() nevkládá potomky do elementu, na kterém je volána. Jde o API prostředí DOM: samotná verze Node.js nepotvrzuje jeho dostupnost.
Příklady
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);Výsledek
A / BC true true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zdokumentovanou pro tuto konkrétní verzi.