ObjetXmlElement
Les objets XmlElement représentent des éléments dans un document XML
relation d'héritage
propriétés des membres
namespaceURI
Chaîne, 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, cette propriété renvoie NULL
1readonly String XmlElement.namespaceURI;
prefix
Chaîne, interrogez et définissez le préfixe d'espace de noms de l'élément. Si le nœud sélectionné n'a pas d'espace de noms, cette propriété renvoie NULL
1String 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, cette propriété est équivalente à nodeName
1readonly String XmlElement.localName;
tagName
String, renvoie le nom de la balise de l'élément
1readonly String XmlElement.tagName;
id
Chaîne, requête et définition de l'attribut id de l'élément
1String XmlElement.id;
innerHTML
Chaîne, interroge et définit le texte HTML des descendants de l'élément sélectionné, valable uniquement en mode html. Lors de l'interrogation, renvoie le codage HTML de tous les nœuds enfants dans le nœud de l'élément ; lors de la configuration, supprimez tous les nœuds enfants et remplacez-les par le décodage HTML spécifié.
1String XmlElement.innerHTML;
outerHTML
String, interroge le texte HTML de l'élément sélectionné et de ses descendants, valable uniquement en mode html. Lors de l'interrogation, renvoie le codage HTML de l'élément et de tous les nœuds enfants du nœud.
1readonly String XmlElement.outerHTML;
className
Chaîne, interrogez et définissez l'attribut de classe de l'élément, valable uniquement en mode HTML
1String XmlElement.className;
attributes
XmlNamedNodeMap, renvoie un NamedNodeMap contenant les attributs du nœud sélectionné. Si le nœud sélectionné n'est pas un élément, cette propriété renvoie NULL.
1readonly XmlNamedNodeMap XmlElement.attributes;
nodeType
Entier, renvoie le type de nœud du nœud
1readonly Integer XmlElement.nodeType;
Le nodeType de différents objets renverra différentes valeurs :
- XmlElement: ELEMENT_NODE(1)
- XmlAttr:ATTRIBUTE_NODE(2)
- XmlText: TEXTE_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
1readonly String XmlElement.nodeName;
Le nodeName de différents objets renverra différentes valeurs :
- XmlElement:nom de l'élément
- XmlAttr: Nom d'attribut
- XmlText: #texte
- XmlCDATASection: #cdata-section
- XmlProcessingInstruction: Renvoie la cible cible spécifiée
- XmlComment: #commentaire
- XmlDocument: #document
- XmlDocumentType: nom du type de document
nodeValue
String, renvoie le nom du nœud, selon son type
1String XmlElement.nodeValue;
Le nodeName de différents objets renverra différentes valeurs :
- XmlElement: nul
- XmlAttr: valeur d'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 d'annotation
- XmlDocument: nul
- XmlDocumentType: nul
ownerDocument
XmlDocument, renvoie l'élément racine du nœud (XmlDocumentobjet)
1readonly XmlDocument XmlElement.ownerDocument;
parentNode
XmlNode, peut renvoyer le nœud parent d'un nœud
1readonly XmlNode XmlElement.parentNode;
childNodes
XmlNodeList, renvoie la liste des nœuds enfants du nœud spécifié
1readonly XmlNodeList XmlElement.childNodes;
children
XmlNodeList, renvoie la liste des nœuds des éléments enfants du nœud spécifié.
1readonly XmlNodeList XmlElement.children;
firstChild
XmlNode, renvoie le premier nœud enfant du nœud
1readonly XmlNode XmlElement.firstChild;
lastChild
XmlNode, renvoie le dernier nœud enfant du nœud
1readonly XmlNode XmlElement.lastChild;
previousSibling
XmlNode, renvoie le nœud précédant immédiatement un nœud (au même niveau d'arborescence). S'il n'existe pas de tel nœud, cette propriété renvoie null.
1readonly XmlNode XmlElement.previousSibling;
nextSibling
XmlNode, renvoie le nœud qui suit immédiatement un élément (dans le même niveau d'arborescence). S'il n'existe pas de tel nœud, l'attribut renvoie null.
1readonly XmlNode XmlElement.nextSibling;
firstElementChild
XmlNode, renvoie le premier nœud d'élément enfant du nœud
1readonly XmlNode XmlElement.firstElementChild;
lastElementChild
XmlNode, renvoie le dernier nœud d'élément enfant du nœud
1readonly XmlNode XmlElement.lastElementChild;
previousElementSibling
XmlNode, renvoie le nœud d'élément précédant immédiatement un nœud (au même niveau d'arborescence). S'il n'existe pas de nœud de ce type, cette propriété renvoie null.
1readonly XmlNode XmlElement.previousElementSibling;
nextElementSibling
XmlNode, renvoie le nœud d'élément qui suit immédiatement un élément (dans le même niveau d'arborescence). S'il n'existe pas de tel nœud, l'attribut renvoie null.
1readonly XmlNode XmlElement.nextElementSibling;
textContent
String, interroge et définit le texte de l'élément sélectionné. Lors de l'interrogation, renvoie les valeurs de tous les nœuds de texte dans le nœud d'élément ; lors de la configuration, supprime tous les nœuds enfants et les remplace par un seul nœud de texte.
1String XmlElement.textContent;
fonction membre
getAttribute
Interroger la valeur d'un attribut par son nom
1String XmlElement.getAttribute(String name);
Paramètres d'appel :
- name: String, spécifie le nom de l'attribut de la requête
Résultats de retour :
- String, renvoie la valeur de l'attribut
getAttributeNS
Obtenir la valeur de l'attribut par URI et nom de l'espace de noms
1
2String XmlElement.getAttributeNS(String namespaceURI,
String localName);
Paramètres d'appel :
- namespaceURI: Chaîne, spécifiant l'URI de l'espace de noms de la requête
- localName: String, spécifie le nom de l'attribut de la requête
Résultats de retour :
- String, renvoie la valeur de l'attribut
setAttribute
Créer ou modifier une nouvelle propriété
1
2XmlElement.setAttribute(String name,
String value);
Paramètres d'appel :
- name: String, spécifie le nom de l'attribut à définir
- value: String, spécifie la valeur d'attribut à définir
Cette méthode définit la propriété spécifiée sur la valeur spécifiée. Si une propriété portant le nom spécifié n'existe pas, cette méthode crée une nouvelle propriété
setAttributeNS
Créer ou modifier des propriétés d'espace de noms
1
2
3XmlElement.setAttributeNS(String namespaceURI,
String qualifiedName,
String value);
Paramètres d'appel :
- namespaceURI: String, spécifie l'URI de l'espace de noms à définir
- qualifiedName: String, spécifie le nom de l'attribut à définir
- value: String, spécifie la valeur d'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 un URI d'espace de noms et un nom qualifié composé d'un préfixe d'espace de noms, de deux-points et d'un nom local dans l'espace de noms. En plus de modifier la valeur d'un attribut, vous pouvez également utiliser cette méthode pour modifier le préfixe d'espace de noms de l'attribut.
removeAttribute
Supprimer l'attribut spécifié par son nom
1XmlElement.removeAttribute(String name);
Paramètres d'appel :
- name: String, spécifie le nom de l'attribut à supprimer
removeAttributeNS
Supprimer les propriétés spécifiées par espace de noms et nom
1
2XmlElement.removeAttributeNS(String namespaceURI,
String localName);
Paramètres d'appel :
- namespaceURI: String, spécifie l'URI de l'espace de noms à supprimer
- localName: String, spécifie le nom de l'attribut à supprimer
hasAttribute
Demander si le nœud actuel a un attribut avec le nom spécifié
1Boolean XmlElement.hasAttribute(String name);
Paramètres d'appel :
- name: String, spécifie le nom de l'attribut de la requête
Résultats de retour :
- Boolean, si le nœud d'élément actuel a l'attribut spécifié, renvoie vrai, sinon renvoie faux
hasAttributeNS
Demander si le nœud actuel possède des attributs avec l'espace de noms et le nom spécifiés
1
2Boolean XmlElement.hasAttributeNS(String namespaceURI,
String localName);
Paramètres d'appel :
- namespaceURI: String, spécifie l'URI de l'espace de noms à interroger
- localName: String, spécifie le nom de l'attribut de la requête
Résultats de retour :
- Boolean, si le nœud d'élément actuel a l'attribut spécifié, renvoie vrai, sinon renvoie faux
getElementsByTagName
Renvoie tous les éléments avec le nom spécifiéXmlNodeList
1XmlNodeList 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ésultats de retour :
- XmlNodeList, le nœud XmlElement avec la balise spécifiée dans l'arborescence des nœudsXmlNodeListrassembler. L'ordre des nœuds d'éléments renvoyés est l'ordre dans lequel ils apparaissent dans le document source.
Cette méthode parcourra les nœuds descendants de l'élément spécifié et renverra un nœud XmlElement.XmlNodeListObjet représentant 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.
XmlDocumentL'interface définit également la méthode getElementsByTagName, qui est similaire à cette méthode, mais parcourt l'intégralité du document au lieu de parcourir les nœuds descendants d'un élément.
getElementsByTagNameNS
Renvoie tous les éléments avec l'espace de noms et le nom spécifiésXmlNodeList
1
2XmlNodeList XmlElement.getElementsByTagNameNS(String namespaceURI,
String localName);
Paramètres d'appel :
- namespaceURI: String, spécifie 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ésultats de retour :
- XmlNodeList, le nœud XmlElement avec la balise spécifiée dans l'arborescence des nœudsXmlNodeListrassembler. 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é
1XmlElement XmlElement.getElementById(String id);
Paramètres d'appel :
- id: String, l'identifiant à récupérer
Résultats de retour :
- XmlElement, le nœud XmlElement avec l'attribut id spécifié dans l'arborescence des nœuds
Cette méthode parcourra les nœuds descendants de l'élément spécifié et renverra un objet nœud XmlElement représentant le premier élément du document avec l'attribut id spécifié. .
XmlDocumentL'interface définit également la méthode getElementsByTagName, qui est similaire à cette méthode, mais parcourt l'intégralité du document au lieu de parcourir les nœuds descendants d'un élément.
getElementsByClassName
Renvoie une liste de nœuds de tous les éléments avec le nom de classe spécifié
1XmlNodeList XmlElement.getElementsByClassName(String className);
Paramètres d'appel :
- className: String, le nom de la classe à récupérer
Résultats de retour :
- XmlNodeList, le nœud XmlElement avec le nom de classe spécifié dans l'arborescence du documentXmlNodeListrassembler. 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 unXmlNodeListObjet (peut être traité comme un tableau en lecture seule), qui stocke tous les nœuds XmlElement avec le nom de classe spécifié dans le document. L'ordre dans lequel ils sont stockés est l'ordre dans lequel ils apparaissent dans le document source.XmlNodeListL'objet est "en direct", 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 existe des nœuds enfants
1Boolean XmlElement.hasChildNodes();
Résultats de retour :
- Boolean, renvoie vrai s'il y a des nœuds enfants, sinon renvoie faux
normalize
Fusionner les nœuds de texte adjacents et supprimer les nœuds de texte vides
1XmlElement.normalize();
Cette méthode traversera tous les nœuds descendants du nœud actuel et normalisera le document en supprimant les nœuds Texte vides et en fusionnant tous les nœuds Texte 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ée une copie exacte du nœud spécifié
1XmlNode XmlElement.cloneNode(Boolean deep = true);
Paramètres d'appel :
- deep: Booléen, s'il faut copier en profondeur, lorsque c'est vrai, le nœud cloné clonera tous les nœuds enfants du nœud d'origine
Résultats de retour :
- XmlNode, renvoie le nœud copié
Cette méthode copiera et renverra une copie du nœud sur lequel elle a été appelée. Si l'argument qui lui est transmis est vrai, il copiera également de manière récursive tous les nœuds descendants du nœud actuel. Sinon, il copie uniquement le nœud actuel. Le nœud renvoyé n'appartient pas à l'arborescence du document et sa propriété parentNode est nulle. Lorsqu'un nœud Element est copié, toutes ses propriétés seront copiées.
lookupPrefix
Renvoie le préfixe correspondant à l'URI de l'espace de noms spécifié sur le nœud actuel
1String XmlElement.lookupPrefix(String namespaceURI);
Paramètres d'appel :
- namespaceURI: String, spécifie l'URI de l'espace de noms correspondant
Résultats de retour :
- String, renvoie le préfixe correspondant, renvoie null s'il ne correspond pas.
lookupNamespaceURI
Renvoie l'URI de l'espace de noms correspondant au préfixe spécifié sur le nœud actuel
1String XmlElement.lookupNamespaceURI(String prefix);
Paramètres d'appel :
- prefix: String, spécifie le préfixe correspondant
Résultats 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 un nœud enfant existant
1
2XmlNode XmlElement.insertBefore(XmlNode newChild,
XmlNode refChild);
Paramètres d'appel :
Résultats de retour :
- XmlNode, renvoie le nouveau nœud enfant
Si newChild existe déjà dans l’arborescence des documents, il sera supprimé de l’arborescence des documents et réinséré à 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. Autrement dit, l'attribut OwnerDocument de newChild doit être le même que l'attribut OwnerDocument du nœud actuel.
insertAfter
Insérer un nouveau nœud enfant après un nœud enfant existant
1
2XmlNode XmlElement.insertAfter(XmlNode newChild,
XmlNode refChild);
Paramètres d'appel :
Résultats de retour :
- XmlNode, renvoie le nouveau nœud enfant
Si newChild existe déjà dans l’arborescence des documents, il sera supprimé de l’arborescence des documents et réinséré à 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. Autrement dit, l'attribut OwnerDocument de newChild doit être le même que l'attribut OwnerDocument du nœud actuel.
appendChild
Ajoute un nouveau nœud enfant à la fin de la liste des nœuds enfants d'un nœud
1XmlNode XmlElement.appendChild(XmlNode newChild);
Paramètres d'appel :
- newChild:XmlNode, spécifiez le nœud ajouté
Résultats de retour :
- XmlNode, renvoie ce nouveau nœud enfant
Si newChild existe déjà dans l’arborescence des documents, il sera supprimé de l’arborescence des documents et réinséré à 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. Autrement dit, l'attribut OwnerDocument de newChild doit être le même que l'attribut OwnerDocument du nœud actuel.
replaceChild
Remplacer un nœud enfant par un autre
1
2XmlNode XmlElement.replaceChild(XmlNode newChild,
XmlNode oldChild);
Paramètres d'appel :
Résultats 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 des documents, il sera supprimé de l’arborescence des documents et réinséré à 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. Autrement dit, l'attribut OwnerDocument de newChild doit être le même que l'attribut OwnerDocument du nœud actuel.
removeChild
Supprimer un nœud de la liste des nœuds enfants
1XmlNode XmlElement.removeChild(XmlNode oldChild);
Paramètres d'appel :
- oldChild:XmlNode, spécifie le nœud à supprimer
Résultats de retour :
- XmlNode, Si la suppression réussit, cette méthode peut renvoyer le nœud supprimé. En cas d'échec, elle renvoie null.
toString
Renvoie la représentation sous forme de chaîne de l'objet. Généralement, "[Native Object]" est renvoyé. L'objet peut être réimplémenté en fonction de ses propres caractéristiques.
1String XmlElement.toString();
Résultats de retour :
- String, renvoie la représentation sous forme de chaîne de l'objet
toJSON
Renvoie une représentation au format JSON de l'objet, renvoyant généralement une collection de propriétés lisibles définies par l'objet.
1Value XmlElement.toJSON(String key = "");
Paramètres d'appel :
- key: Chaîne, non utilisée
Résultats de retour :
- Value, renvoie une valeur contenant du JSON sérialisable