La méthodeElement.append() ajoute un ensemble d'objetsNode ou de chaînes de caractères après le dernier enfant d'Element. Les chaînes de caractères sont insérées comme des nœudsText.

Voici les différences entreElement.append() etNode.appendChild() :

• Element.append() permet d'ajouter des chaînes de caractères tandis queNode.appendChild() accepte uniquement les objetsNode.
• Element.append() n'a pas de valeur de retour alors queNode.appendChild() renvoie l'objetNode ajouté.
• Element.append() permet d'ajouter plusieurs nœuds et chaînes de caractères tandis queNode.appendChild() ne permet d'ajouter qu'un seul nœud.

Syntaxe

append(param1);append(param1, param2);append(param1, param2, /* ... ,*/ paramN);

Paramètres

param1, …,paramN

Un ensemble d'objetsNode ou de chaînes de caractères à insérer.

Exceptions

DOMExceptionHierarchyRequestError

Levée lorsque le nœud ne peut être inséré à l'emplacement indiqué dans la hiérarchie.

Exemples

Ajouter un élément

let div = document.createElement("div");let p = document.createElement("p");div.append(p);console.log(div.childNodes); // NodeList [ <p> ]

Ajouter du texte

let div = document.createElement("div");div.append("Du texte");console.log(div.textContent); // "Du texte"

Ajouter un élément et du texte

let div = document.createElement("div");let p = document.createElement("p");div.append("Du texte", p);console.log(div.childNodes); // NodeList [ #text "Du texte", <p> ]

append() est hors de la portée créée parwith

La méthodeappend() n'est pas disponible dans la portée créée par une instructionwith. VoirSymbol.unscopables pour plus d'informations.

let div = document.createElement("div");with (div) {  append("toto");}// ReferenceError: append is not defined

Spécifications

Compatibilité des navigateurs

Voir aussi

• Element.prepend()
• Node.appendChild()
• Element.after()
• Element.insertAdjacentElement()
• NodeList