ObjectXmlText

Un objecte XmlText representa el contingut de text d'un element o atribut

El node XmlText representa una seqüència de text sense format en un document XML. Com que el text sense format apareix als elements i atributs XML, el node XmlText normalment ho ésXmlElementsuma de nodesXmlAttrApareixen els fills del node.

Els nodes XmlText heretenXmlCharacterDatainterfície, viaXmlCharacterDataatribut de dades heretat de la interfície o deXmlNodeL'atribut nadevalue heretat per la interfície pot accedir al contingut de text del node XmlText.

utilitzar des deXmlCharacterDataEls mètodes heretats o el mètode splitText() definit per la mateixa interfície XmlText poden operar nodes XmlText. utilitzarXmlDocumentcreateTextNode per crear un nou node XmlText.

El node XmlText no té cap node fill.

Per obtenir mètodes per suprimir nodes XmlText buits i combinar nodes XmlText adjacents d'un subarbre d'un document, vegeuXmlNode.normalizemètode.

relació hereditària

propietats dels membres

data

String, el text contingut en aquest node

1
String XmlText.data;

length

Enter, el nombre de caràcters continguts en aquest node

1readonly Integer XmlText.length;

nodeType

Enter, retorna el tipus de node del node

1readonly Integer XmlText.nodeType;

El nodeType de diferents objectes retornarà diferents valors:

XmlElement: ELEMENT_NODE(1)
XmlAttr:ATTRIBUTE_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, retorna el nom del node, segons el seu tipus

1
readonly String XmlText.nodeName;

El nodeName de diferents objectes retornarà diferents valors:

XmlElement:nom de l'element
XmlAttr: nom de l'atribut
XmlText: #text
XmlCDATASection: #cdata-section
XmlProcessingInstruction: retorna l'objectiu objectiu especificat
XmlComment: #comentar
XmlDocument: #document
XmlDocumentType: nom del tipus de document

nodeValue

String, retorna el nom del node, segons el seu tipus

1
String XmlText.nodeValue;

El nodeName de diferents objectes retornarà diferents valors:

XmlElement: nul
XmlAttr: valor de l'atribut
XmlText: el contingut del node
XmlCDATASection: el contingut del node
XmlProcessingInstruction: retorna les dades de contingut especificades
XmlComment: text d'anotació
XmlDocument: nul
XmlDocumentType: nul

ownerDocument

XmlDocument, retorna l'element arrel del node (XmlDocumentobjecte)

1readonly XmlDocument XmlText.ownerDocument;

parentNode

XmlNode, pot retornar el node pare d'un node

1readonly XmlNode XmlText.parentNode;

childNodes

XmlNodeList, retorna la llista de nodes dels nodes fills del node especificat

1readonly XmlNodeList XmlText.childNodes;

children

XmlNodeList, retorna la llista de nodes dels nodes de l'element fill del node especificat.

1readonly XmlNodeList XmlText.children;

firstChild

XmlNode, retorna el primer node fill del node

1readonly XmlNode XmlText.firstChild;

lastChild

XmlNode, retorna l'últim node fill del node

1readonly XmlNode XmlText.lastChild;

previousSibling

XmlNode, retorna el node immediatament anterior a un node (al mateix nivell d'arbre). Si no hi ha aquest node, aquesta propietat retorna null.

1readonly XmlNode XmlText.previousSibling;

nextSibling

XmlNode, retorna el node immediatament després d'un element (al mateix nivell d'arbre). Si no hi ha aquest node, l'atribut retorna null.

1readonly XmlNode XmlText.nextSibling;

firstElementChild

XmlNode, retorna el primer node element fill del node

1readonly XmlNode XmlText.firstElementChild;

lastElementChild

XmlNode, retorna l'últim node d'element fill del node

1readonly XmlNode XmlText.lastElementChild;

previousElementSibling

XmlNode, retorna el node d'element immediatament anterior a un node (al mateix nivell d'arbre). Si no hi ha aquest node, aquesta propietat retorna null.

