element.appendChild

Résumé

Ajoute un nœud à la fin de la liste des enfants d'un nœud parent spécifié. Si le nœud existe déjà, il est retiré de son nœud parent actuel et ajouté au nouveau nœud parent.

Si le noeud existe déjà, Il est recommandé d'utiliser la méthode element.removeNode avant element.appendChild
(compatibilité : dolphin browser / OS Bada - device samsung s8500)

Syntaxe

var elementAjoute = element.appendChild(enfant);

• element est l'élément parent.
• enfant est le nœud à ajouter sous element.
• elementAjoute contiendra l'élément ajouté, soit enfant.

Exemple

// Crée un nouvel élément de paragraphe
var p = document.createElement("p");
// l'ajoute à la fin du corps du document
document.body.appendChild(p);

Notes

Si enfant fait référence à un nœud existant dans le document, appendChild le déplace de sa position actuelle à la nouvelle position (c'est-à-dire qu'il n'y a pas besoin de retirer le nœud de son nœud parent avant de l'ajouter à un autre nœud).

Cela signifie également qu'un nœud ne peut se trouver simultanément en deux points du document. Donc si un nœud a déjà un parent, il est d'abord retiré et ensuite ajouté à sa nouvelle position.

La méthode Node.cloneNode() peut être utilisée pour créer une copie du nœud avant de l'ajouter sous son nouveau parent. (Notez que les copies réalisées avec Node.cloneNode() ne resteront pas automatiquement synchronisées.)

appendChild est, avec document.createElement, l'une des méthodes fondamentales de la programmation Web utilisant le DOM. La méthode appendChild insère un nouveau nœud dans la structure DOM du document courant, et est la deuxième partie du processus en deux étapes (création et insertion) à la base de la construction programmatique de pages Web.

Spécification

• DOM Level 2 Core : appendChild — Traduction en français (non normative)

Voir également

• Node.removeChild
• Node.replaceChild
• Node.insertBefore
• Node.hasChildNodes