Objet objet intégré

objet XmlText

Objet XmlText représentant le contenu textuel d'un élément ou d'un attribut

Un 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 les attributs XML, les nœuds XmlText sont souventXmlElementnœud etXmlAttrLes nœuds enfants du nœud apparaissent.

Le nœud XmlText hériteXmlCharacterDatal'interface, à travers leXmlCharacterDataLa propriété data héritée par l'interface ou deXmlNodeLa propriété nadevalue héritée par l'interface peut accéder au contenu textuel du nœud XmlText.

utiliser à partir deXmlCharacterDataLa méthode héritée ou la méthode splitText() définie par l'interface XmlText elle-même peut faire fonctionner le nœud XmlText. utilisationXmlDocumentcreateTextNode pour créer un nouveau nœud XmlText.

Le nœud XmlText n'a pas d'enfant.

Pour les méthodes de suppression des nœuds XmlText vides et de fusion des nœuds XmlText adjacents à partir de la sous-arborescence d'un document, consultezXmlNode.normalizeméthode.

relation d'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()] [<class>XmlCharacterData|data;length|substringData();appendData();insertData();deleteData();replaceData()] [<this>XmlText|splitText()] [<class>XmlCDATASection] [object] <:- [XmlNode] [XmlNode] <:- [XmlCharacterData] [XmlCharacterData] <:- [XmlText] [XmlText] <:- [XmlCDATASection] XmlNode nodeType nodeName nodeValue ownerDocument parentNode childNodes firstChild lastChild previousSibling nextSibling hasChildNodes() normalize() cloneNode() lookupPrefix() lookupNamespaceURI() insertBefore() insertAfter() appendChild() replaceChild() removeChild() XmlCharacterData data length substringData() appendData() insertData() deleteData() replaceData() object toString() toJSON() XmlText splitText() XmlCDATASection

Propriétés des membres

data

String, le texte que ce nœud contient

1
String XmlText.data;

length

Entier, le nombre de caractères que ce nœud contient

1
readonly Integer XmlText.length;

nodeType

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

1
readonly Integer XmlText.nodeType;

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


nodeName

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

1
readonly String XmlText.nodeName;

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


nodeValue

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

1
String XmlText.nodeValue;

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


ownerDocument

XmlDocument, renvoie l'élément racine du nœud (XmlDocumentobjet)

1
readonly XmlDocument XmlText.ownerDocument;

parentNode

XmlNode, renvoie le nœud parent d'un nœud

1
readonly XmlNode XmlText.parentNode;

childNodes

XmlNodeList, renvoie une liste de nœuds enfants du nœud spécifié

1
readonly XmlNodeList XmlText.childNodes;

firstChild

XmlNode, renvoie le premier enfant du nœud

1
readonly XmlNode XmlText.firstChild;

lastChild

XmlNode, renvoie le dernier enfant du nœud

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

1
readonly XmlNode XmlText.previousSibling;

nextSibling

XmlNode, renvoie le nœud immédiatement après 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 XmlText.nextSibling;

fonction membre

splitText

Diviser le nœud de texte en deux nœuds en fonction du décalage spécifié

1
XmlText 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

Retourner le résultat :

  • XmlText, le nœud Texte est 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é pour contenir (mais pas inclure) le contenu du texte jusqu'à la position spécifiée par offset. Un nouveau nœud XmlText sera créé pour contenir tous les caractères depuis la position de décalage (y compris le caractère à 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 avait 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, sauf que les nœuds nouvellement créés sontXmlCDATASectionnœud, pas un nœud XmlText.


substringData

Extraire la sous-chaîne du nœud

1 2
String 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 dans la sous-chaîne à retourner

Retourner le résultat :

  • String, renvoie la chaîne extraite

appendData

ajouter une chaîne au nœud

1
XmlText.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 2
XmlText.insertData(Integer offset, String arg);

Paramètres d'appel :

  • offset: Integer, la position du caractère à laquelle insérer la chaîne dans le nœud
  • arg: String, la chaîne à insérer

deleteData

supprimer le texte du nœud

1 2
XmlText.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

Remplacer les caractères d'un nœud par la chaîne spécifiée

1 2 3
XmlText.replaceData(Integer offset, Integer count, String arg);

Paramètres d'appel :

  • offset: Entier, la position du caractère que le nœud doit remplacer
  • count: Entier, le nombre de caractères à remplacer
  • arg: String, la chaîne à insérer

hasChildNodes

Requête s'il existe un nœud enfant

1
Boolean XmlText.hasChildNodes();

Retourner le résultat :

  • Boolean, renvoie vrai s'il y a des nœuds enfants, faux sinon

normalize

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

1
XmlText.normalize();

Cette méthode itérera sur tous les nœuds descendants du nœud actuel, normalisant le document en supprimant les nœuds de texte vides, fusionnant déjà tous les nœuds de texte adjacents. Cette méthode est utile pour simplifier la structure de l'arborescence du document après l'insertion ou la suppression d'un nœud.


cloneNode

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

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

Paramètres d'appel :

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

Retourner le résultat :

Cette méthode copiera et renverra une copie du nœud sur lequel elle a été appelée. Si l'argument qui lui est passé est vrai, il copiera également de manière récursive tous les descendants du nœud actuel. Sinon, il copie simplement 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 sont copiées.


lookupPrefix

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

1
String XmlText.lookupPrefix(String namespaceURI);

Paramètres d'appel :

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

Retourner le résultat :

  • String, renvoie le préfixe correspondant, non correspondant renvoie null

lookupNamespaceURI

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

1
String XmlText.lookupNamespaceURI(String prefix);

Paramètres d'appel :

  • prefix: Chaîne, spécifiant le préfixe à faire correspondre

Retourner le résultat :

  • String, renvoie l'URI de l'espace de noms correspondant, non correspondant renvoie null

insertBefore

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

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

Paramètres d'appel :

  • newChild:XmlNode, insérez un nouveau nœud
  • refChild:XmlNode, insérez un nouveau nœud avant ce nœud

Retourner le résultat :

  • 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 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, la propriété ownerDocument de newChild doit être identique à la propriété ownerDocument du nœud actuel.


insertAfter

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

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

Paramètres d'appel :

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

Retourner le résultat :

  • 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 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, la propriété ownerDocument de newChild doit être identique à 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 XmlText.appendChild(XmlNode newChild);

Paramètres d'appel :

  • newChild:XmlNode, spécifie le nœud à ajouter

Retourner le résultat :

  • 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 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, la propriété ownerDocument de newChild doit être identique à la propriété ownerDocument du nœud actuel.


replaceChild

remplacer un nœud enfant par un autre

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

Paramètres d'appel :

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

Retourner le résultat :

  • XmlNode, si le remplacement réussit, cette méthode peut renvoyer le nœud à remplacer, si le remplacement échoue, elle renverra null

Si newChild existe déjà dans l'arborescence du document, il sera supprimé de l'arborescence du document 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, la propriété ownerDocument de newChild doit être identique à la propriété ownerDocument du nœud actuel.


removeChild

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

1
XmlNode XmlText.removeChild(XmlNode oldChild);

Paramètres d'appel :

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

Retourner le résultat :

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

toString

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

1
String XmlText.toString();

Retourner le résultat :

  • 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 l'ensemble des propriétés lisibles définies par l'objet

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

Paramètres d'appel :

  • key: Chaîne, inutilisée

Retourner le résultat :

  • Value, renvoie une valeur contenant du JSON sérialisable