Element.append()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2018.
La méthode Element.append() ajoute un ensemble d'objets Node 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œuds Text.
Voici les différences entre Element.append() et Node.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'objetNodeajouté.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
js
append(param1);
append(param1, param2);
append(param1, param2, /* ... ,*/ paramN);
Paramètres
param1, …,paramN-
Un ensemble d'objets
Nodeou 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
js
let div = document.createElement("div");
let p = document.createElement("p");
div.append(p);
console.log(div.childNodes); // NodeList [ <p> ]
Ajouter du texte
js
let div = document.createElement("div");
div.append("Du texte");
console.log(div.textContent); // "Du texte"
Ajouter un élément et du texte
js
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 par with
La méthode append() n'est pas disponible dans la portée créée par une instruction with. Voir Symbol.unscopables pour plus d'informations.
js
let div = document.createElement("div");
with (div) {
append("toto");
}
// ReferenceError: append is not defined
Spécifications
| Specification |
|---|
| DOM # ref-for-dom-parentnode-append① |
Compatibilité des navigateurs
Chargement…