1readonly XmlNode XmlText.previousElementSibling;

nextElementSibling

XmlNode, retorna el node d'element immediatament després d'un element (al mateix nivell d'arbre). Si no hi ha aquest node, l'atribut retorna null.

1readonly XmlNode XmlText.nextElementSibling;

textContent

Cadena, consulta i estableix el text de l'element seleccionat. Quan es consulta, retorna els valors de tots els nodes de text dins del node d'element; quan es configura, elimina tots els nodes fills i els substitueix per un sol node de text.

1
String XmlText.textContent;

funció de membre

splitText

Dividiu el node de text en dos nodes segons el desplaçament especificat

1XmlText XmlText.splitText(Integer offset);

Paràmetres de trucada:

offset: Sencer, especifica on dividir els nodes de text. El valor inicial comença amb 0

Resultats de retorn:

XmlText, Node de text dividit del node actual

Aquest mètode dividirà el node XmlText en dos nodes amb el desplaçament especificat. El node XmlText original es modificarà perquè contingui el contingut del text abans (però sense incloure) el contingut del text a la posició especificada per offset. Es crearà un nou node XmlText per emmagatzemar tots els caràcters des de la posició de desplaçament (inclosos els caràcters d'aquesta posició) fins al final del caràcter original. El nou node XmlText és el valor de retorn d'aquest mètode. A més, si el node XmlText original té un parentNode, el nou node XmlText s'inserirà en aquest node pare, immediatament després del node original.

XmlCDATASectionLa interfície hereta la interfície XmlText,XmlCDATASectionEls nodes també poden utilitzar aquest mètode, però els nodes de nova creació síXmlCDATASectionnode en lloc d'un node XmlText.

substringData

Extreu la subcadena del node

1
2
String XmlText.substringData(Integer offset,
    Integer count);

Paràmetres de trucada:

offset: Enter, la posició del primer caràcter a retornar
count: Enter, el nombre de caràcters de la subcadena que s'ha de retornar

Resultats de retorn:

String, retorna la cadena extreta

appendData

Afegeix una cadena al node

1
XmlText.appendData(String arg);

Paràmetres de trucada:

arg: String, la cadena que s'ha d'afegir al node

insertData

Inseriu una cadena al node

1
2XmlText.insertData(Integer offset,
    String arg);

Paràmetres de trucada:

offset: Enter, la posició del caràcter en què s'ha d'inserir la cadena al node
arg: String, la cadena que cal inserir

deleteData

Elimina el text del node

1
2
XmlText.deleteData(Integer offset,
    Integer count);

Paràmetres de trucada:

offset: Enter, la posició del primer caràcter que s'ha d'eliminar
count: Enter, el nombre de caràcters que cal suprimir

replaceData

Substituïu els caràcters del node per la cadena especificada

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

Paràmetres de trucada:

offset: Enter, la posició del caràcter del node que s'ha de substituir
count: Enter, el nombre de caràcters a substituir
arg: String, la cadena que cal inserir

hasChildNodes

Consulta si hi ha nodes fills

1
Boolean XmlText.hasChildNodes();

Resultats de retorn:

Boolean, retorna true si hi ha nodes fills, en cas contrari retorna false

normalize

Combina els nodes de text adjacents i suprimeix els nodes de text buits

1XmlText.normalize();

Aquest mètode travessarà tots els nodes descendents del node actual i normalitzarà el document eliminant els nodes de text buits i fusionant tots els nodes de text adjacents. Aquest mètode és útil per simplificar l'estructura de l'arbre del document després d'inserir o suprimir nodes.

cloneNode

Crea una còpia exacta del node especificat

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

Paràmetres de trucada:

deep: Booleà, si cal copiar en profunditat, quan és cert, el node clonat clonarà tots els nodes fills del node original

Resultats de retorn:

XmlNode, retorna el node copiat

Aquest mètode copiarà i retornarà una còpia del node on s'ha cridat. Si l'argument que se li passa és cert, també copiarà de manera recursiva tots els nodes descendents del node actual. En cas contrari, només copia el node actual. El node retornat no pertany a l'arbre del document i la seva propietat parentNode és nul·la. Quan es copia un node Element, es copiaran totes les seves propietats.

lookupPrefix

Retorna el prefix que coincideix amb l'URI de l'espai de noms especificat al node actual

1
String XmlText.lookupPrefix(String namespaceURI);

Paràmetres de trucada:

namespaceURI: String, especifica l'URI de l'espai de noms coincident

Resultats de retorn:

String, retorna el prefix coincident, retorna null si no coincideix.

lookupNamespaceURI

Retorna l'URI de l'espai de noms que coincideix amb el prefix especificat al node actual

1
String XmlText.lookupNamespaceURI(String prefix);

Paràmetres de trucada:

prefix: Cadena, especifica el prefix coincident

Resultats de retorn:

String, retorna l'URI de l'espai de noms coincident, retorna null si no coincideix.

insertBefore

Inseriu un nou node fill abans d'un node fill existent

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

Paràmetres de trucada:

newChild:XmlNode, inseriu un nou node
refChild:XmlNode, inseriu un nou node abans d'aquest node

Resultats de retorn:

XmlNode, retorna el nou node fill

Si newChild ja existeix a l'arbre del document, s'eliminarà de l'arbre del document i es tornarà a inserir a la seva nova posició. Els nodes d'un document (o nodes creats per un document) no es poden inserir en un altre document. És a dir, l'atribut ownerDocument de newChild ha de ser el mateix que l'atribut ownerDocument del node actual.

insertAfter

Inseriu un nou node fill després d'un node fill existent

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

Paràmetres de trucada:

newChild:XmlNode, inseriu un nou node
refChild:XmlNode, inseriu un nou node després d'aquest node

Resultats de retorn:

XmlNode, retorna el nou node fill

appendChild

Afegeix un nou node fill al final de la llista de nodes fill d'un node

1XmlNode XmlText.appendChild(XmlNode newChild);

Paràmetres de trucada:

newChild:XmlNode, especifiqueu el node afegit

Resultats de retorn:

XmlNode, retorna aquest nou node fill

replaceChild

Substituïu un node fill per un altre

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

Paràmetres de trucada:

newChild:XmlNode, especifiqueu el nou node
oldChild:XmlNode, especifica el node que s'ha de substituir

Resultats de retorn:

XmlNode, Si la substitució té èxit, aquest mètode pot retornar el node substituït. Si la substitució falla, retorna nul.

removeChild

Elimina un node de la llista de nodes fills

1XmlNode XmlText.removeChild(XmlNode oldChild);

Paràmetres de trucada:

oldChild:XmlNode, especifica el node que s'ha de suprimir

Resultats de retorn:

XmlNode, Si la supressió és correcta, aquest mètode pot retornar el node suprimit. Si falla, retorna null.

toString

Retorna la representació de cadena de l'objecte. En general, es retorna "[Objecte natiu]". L'objecte es pot tornar a implementar segons les seves pròpies característiques.

1
String XmlText.toString();

Resultats de retorn:

String, retorna la representació de cadena de l'objecte

toJSON

Retorna una representació en format JSON de l'objecte, generalment retornant una col·lecció de propietats llegibles definides per l'objecte.

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

Paràmetres de trucada:

key: Corda, no utilitzada

Resultats de retorn:

Value, retorna un valor que conté JSON serializable

Guia de desenvolupament

Mòdul bàsic

objectes incorporats

mòdul comunitari

ObjectXmlText

relació hereditària

propietats dels membres

data

length

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

children

firstChild

lastChild

previousSibling

nextSibling

firstElementChild

lastElementChild

previousElementSibling

nextElementSibling

textContent

funció de membre

splitText

substringData

appendData

insertData

deleteData

replaceData

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON