Objet objet intégré

Objet XmlElement

Les objets XmlElement représentent des éléments dans des documents XML

Héritage

#lineWidth: 1.5 #font: Helvetica,sans-Serif #fontSize: 10 #leading: 1.6 #.this: fill=lightgray #.class: fill=white [<class>object|toString();toJSON()] [<class>XmlNode|nodeType;nodeName;nodeValue;ownerDocument;parentNode;childNodes;firstChild;lastChild;previousSibling;nextSibling|hasChildNodes();normalize();cloneNode();lookupPrefix();lookupNamespaceURI();insertBefore();insertAfter();appendChild();replaceChild();removeChild()] [<this>XmlElement|namespaceURI;prefix;localName;tagName;id;textContent;innerHTML;className;attributes|getAttribute();getAttributeNS();setAttribute();setAttributeNS();removeAttribute();removeAttributeNS();hasAttribute();hasAttributeNS();getElementsByTagName();getElementsByTagNameNS();getElementById();getElementsByClassName()] [object] <:- [XmlNode] [XmlNode] <:- [XmlElement] XmlNode nodeType nodeName nodeValue ownerDocument parentNode childNodes firstChild lastChild previousSibling nextSibling hasChildNodes() normalize() cloneNode() lookupPrefix() lookupNamespaceURI() insertBefore() insertAfter() appendChild() replaceChild() removeChild() XmlElement namespaceURI prefix localName tagName id textContent innerHTML className attributes getAttribute() getAttributeNS() setAttribute() setAttributeNS() removeAttribute() removeAttributeNS() hasAttribute() hasAttributeNS() getElementsByTagName() getElementsByTagNameNS() getElementById() getElementsByClassName() object toString() toJSON()

Attributs des membres

namespaceURI

String, l'URI de l'espace de noms de l'élément de requête. Si le nœud sélectionné n'a pas d'espace de noms, cet attribut renvoie NULL

1
readonly String XmlElement.namespaceURI;

prefix

Chaîne, requête et définition du préfixe d'espace de noms de l'élément. Si le nœud sélectionné n'a pas d'espace de noms, cet attribut renvoie NULL

1
String XmlElement.prefix;

localName

String, le nom local de l'élément de requête. Si le nœud sélectionné n'a pas d'espace de noms, cet attribut est équivalent à nodeName

1
readonly String XmlElement.localName;

tagName

String, renvoie le nom de la balise de l'élément

1
readonly String XmlElement.tagName;

id

Chaîne, requête et définition de l'attribut id de l'élément

1
String XmlElement.id;

textContent

Chaîne, requête et définition du texte de l'élément sélectionné. Lors de l'interrogation, retournez les valeurs de tous les nœuds de texte dans le nœud d'élément ; lors de la définition, supprimez tous les nœuds enfants et remplacez-les par un seul nœud de texte.

1
String XmlElement.textContent;

innerHTML

Chaîne, requête et définition du texte HTML de l'élément sélectionné, valide uniquement en mode html. Lors de l'interrogation, renvoyez le code HTML de tous les nœuds enfants dans le nœud d'élément ; lors de la configuration, supprimez tous les nœuds enfants et remplacez-les par le code HTML spécifié après le décodage.

1
String XmlElement.innerHTML;

className

Chaîne, requête et définition de l'attribut class de l'élément, valide uniquement en mode html

1
String XmlElement.className;

attributes

XmlNamedNodeMap, Renvoie le NamedNodeMap contenant les attributs du nœud sélectionné. Si le nœud sélectionné n'est pas un élément, cet attribut renvoie NULL.

1
readonly XmlNamedNodeMap XmlElement.attributes;

nodeType

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

1
readonly Integer XmlElement.nodeType;

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


nodeName

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

1
readonly String XmlElement.nodeName;

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


nodeValue

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

1
String XmlElement.nodeValue;

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


ownerDocument

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

1
readonly XmlDocument XmlElement.ownerDocument;

parentNode

XmlNode, Peut renvoyer le nœud parent d'un nœud

1
readonly XmlNode XmlElement.parentNode;

childNodes

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

1
readonly XmlNodeList XmlElement.childNodes;

firstChild

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

