Objet XmlNode

L'objet XmlNode est le type de données de base de l'ensemble du DOM

Héritage

Attributs des membres

nodeType

Entier, renvoie le type de nœud du nœud

1
readonly Integer XmlNode.nodeType;

Le nodeType de différents objets renverra différentes valeurs :

• XmlElement: ELEMENT_NODE(1)
• XmlAttr: ATTRIBUT_NODE(2)
• XmlText: TEXT_NODE(3)
• XmlCDATASection: CDATA_SECTION_NODE(4)
• XmlProcessingInstruction: PROCESSING_INSTRUCTION_NODE(7)
• XmlComment: COMMENT_NODE(8)
• XmlDocument: DOCUMENT_NODE(9)
• XmlDocumentType: DOCUMENT_TYPE_NODE(10)

---

nodeName

String, renvoie le nom du nœud, selon son type

1
readonly String XmlNode.nodeName;

Le nodeName de différents objets renverra différentes valeurs :

• XmlElement: nom de l'élément
• XmlAttr: Nom de la propriété
• XmlText: #texte
• XmlCDATASection: #cdata-section
• XmlProcessingInstruction: Retour à la cible spécifiée
• XmlComment: #commenter
• XmlDocument: #document
• XmlDocumentType: nom du type de document

---

nodeValue

String, renvoie le nom du nœud, selon son type

1
String XmlNode.nodeValue;

Le nodeName de différents objets renverra différentes valeurs :

• XmlElement: nul
• XmlAttr: La valeur de l'attribut
• XmlText: Le contenu du nœud
• XmlCDATASection: Le contenu du nœud
• XmlProcessingInstruction: renvoie les données de contenu spécifiées
• XmlComment: texte du commentaire
• XmlDocument: nul
• XmlDocumentType: nul

---

ownerDocument

XmlDocument, Renvoie l'élément racine du nœud (XmlDocument Objet)

1
readonly XmlDocument XmlNode.ownerDocument;

---

parentNode

XmlNode, peut retourner le nœud parent d'un nœud

1
readonly XmlNode XmlNode.parentNode;

---

childNodes

XmlNodeList, Renvoie la liste des nœuds des nœuds enfants du nœud spécifié

1
readonly XmlNodeList XmlNode.childNodes;

---

firstChild

XmlNode, renvoie le premier nœud enfant du nœud

1
readonly XmlNode XmlNode.firstChild;

---

lastChild

XmlNode, renvoie le dernier nœud enfant du nœud

1
readonly XmlNode XmlNode.lastChild;

---

previousSibling

