ObjectXmlElement

Els objectes XmlElement representen elements en un document XML

relació hereditària

propietats dels membres

namespaceURI

Cadena, URI de l'espai de noms de l'element de consulta. Si el node seleccionat no té espai de noms, aquesta propietat retorna NULL

1
readonly String XmlElement.namespaceURI;

prefix

Cadena, consulta i estableix el prefix d'espai de noms de l'element. Si el node seleccionat no té espai de noms, aquesta propietat retorna NULL

1
String XmlElement.prefix;

localName

String, el nom local de l'element de consulta. Si el node seleccionat no té espai de noms, aquesta propietat és equivalent a nodeName

1
readonly String XmlElement.localName;

tagName

Cadena, retorna el nom de l'etiqueta de l'element

1
readonly String XmlElement.tagName;

id

Cadena, consulta i estableix l'atribut id de l'element

1
String XmlElement.id;

innerHTML

Encadena, consulta i configura el text HTML dels descendents de l'element seleccionat, només vàlid en mode html. Quan feu una consulta, retorneu la codificació HTML de tots els nodes secundaris dins del node d'element; quan configureu, suprimiu tots els nodes secundaris i substituïu-los per la descodificació HTML especificada.

1
String XmlElement.innerHTML;

outerHTML

String, consulta el text HTML de l'element seleccionat i els seus descendents, només vàlid en mode html. Quan feu una consulta, retorneu la codificació HTML de l'element i de tots els nodes secundaris del node.

1
readonly String XmlElement.outerHTML;

className

Cadena, consulta i estableix l'atribut class de l'element, només vàlid en mode html

1
String XmlElement.className;

attributes

XmlNamedNodeMap, retorna un NamedNodeMap que conté els atributs del node seleccionat. Si el node seleccionat no és un element, aquesta propietat retorna NULL.

1readonly XmlNamedNodeMap XmlElement.attributes;

nodeType

Enter, retorna el tipus de node del node

1readonly Integer XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.ownerDocument;

parentNode

XmlNode, pot retornar el node pare d'un node

1readonly XmlNode XmlElement.parentNode;

childNodes

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

1readonly XmlNodeList XmlElement.childNodes;

children

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

1readonly XmlNodeList XmlElement.children;

firstChild

XmlNode, retorna el primer node fill del node

1readonly XmlNode XmlElement.firstChild;

lastChild

XmlNode, retorna l'últim node fill del node

1readonly XmlNode XmlElement.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 XmlElement.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 XmlElement.nextSibling;

firstElementChild

XmlNode, retorna el primer node element fill del node

1readonly XmlNode XmlElement.firstElementChild;

lastElementChild

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

1readonly XmlNode XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.textContent;

funció de membre

getAttribute

Consulta el valor d'un atribut pel nom

1
String XmlElement.getAttribute(String name);

Paràmetres de trucada:

name: Cadena, especifica el nom de l'atribut de la consulta

Resultats de retorn:

String, retorna el valor de l'atribut

getAttributeNS

Obteniu el valor de l'atribut per l'URI i el nom de l'espai de noms

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

Paràmetres de trucada:

namespaceURI: Cadena, que especifica l'URI de l'espai de noms de la consulta
localName: Cadena, especifica el nom de l'atribut de la consulta

Resultats de retorn:

String, retorna el valor de l'atribut

setAttribute

Creeu o canvieu una propietat nova

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

Paràmetres de trucada:

name: Cadena, especifica el nom de l'atribut que s'ha d'establir
value: Cadena, especifica el valor de l'atribut que s'ha d'establir

Aquest mètode estableix la propietat especificada al valor especificat. Si no existeix una propietat amb el nom especificat, aquest mètode crea una propietat nova

setAttributeNS

Creeu o modifiqueu propietats amb espai de noms

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

Paràmetres de trucada:

namespaceURI: String, especifica l'URI de l'espai de noms que s'ha d'establir
qualifiedName: Cadena, especifica el nom de l'atribut que s'ha d'establir
value: Cadena, especifica el valor de l'atribut que s'ha d'establir

Aquest mètode és similar al mètode setAttribute, excepte que l'atribut que s'ha de crear o establir s'especifica mitjançant un URI d'espai de noms i un nom qualificat que consisteix en un prefix d'espai de noms, dos punts i un nom local a l'espai de noms. A més de canviar el valor d'un atribut, també podeu utilitzar aquest mètode per canviar el prefix de l'espai de noms de l'atribut.

removeAttribute

Elimina l'atribut especificat pel nom

1
XmlElement.removeAttribute(String name);

Paràmetres de trucada:

name: Cadena, especifica el nom de l'atribut que s'ha de suprimir

removeAttributeNS

Elimina les propietats especificades per espai de noms i nom

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

Paràmetres de trucada:

namespaceURI: String, especifica l'URI de l'espai de noms que s'ha de suprimir
localName: Cadena, especifica el nom de l'atribut que s'ha de suprimir