1
readonly XmlNode XmlElement.firstChild;

lastChild

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

1
readonly XmlNode XmlElement.lastChild;

previousSibling

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

1
readonly XmlNode XmlElement.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 de tel nœud, la propriété renvoie null

1
readonly XmlNode XmlElement.nextSibling;

Fonction membre

getAttribute

Interroger la valeur d'un attribut par nom

1
String XmlElement.getAttribute(String name);

Paramètres d'appel :

  • name: String, spécifiez le nom de propriété de la requête

Résultat de retour :

  • String, Renvoie la valeur de l'attribut

getAttributeNS

Obtenir la valeur de l'attribut par l'URI et le nom de l'espace de noms

1 2
String XmlElement.getAttributeNS(String namespaceURI, String localName);

Paramètres d'appel :

  • namespaceURI: chaîne, spécifiez l'URI de l'espace de noms de la requête
  • localName: String, spécifiez le nom de propriété de la requête

Résultat de retour :

  • String, Renvoie la valeur de l'attribut

setAttribute

Créer ou modifier une nouvelle propriété

1 2
XmlElement.setAttribute(String name, String value);

Paramètres d'appel :

  • name: String, spécifiez le nom de la propriété à définir
  • value: chaîne, spécifiez la valeur de l'attribut à définir

Cette méthode définit l'attribut spécifié sur la valeur spécifiée. S'il n'y a pas d'attribut avec le nom spécifié, la méthode créera un nouvel attribut


setAttributeNS

Créer ou modifier des attributs avec un espace de noms

1 2 3
XmlElement.setAttributeNS(String namespaceURI, String qualifiedName, String value);

Paramètres d'appel :

  • namespaceURI: chaîne, spécifiez l'URI de l'espace de noms à définir
  • qualifiedName: String, spécifiez le nom de la propriété à définir
  • value: chaîne, spécifiez la valeur de l'attribut à définir

Cette méthode est similaire à la méthode setAttribute, sauf que l'attribut à créer ou à définir est spécifié par l'URI de l'espace de noms et le nom qualifié (constitué du préfixe de l'espace de noms, des deux-points et du nom local dans l'espace de noms). En plus de modifier la valeur d'un attribut, l'utilisation de cette méthode peut également modifier le préfixe d'espace de noms de l'attribut


removeAttribute

Supprimer l'attribut spécifié par son nom

1
XmlElement.removeAttribute(String name);

Paramètres d'appel :

  • name: String, spécifiez le nom de l'attribut supprimé

removeAttributeNS

Supprimer les attributs spécifiés par espace de noms et nom

1 2
XmlElement.removeAttributeNS(String namespaceURI, String localName);

Paramètres d'appel :

  • namespaceURI: chaîne, spécifiez l'URI de l'espace de noms à supprimer
  • localName: String, spécifiez le nom de l'attribut supprimé

hasAttribute

Demande si le nœud actuel a un attribut avec le nom spécifié

1
Boolean XmlElement.hasAttribute(String name);

Paramètres d'appel :

  • name: String, spécifiez le nom de l'attribut de la requête

Résultat de retour :

  • Boolean, Si le nœud de l'élément actuel a l'attribut spécifié, il renvoie true, sinon il renvoie false

hasAttributeNS

Demander si le nœud actuel a des attributs de l'espace de noms et du nom spécifiés

1 2
Boolean XmlElement.hasAttributeNS(String namespaceURI, String localName);

Paramètres d'appel :

  • namespaceURI: chaîne, spécifiez l'URI de l'espace de noms à interroger
  • localName: String, spécifiez le nom de l'attribut de la requête

Résultat de retour :

  • Boolean, Si le nœud de l'élément actuel a l'attribut spécifié, il renvoie true, sinon il renvoie false

getElementsByTagName

Renvoie tous les éléments portant le nom spécifié XmlNodeList

1
XmlNodeList XmlElement.getElementsByTagName(String tagName);

Paramètres d'appel :

  • tagName: String, le nom de la balise à récupérer. La valeur "*" correspond à toutes les balises