XmlNode, renvoie le nœud immédiatement avant un nœud (au même niveau d'arborescence), s'il n'y a pas de tel nœud, alors cet attribut renvoie null

1
readonly XmlNode XmlNode.previousSibling;

---

nextSibling

XmlNode, renvoie le nœud suivant immédiatement un élément (dans le même niveau d'arborescence), s'il n'y a pas un tel nœud, la propriété renvoie null

1
readonly XmlNode XmlNode.nextSibling;

Fonction membre

hasChildNodes

Demander s'il y a des nœuds enfants

1
Boolean XmlNode.hasChildNodes();

Résultat de retour :

• Boolean, Renvoie true s'il y a des nœuds enfants, sinon renvoie false

---

normalize

Fusionner les nœuds de texte adjacents et supprimer les nœuds de texte vides

1
XmlNode.normalize();

Cette méthode traversera tous les descendants du nœud actuel et normalisera le document en supprimant le nœud Text vide et en fusionnant tous les nœuds Text adjacents. Cette méthode est utile pour simplifier la structure de l'arborescence du document après l'insertion ou la suppression de nœuds.

---

cloneNode

Créer une copie exacte du nœud spécifié

1
XmlNode XmlNode.cloneNode(Boolean deep = true);

Paramètres d'appel :

• deep: booléen, s'il faut copier en profondeur, si vrai, le nœud cloné clonera tous les nœuds enfants du nœud d'origine

Résultat de retour :

• XmlNode, Renvoie le nœud copié

Cette méthode copiera et renverra une copie du nœud qui l'a appelée. Si le paramètre qui lui est passé est vrai, il copiera également de manière récursive tous les descendants du nœud actuel. Sinon, il ne copie que le nœud courant. Le nœud renvoyé n'appartient pas à l'arborescence du document et sa propriété parentNode est nulle. Lorsque le nœud Element est copié, tous ses attributs seront copiés.

---

lookupPrefix

Renvoie le préfixe correspondant à l'URI d'espace de noms spécifié sur le nœud actuel

1
String XmlNode.lookupPrefix(String namespaceURI);

Paramètres d'appel :

• namespaceURI: chaîne, spécifiez l'URI de l'espace de noms correspondant

Résultat de retour :

• String, Renvoie le préfixe correspondant, renvoie null s'il ne correspond pas

---

lookupNamespaceURI

Renvoie l'URI de l'espace de noms qui correspond au préfixe spécifié sur le nœud actuel

1
String XmlNode.lookupNamespaceURI(String prefix);

Paramètres d'appel :

• prefix: chaîne, spécifiez le préfixe correspondant

Résultat de retour :

• String, Renvoie l'URI de l'espace de noms correspondant, renvoie null s'il ne correspond pas

---

insertBefore

Insérer un nouveau nœud enfant avant le nœud enfant existant

1
2
XmlNode XmlNode.insertBefore(XmlNode newChild,
    XmlNode refChild);

Paramètres d'appel :

• newChild: XmlNode, insère un nouveau nœud
• refChild: XmlNode, insère un nouveau nœud avant ce nœud

Résultat de retour :

• XmlNode, Renvoie le nouveau nœud enfant

Si newChild existe déjà dans l'arborescence du document, il sera supprimé de l'arborescence du document, puis réinséré dans sa nouvelle position. Les nœuds d'un document (ou les nœuds créés par un document) ne peuvent pas être insérés dans un autre document. En d'autres termes, la propriété ownerDocument de newChild doit être la même que la propriété ownerDocument du nœud actuel.

---

insertAfter

Insérer un nouveau nœud enfant après le nœud enfant existant

1
2
XmlNode XmlNode.insertAfter(XmlNode newChild,
    XmlNode refChild);

Paramètres d'appel :

• newChild: XmlNode, insère un nouveau nœud
• refChild: XmlNode, insère un nouveau nœud après ce nœud

Résultat de retour :

• XmlNode, Renvoie le nouveau nœud enfant

Si newChild existe déjà dans l'arborescence du document, il sera supprimé de l'arborescence du document, puis réinséré dans sa nouvelle position. Les nœuds d'un document (ou les nœuds créés par un document) ne peuvent pas être insérés dans un autre document. En d'autres termes, la propriété ownerDocument de newChild doit être la même que la propriété ownerDocument du nœud actuel.

---

appendChild

Ajouter un nouveau nœud enfant à la fin de la liste des nœuds enfants du nœud

1
XmlNode XmlNode.appendChild(XmlNode newChild);

Paramètres d'appel :

• newChild: XmlNode, spécifiez le nœud ajouté

Résultat de retour :

• XmlNode, Renvoie ce nouveau nœud enfant

Si newChild existe déjà dans l'arborescence du document, il sera supprimé de l'arborescence du document, puis réinséré dans sa nouvelle position. Les nœuds d'un document (ou les nœuds créés par un document) ne peuvent pas être insérés dans un autre document. En d'autres termes, la propriété ownerDocument de newChild doit être la même que la propriété ownerDocument du nœud actuel.

---

replaceChild

Remplacer un nœud enfant par un autre

1
2
XmlNode XmlNode.replaceChild(XmlNode newChild,
    XmlNode oldChild);

Paramètres d'appel :

• newChild: XmlNode, spécifiez un nouveau nœud
• oldChild: XmlNode, spécifiez le nœud à remplacer

Résultat de retour :

• XmlNode, Si le remplacement réussit, cette méthode peut renvoyer le nœud remplacé, si le remplacement échoue, elle renvoie null

Si newChild existe déjà dans l'arborescence du document, il sera supprimé de l'arborescence du document, puis réinséré dans sa nouvelle position. Les nœuds d'un document (ou les nœuds créés par un document) ne peuvent pas être insérés dans un autre document. En d'autres termes, la propriété ownerDocument de newChild doit être la même que la propriété ownerDocument du nœud actuel.

---

removeChild

Supprimer un nœud de la liste des nœuds enfants

1
XmlNode XmlNode.removeChild(XmlNode oldChild);

Paramètres d'appel :

• oldChild: XmlNode, spécifiez le nœud à supprimer

Résultat de retour :

• XmlNode, Si la suppression réussit, cette méthode peut renvoyer le nœud supprimé, si elle échoue, elle renvoie null

---

toString

Renvoie la représentation sous forme de chaîne de l'objet, renvoie généralement "[Objet natif]", l'objet peut être ré-implémenté selon ses propres caractéristiques

1
String XmlNode.toString();

Résultat de retour :

• String, Renvoie la représentation sous forme de chaîne de l'objet

---

toJSON

Renvoie la représentation au format JSON de l'objet, renvoie généralement une collection d'attributs lisibles définis par l'objet

1
Value XmlNode.toJSON(String key = "");

Paramètres d'appel :

• key: chaîne, inutilisé

Résultat de retour :

• Value, Renvoie une valeur contenant JSON sérialisable