Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Element.after() — insérer des nœuds frères après un élément

Element.after insère des nœuds et du texte en tant que nœuds frères, généralement juste après l’élément. La méthode n’ajoute pas d’enfants à cet élément.

Version : 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 est une méthode d’instance fournie par le mixin ChildNode dans le standard DOM, et non par ECMAScript. Si l’élément a un parent, element.after(...nodes) insère généralement des nœuds et du texte juste après lui. Toutefois, la préparation des nœuds à insérer peut déplacer l’élément lui-même, même s’il n’est pas passé directement en argument. Si a est l’unique enfant d’un DocumentFragment nommé f et que b est un élément distinct qui ne fait pas partie de f, a.after(b, f) retire a de f et le place après b, puis insère les deux éléments dans f dans l’ordre b, a. Si l’élément lui-même est passé en argument, sa position dans la liste des arguments compte : si a et b sont deux éléments distincts ayant le même parent, a.after(b, a) place b juste avant a.

Les chaînes deviennent des nœuds Text sans être interprétées comme du HTML. Les nœuds existants sont déplacés, et non copiés. La méthode renvoie undefined ; si l’élément n’a pas de parent, elle n’insère rien. Le parent n’a pas besoin d’être connecté au document.

Une hiérarchie d’arbre non valide provoque HierarchyRequestError. Contrairement à append(), after() n’insère pas d’enfants dans l’élément sur lequel la méthode est appelée. Il s’agit d’une API de l’environnement DOM : la version de Node.js, à elle seule, ne permet pas d’établir sa disponibilité.

Exemples

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);

Résultat

A / BC
true
true
true

Le code présenté et le résultat indiqué ont été vérifiés dans un environnement isolé selon la méthode documentée pour cette version précise.

Sources