Résultat de retour :

  • XmlNodeList, du nœud XmlElement avec la marque spécifiée dans l'arborescence des nœuds XmlNodeListrassembler. L'ordre des nœuds d'éléments renvoyés est l'ordre dans lequel ils apparaissent dans le document source.

Cette méthode traversera les descendants de l'élément spécifié et retournera un nœud XmlElement XmlNodeListObjet, ce qui signifie tous les éléments du document avec le nom de balise spécifié. L'ordre des éléments dans le tableau renvoyé est l'ordre dans lequel ils apparaissent dans le code source du document.

XmlDocument L'interface définit également la méthode getElementsByTagName, qui est similaire à cette méthode, mais traverse l'intégralité du document au lieu de parcourir les descendants d'un élément.


getElementsByTagNameNS

Renvoie tous les éléments avec l'espace de noms et le nom spécifiés XmlNodeList

1 2
XmlNodeList XmlElement.getElementsByTagNameNS(String namespaceURI, String localName);

Paramètres d'appel :

  • namespaceURI: chaîne, spécifiez l'URI de l'espace de noms à interroger
  • localName: String, le nom de la balise à récupérer. La valeur "*" correspond à toutes les balises

Résultat de retour :

  • XmlNodeList, du nœud XmlElement avec la marque spécifiée dans l'arborescence des nœuds XmlNodeListrassembler. L'ordre des nœuds d'éléments renvoyés est l'ordre dans lequel ils apparaissent dans le document source.

Cette méthode est similaire à la méthode getElementsByTagName, sauf que le nom de balise de l'élément que vous souhaitez obtenir est spécifié comme une combinaison de l'URI de l'espace de noms et du nom local défini dans l'espace de noms.


getElementById

Renvoie l'élément avec l'attribut id spécifié

1
XmlElement XmlElement.getElementById(String id);

Paramètres d'appel :

  • id: chaîne, identifiant à récupérer

Résultat de retour :

  • XmlElement, nœud XmlElement avec l'attribut id spécifié dans l'arborescence des nœuds

Cette méthode traversera les nœuds descendants de l'élément spécifié et retournera un objet nœud XmlElement représentant le premier élément de document avec l'attribut id spécifié. .

XmlDocument L'interface définit également la méthode getElementsByTagName, qui est similaire à cette méthode, mais traverse l'intégralité du document au lieu de parcourir les descendants d'un élément.


getElementsByClassName

Renvoie une liste de nœuds de tous les éléments avec le nom de classe spécifié

1
XmlNodeList XmlElement.getElementsByClassName(String className);

Paramètres d'appel :

  • className: String, le nom de la classe à récupérer

Résultat de retour :

  • XmlNodeList, Le nœud XmlElement avec le nom de classe spécifié dans l'arborescence du document XmlNodeListrassembler. L'ordre des nœuds d'éléments renvoyés est l'ordre dans lequel ils apparaissent dans le document source.

Cette méthode renverra un XmlNodeList Objet (peut être traité comme un tableau en lecture seule). Cet objet stocke tous les nœuds XmlElement avec le nom de classe spécifié dans le document. L'ordre dans lequel ils sont stockés correspond à l'ordre dans lequel ils apparaissent dans le document source. XmlNodeList L'objet est "live", c'est-à-dire que si un élément avec le nom de balise spécifié est ajouté ou supprimé dans le document, son contenu sera automatiquement mis à jour si nécessaire.


hasChildNodes

Demander s'il y a des nœuds enfants

1
Boolean XmlElement.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
XmlElement.normalize();

Cette méthode traversera tous les nœuds 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 XmlElement.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 :

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 XmlElement.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 XmlElement.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 XmlElement.insertBefore(XmlNode newChild, XmlNode refChild);

Paramètres d'appel :

  • newChild: XmlNode, Insérer un nouveau nœud
  • refChild: XmlNode, Insérer 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 XmlElement.insertAfter(XmlNode newChild, XmlNode refChild);

Paramètres d'appel :

  • newChild: XmlNode, Insérer un nouveau nœud
  • refChild: XmlNode, Insérer 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 XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.toJSON(String key = "");

Paramètres d'appel :

  • key: chaîne, inutilisé

Résultat de retour :

  • Value, Renvoie une valeur contenant JSON sérialisable