Skip to main content

Visit Mozilla.org

DOM:element.appendChild

Un article de MDC.

« Référence du DOM Gecko

Sommaire

[modifier] 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.

[modifier] Syntaxe 

var elementAjoute = element.appendChild(enfant);
  • element est l'élément parent.
  • enfant est le nœud à ajouter sous element.

[modifier] 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);

[modifier] 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 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 cloneNode ne resteront pas automatiquement synchronisées.)

Méthodes liées : insertBefore, replaceChild et removeChild.


[modifier] Spécification

Récupérée de « http://developer.mozilla.org/fr/docs/DOM:element.appendChild »