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

CKTIS / JavaScript

Element.append — ajouter des nœuds et du texte

`Element.append` ajoute des nœuds et du texte à la fin d’un élément et renvoie `undefined`. Si `a` et `b` sont deux éléments distincts, après un appel réussi à `element.append(a, b, a)`, on trouve à la fin `b` suivi de `a` : la dernière occurrence de `a` déplace le nœud au lieu de le copier. Si, en revanche, `a` est un `DocumentFragment` qui contient un seul nœud texte et que `b` est un élément séparé, la première occurrence de `a` place le nœud texte avant `b` et vide le fragment. La dernière occurrence n’ajoute rien, et le fragment lui-même n’est pas inséré.

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.append(...nodes)

Element.append provient du mixin ParentNode du standard DOM, et non d’ECMAScript. La méthode ajoute zéro ou plusieurs arguments après le dernier enfant de l’élément.

Les chaînes deviennent des nœuds Text, et non du code HTML. Un nœud existant est déplacé, pas copié. Un DocumentFragment ajoute ses enfants et devient vide.

Contrairement à appendChild, append accepte plusieurs arguments, y compris du texte, et renvoie undefined. Une hiérarchie non valide, par exemple l’insertion d’un élément dans lui-même, provoque HierarchyRequestError.

Exemples

const box = document.createElement('div');
const label = document.createElement('span');
label.textContent = 'OK';
const result = box.append('Status: ', label, '!');
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(result);

Résultat

Status: OK!
3
undefined

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources