ObjetXmlTexte
Un objet XmlText représente le contenu textuel d'un élément ou d'un attribut
Le nœud XmlText représente une séquence de texte brut dans un document XML. Étant donné que le texte brut apparaît dans les éléments et attributs XML, le nœud XmlText est généralementXmlElementsomme de nœudsXmlAttrLes enfants du nœud apparaissent.
Les nœuds XmlText héritentXmlCharacterDatainterface, viaXmlCharacterDataattribut de données hérité de l'interface ou deXmlNodeL'attribut nadevalue hérité par l'interface peut accéder au contenu texte du nœud XmlText.
utiliser à partir deXmlCharacterDataLes méthodes héritées ou la méthode splitText() définie par l'interface XmlText elle-même peuvent faire fonctionner les nœuds XmlText. utiliserXmlDocumentcreateTextNode pour créer un nouveau nœud XmlText.
Le nœud XmlText n'a aucun nœud enfant.
Pour les méthodes de suppression des nœuds XmlText vides et de fusion des nœuds XmlText adjacents d'un sous-arbre d'un document, voirXmlNode.normalizeméthode.
relation d'héritage
propriétés des membres
data
String, le texte contenu dans ce nœud
1String XmlText.data;
length
Entier, le nombre de caractères contenus dans ce nœud
1readonly Integer XmlText.length;
nodeType
Entier, renvoie le type de nœud du nœud
1readonly Integer XmlText.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 XmlText.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 XmlText.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 XmlText.ownerDocument;
parentNode
XmlNode, peut renvoyer le nœud parent d'un nœud
1readonly XmlNode XmlText.parentNode;
childNodes
XmlNodeList, renvoie la liste des nœuds enfants du nœud spécifié
1readonly XmlNodeList XmlText.childNodes;
children
XmlNodeList, renvoie la liste des nœuds des éléments enfants du nœud spécifié.
1readonly XmlNodeList XmlText.children;
firstChild
XmlNode, renvoie le premier nœud enfant du nœud
1readonly XmlNode XmlText.firstChild;
lastChild
XmlNode, renvoie le dernier nœud enfant du nœud
1readonly XmlNode XmlText.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 XmlText.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 XmlText.nextSibling;
firstElementChild
XmlNode, renvoie le premier nœud d'élément enfant du nœud
1readonly XmlNode XmlText.firstElementChild;
lastElementChild
XmlNode, renvoie le dernier nœud d'élément enfant du nœud
1readonly XmlNode XmlText.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 XmlText.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 XmlText.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 XmlText.textContent;
fonction membre
splitText
Divisez le nœud de texte en deux nœuds en fonction du décalage spécifié
1XmlText XmlText.splitText(Integer offset);
Paramètres d'appel :
- offset: Entier, spécifie où diviser les nœuds de texte. La valeur de départ commence par 0
Résultats de retour :
- XmlText, Nœud de texte séparé du nœud actuel
Cette méthode divisera le nœud XmlText en deux nœuds au décalage spécifié. Le nœud XmlText d'origine sera modifié afin qu'il contienne le contenu du texte avant (mais sans l'inclure) le contenu du texte à la position spécifiée par offset. Un nouveau nœud XmlText sera créé pour stocker tous les caractères depuis la position de décalage (y compris les caractères à cette position) jusqu'à la fin du caractère d'origine. Le nouveau nœud XmlText est la valeur de retour de cette méthode. De plus, si le nœud XmlText d'origine possède un parentNode, le nouveau nœud XmlText sera inséré dans ce nœud parent, immédiatement après le nœud d'origine.
XmlCDATASectionL'interface hérite de l'interface XmlText,XmlCDATASectionLes nœuds peuvent également utiliser cette méthode, mais les nœuds nouvellement créés sontXmlCDATASectionnœud au lieu d’un nœud XmlText.
substringData
Extraire la sous-chaîne du nœud
1
2String XmlText.substringData(Integer offset,
Integer count);
Paramètres d'appel :
- offset: Entier, la position du premier caractère à renvoyer
- count: Entier, le nombre de caractères de la sous-chaîne à renvoyer
Résultats de retour :
- String, renvoie la chaîne extraite
appendData
Ajouter une chaîne au nœud
1XmlText.appendData(String arg);
Paramètres d'appel :
- arg: String, la chaîne à ajouter au nœud
insertData
Insérer une chaîne dans le nœud
1
2XmlText.insertData(Integer offset,
String arg);
Paramètres d'appel :
- offset: Entier, la position du caractère à laquelle la chaîne doit être insérée dans le nœud
- arg: String, la chaîne à insérer
deleteData
Supprimer le texte du nœud
1
2XmlText.deleteData(Integer offset,
Integer count);
Paramètres d'appel :
- offset: Entier, la position du premier caractère à supprimer
- count: Entier, le nombre de caractères à supprimer
replaceData
Remplacez les caractères du nœud par la chaîne spécifiée
1
2
3XmlText.replaceData(Integer offset,
Integer count,
String arg);
Paramètres d'appel :
- offset: Entier, la position du caractère du nœud à remplacer
- count: Entier, le nombre de caractères à remplacer
- arg: String, la chaîne à insérer
hasChildNodes
Demander s'il existe des nœuds enfants
1Boolean XmlText.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
1XmlText.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 XmlText.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 XmlText.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 XmlText.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 XmlText.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 XmlText.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 XmlText.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 XmlText.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 XmlText.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 XmlText.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 XmlText.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