Dom CORE : Objet Node.insertBefore

La méthode javascript insertBefore

Définition

La méthode javascript insertBefore(newNoeud,Position) de l'objet Node permet d'insérer un noeud enfant avant un autre noeud enfant.
Exemple de code :
ObjetNode.insertBefore(NewNode,NodePosition);

Paramètres de insertBefore

Paramètres

La méthode insertBefore(newNoeud,Position) javascript de l'objet Node accepte comme paramètres:
- newNoeud, objet Node ou objet DocumentFragment, il représente le nouveau noeud à insérer.
- Position objet Node, il représente le noeud enfant avant lequel on doit insérer newNoeud.
Peut prendre la valeur de null dans ce cas newNoeud est insérer à la fin des noeuds enfants.

Valeur retournée de insertBefore

Valeur retournée

La méthode javascript insertBefore() de l'objet Node renvoie le noeud inséré.

Exceptions de insertBefore

Exceptions

La méthode javascript insertBefore() de l'objet Node renvoie comme exceptions :
- HIERARCHY_REQUEST_ERR le noeud courant est d'un type n'admettant pas 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 "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 "Position" n'est pas un enfant du noeud courant.

Exemples de insertBefore

Exemple

Nous alons inserer une option avant 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.insertBefore(Nodenew,position);

Avant |Après