hasAttribute

Consulta si el node actual té un atribut amb el nom especificat

1
Boolean XmlElement.hasAttribute(String name);

Paràmetres de trucada:

name: Cadena, especifica el nom de l'atribut de la consulta

Resultats de retorn:

Boolean, si el node de l'element actual té l'atribut especificat, retorna true, en cas contrari retorna false

hasAttributeNS

Consulteu si el node actual té atributs amb l'espai de noms i el nom especificats

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

Paràmetres de trucada:

namespaceURI: String, especifica l'URI de l'espai de noms que s'ha de consultar
localName: Cadena, especifica el nom de l'atribut de la consulta

Resultats de retorn:

Boolean, si el node de l'element actual té l'atribut especificat, retorna true, en cas contrari retorna false

getElementsByTagName

Retorna tots els elements amb el nom especificatXmlNodeList

1
XmlNodeList XmlElement.getElementsByTagName(String tagName);

Paràmetres de trucada:

tagName: String, el nom de l'etiqueta que s'ha de recuperar. El valor "*" coincideix amb totes les etiquetes

Resultats de retorn:

XmlNodeList, el node XmlElement amb l'etiqueta especificada a l'arbre de nodesXmlNodeListreunir. L'ordre dels nodes d'element retornats és l'ordre en què apareixen al document font.

Aquest mètode travessarà els nodes descendents de l'element especificat i retornarà un node XmlElement.XmlNodeListObjecte que representa tots els elements del document amb el nom d'etiqueta especificat. L'ordre dels elements de la matriu retornada és l'ordre en què apareixen al codi font del document.

XmlDocumentLa interfície també defineix el mètode getElementsByTagName, que és similar a aquest mètode, però travessa tot el document en lloc de travessar els nodes descendents d'un element.

getElementsByTagNameNS

Retorna tots els elements amb l'espai de noms i el nom especificatsXmlNodeList

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

Paràmetres de trucada:

namespaceURI: String, especifica l'URI de l'espai de noms que s'ha de consultar
localName: String, el nom de l'etiqueta que s'ha de recuperar. El valor "*" coincideix amb totes les etiquetes

Resultats de retorn:

XmlNodeList, el node XmlElement amb l'etiqueta especificada a l'arbre de nodesXmlNodeListreunir. L'ordre dels nodes d'element retornats és l'ordre en què apareixen al document font.

Aquest mètode és similar al mètode getElementsByTagName, excepte que el nom de l'etiqueta de l'element que voleu obtenir s'especifica com una combinació de l'URI de l'espai de noms i el nom local definit a l'espai de noms.

getElementById

Retorna l'element amb l'atribut id especificat

1
XmlElement XmlElement.getElementById(String id);

Paràmetres de trucada:

id: String, l'identificador que s'ha de recuperar

Resultats de retorn:

XmlElement, el node XmlElement amb l'atribut id especificat a l'arbre de nodes

Aquest mètode travessarà els nodes descendents de l'element especificat i retornarà un objecte node XmlElement que representa el primer element del document amb l'atribut id especificat. .

XmlDocumentLa interfície també defineix el mètode getElementsByTagName, que és similar a aquest mètode, però travessa tot el document en lloc de travessar els nodes descendents d'un element.

getElementsByClassName

Retorna una llista de nodes de tots els elements amb el nom de classe especificat

1
XmlNodeList XmlElement.getElementsByClassName(String className);

Paràmetres de trucada:

className: String, el nom de la classe que s'ha de recuperar

Resultats de retorn:

XmlNodeList, el node XmlElement amb el nom de classe especificat a l'arbre del documentXmlNodeListreunir. L'ordre dels nodes d'element retornats és l'ordre en què apareixen al document font.

Aquest mètode retornarà aXmlNodeListObjecte (es pot processar com a matriu de només lectura), que emmagatzema tots els nodes XmlElement amb el nom de classe especificat al document. L'ordre en què s'emmagatzemen és l'ordre en què apareixen al document font.XmlNodeListL'objecte és "en directe", és a dir, si un element amb el nom d'etiqueta especificat s'afegeix o s'elimina al document, el seu contingut s'actualitzarà automàticament segons sigui necessari.

hasChildNodes

Consulta si hi ha nodes fills

1
Boolean XmlElement.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

1XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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

ObjectXmlElement

relació hereditària

propietats dels membres

namespaceURI

prefix

localName

tagName

id

innerHTML

outerHTML

className

attributes

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

children

firstChild

lastChild

previousSibling

nextSibling

firstElementChild

lastElementChild

previousElementSibling

nextElementSibling

textContent

funció de membre

getAttribute

getAttributeNS

setAttribute

setAttributeNS

removeAttribute

removeAttributeNS

hasAttribute

hasAttributeNS

getElementsByTagName

getElementsByTagNameNS

getElementById

getElementsByClassName

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON