Méthode insertNode() XML DOM
Définition et utilisation
La méthode insertNode() insère un noeud à l'beginning de la plage.
Syntaxe :
insertNode(newNode)
paramètre
| paramètre | Description |
|---|---|
| newNode | les noeuds à insérer dans le document. |
lancer
si newNode s'il s'agit d'un noeud Attr, Document, Entity ou Notation, cette méthode déclenchera une exception de type INVALID_NODE_TYPE_ERR Exception RangeException.
sous les conditions suivantes, cette méthode déclenchera également l'exception DOMException suivante :
- HIERARCHY_REQUEST_ERR - Le point de départ de la plage contenant des noeuds ne peut pas avoir de sous-nœuds, il ne peut pas non plus avoir de sous-nœuds de type spécifié, ou newNode est un ancêtre de ce nœud (ou le nœud lui-même).
- NO_MODIFICATION_ALLOWED_ERR - Le nœud contenant le point de départ de la plage (ou l'un de ses ancêtres) est en lecture seule.
- WRONG_DOCUMENT_ERR - newNode différent de celui auquel appartient la plage.
Description
Cette méthode insérera le nœud spécifié (et tous ses descendants) au point de départ de la plage de document. Lorsque cette méthode est retournée, la plage actuelle inclura les nœuds insérés. Si newNode Déjà une partie du document, alors il sera supprimé de la position actuelle et réinséré au point de départ de la plage. Si newNode est Nœud DocumentFragmentalors l'insertion n'est pas elle-même, mais ses descendants, insérés en ordre du point de départ de la plage.
Si le nœud contenant le point de départ de la plage actuelle est un nœud Text, alors avant l'opération d'insertion, il sera divisé en deux nœuds adjacents. Si newNode C'est un nœud Text, après l'insertion dans le document, il ne sera pas fusionné avec tout autre nœud Text adjacent. Pour fusionner des nœuds adjacents, il est nécessaire de faire appel à Node.normalize() Méthode.
