Dom CORE : Objet Node.replaceChild

La méthode javascript replaceChild

Définition

La méthode javascript replaceChild(NewNoeud, NoeudRemplace) de l'objet Node permet de remplacer un noeud enfant.
Exemple de code :
var nouveauNoeud = objetNoeud.replaceChild(NewNoeud, NoeudRemplace);

Paramètres de replaceChild

Paramètres

La méthode javascript replaceChild(NewNoeud, NoeudRemplace) de l'objet Node accepte comme paramètres :
- NewNoeud objet Node, qui représente le nouveau noeud enfant à insérer.
- NoeudRemplace objet Node, qui représente le noeud enfant à remplacer.

Valeur retournée de replaceChild

Valeur retournée

La méthode replaceChild() de l'objet javascript Node renvoie un objet Node qui correspond au nouveau noeud enfant.

Exceptions de replaceChild

Exception

La méthode replaceChild() de l'objet javascript Node renvoie comme exceptions :
- HIERARCHY_REQUEST_ERR le noeud courant ne peut avoir un noeud enfant du type de "NewNoeud", ou si le noeud à insérer est l'un des ancêtres du noeud courant.
- WRONG_DOCUMENT_ERR le noeud "NewNoeud" a été créé dans un document autre que celui dans lequel le noeud courant a été créé.
- NO_MODIFICATION_ALLOWED_ERR le noeud courant est en lecture seule.
- NOT_FOUND_ERR : "NoeudRemplace" n'est pas un enfant du noeud courant.

Exemples de replaceChild

Exemple

Nous alons inserer une option à la place de Option 1.

Voici le code XML :
Exemple de code :
<select size="3" id="affiche">
  <option>Option 0</option>
  <option>Option 1</option>
</select>

Code javascript:
Exemple de code :
//Création du nouveau Noeud
var Nodenew = document.createElement("option");
var texte = document.createTextNode("option 2");
Nodenew.appendChild(texte);

//Recupération du Noeud "position"
var Node = document.getElementById("affiche");
var NodeListe = Node.getElementsByTagName("option");
var position = NodeListe.item(1);

//Insertion
Node.replaceChild(Nodenew,position);

Résultat :
Remplacer