Objecte XmlElement
Els objectes XmlElement representen elements en documents XML
Herència
Atributs de membre
namespaceURI
String, l’URI de l’espai de noms de l’element de consulta. Si el node seleccionat no té espai de noms, aquest atribut retorna NULL
1readonly String XmlElement.namespaceURI;
prefix
Cadena, consulta i estableix el prefix de l’espai de noms de l’element. Si el node seleccionat no té espai de noms, aquest atribut retorna NULL
1String XmlElement.prefix;
localName
String, el nom local de l'element de consulta. Si el node seleccionat no té espai de noms, aquest atribut és equivalent a nodeName
1readonly String XmlElement.localName;
tagName
Cadena, retorna el nom de l’etiqueta de l’element
1readonly String XmlElement.tagName;
id
Cadena, consulta i estableix l'atribut id de l'element
1String XmlElement.id;
textContent
Cadena, consulta i defineix el text de l'element seleccionat. Quan feu una consulta, torneu els valors de tots els nodes de text del node de l'element; en establir-los, suprimiu tots els nodes secundaris i substituïu-los per un node de text únic.
1String XmlElement.textContent;
innerHTML
Encadenar, consultar i definir el text HTML de l’element seleccionat, només vàlid en mode html. Quan feu una consulta, torneu el codi HTML de tots els nodes secundaris del node element; en configurar-los, suprimiu tots els nodes secundaris i substituïu-los per l'HTML especificat després de descodificar-los.
1String XmlElement.innerHTML;
className
Cadena, consulta i estableix l'atribut class de l'element, només vàlid en mode html
1String XmlElement.className;
attributes
XmlNamedNodeMap, Retorna el NamedNodeMap que conté els atributs del node seleccionat. Si el node seleccionat no és un element, aquest atribut 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
Cadena, retorna el nom del node, segons el seu tipus
1readonly String XmlElement.nodeName;
El nodeName de diferents objectes retornarà diferents valors:
- XmlElement: nom de l'element
- XmlAttr: Nom de la propietat
- XmlText: #text
- XmlCDATASection: # cdata-section
- XmlProcessingInstruction: Torneu a l'objectiu especificat
- XmlComment: #comentari
- XmlDocument: #document
- XmlDocumentType: nom doctype
nodeValue
Cadena, retorna el nom del node, segons el seu tipus
1String XmlElement.nodeValue;
El nodeName de diferents objectes retornarà diferents valors:
- XmlElement: nul
- XmlAttr: El valor de l'atribut
- XmlText: El contingut del node
- XmlCDATASection: El contingut del node
- XmlProcessingInstruction: Retorna les dades de contingut especificades
- XmlComment: Text de comentari
- XmlDocument: nul
- XmlDocumentType: nul
ownerDocument
XmlDocument, Retorna l'element arrel del node (XmlDocument Objecte)
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;
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 abans d’un determinat node (al mateix nivell d’arbre), si no hi ha aquest node, l’atribut torna nul
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, la propietat torna nul
1readonly XmlNode XmlElement.nextSibling;
Funció de membre
getAttribute
Consulteu el valor d'un atribut per nom
1String XmlElement.getAttribute(String name);
Paràmetres de trucada:
- name: Cadena, especifiqueu el nom de la propietat de la consulta
Resultat de retorn:
- String, Retorna el valor de l'atribut
getAttributeNS
Obteniu el valor de l'atribut per URI i nom de l'espai de noms
1
2String XmlElement.getAttributeNS(String namespaceURI,
String localName);
Paràmetres de trucada:
- namespaceURI: Cadena, especifiqueu l’URI de l’espai de noms de la consulta
- localName: Cadena, especifiqueu el nom de la propietat de la consulta
Resultat de retorn:
- String, Retorna el valor de l'atribut
setAttribute
Creeu o canvieu una propietat nova
1
2XmlElement.setAttribute(String name,
String value);
Paràmetres de trucada:
- name: Cadena, especifiqueu el nom de la propietat que voleu establir
- value: Cadena, especifiqueu el valor de l'atribut que cal establir
Aquest mètode estableix l'atribut especificat al valor especificat. Si no hi ha cap atribut amb el nom especificat, el mètode crearà un atribut nou
setAttributeNS
Crear o canviar atributs amb espai de noms
1
2
3XmlElement.setAttributeNS(String namespaceURI,
String qualifiedName,
String value);
Paràmetres de trucada:
- namespaceURI: Cadena, especifiqueu l’URI de l’espai de noms que cal establir
- qualifiedName: Cadena, especifiqueu el nom de la propietat que voleu establir
- value: Cadena, especifiqueu el valor de l'atribut que cal establir
Aquest mètode és similar al mètode setAttribute, excepte que l'atribut que cal crear o establir està especificat per l'URI de l'espai de noms i el nom qualificat (que consisteix en el prefix de l'espai de noms, els dos punts i el nom local a l'espai de noms). A més de canviar el valor d'un atribut, l'ús d'aquest mètode també pot canviar el prefix de l'espai de noms de l'atribut
removeAttribute
Suprimiu l'atribut especificat per nom
1XmlElement.removeAttribute(String name);
Paràmetres de trucada:
- name: Cadena, especifiqueu el nom de l'atribut suprimit
removeAttributeNS
Suprimiu els atributs especificats per nom i espai de noms
1
2XmlElement.removeAttributeNS(String namespaceURI,
String localName);
Paràmetres de trucada:
- namespaceURI: Cadena, especifiqueu l'URI de l'espai de noms que voleu suprimir
- localName: Cadena, especifiqueu el nom de l'atribut suprimit
hasAttribute
Consulteu si el node actual té un atribut amb el nom especificat
1Boolean XmlElement.hasAttribute(String name);
Paràmetres de trucada:
- name: Cadena, especifiqueu el nom de l'atribut de la consulta
Resultat de retorn:
- Boolean, Si el node de l'element actual té l'atribut especificat, torna true, en cas contrari, torna false
hasAttributeNS
Consulteu si el node actual té atributs de l'espai de noms i el nom especificats
1
2Boolean XmlElement.hasAttributeNS(String namespaceURI,
String localName);
Paràmetres de trucada:
- namespaceURI: Cadena, especifiqueu l’URI de l’espai de noms que voleu consultar
- localName: Cadena, especifiqueu el nom de l'atribut de la consulta
Resultat de retorn:
- Boolean, Si el node de l'element actual té l'atribut especificat, torna true, en cas contrari, torna false
getElementsByTagName
Retorna tots els elements amb el nom especificat XmlNodeList
1XmlNodeList 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
Resultat de retorn:
- XmlNodeList, Del node XmlElement amb la marca especificada a l'arbre del node XmlNodeListreunir. L'ordre dels nodes d'elements retornats és l'ordre en què apareixen al document d'origen.
Aquest mètode recorrerà els descendents de l'element especificat i retornarà un node XmlElement XmlNodeListObjecte, que significa 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.
XmlDocument La interfície també defineix el mètode getElementsByTagName, que és similar a aquest mètode, però recorre tot el document en lloc de recórrer els descendents d'un element.
getElementsByTagNameNS
Retorna tots els elements amb l'espai de noms i el nom especificats XmlNodeList
1
2XmlNodeList XmlElement.getElementsByTagNameNS(String namespaceURI,
String localName);
Paràmetres de trucada:
- namespaceURI: Cadena, especifiqueu l’URI de l’espai de noms que voleu consultar
- localName: String, el nom de l'etiqueta que s'ha de recuperar. El valor "*" coincideix amb totes les etiquetes
Resultat de retorn:
- XmlNodeList, Del node XmlElement amb la marca especificada a l'arbre del node XmlNodeListreunir. L'ordre dels nodes d'elements retornats és l'ordre en què apareixen al document d'origen.
Aquest mètode és similar al mètode getElementsByTagName, tret 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
1XmlElement XmlElement.getElementById(String id);
Paràmetres de trucada:
- id: Cadena, identificador que s'ha de recuperar
Resultat de retorn:
- XmlElement, Node XmlElement amb l'atribut id especificat a l'arbre del node
Aquest mètode recorrerà els nodes descendents de l'element especificat i retornarà un objecte de node XmlElement que representi el primer element de document amb l'atribut id especificat. .
XmlDocument La interfície també defineix el mètode getElementsByTagName, que és similar a aquest mètode, però recorre tot el document en lloc de recórrer els descendents d'un element.
getElementsByClassName
Retorna una llista de nodes de tots els elements amb el nom de classe especificat
1XmlNodeList XmlElement.getElementsByClassName(String className);
Paràmetres de trucada:
- className: String, el nom de la classe que es recuperarà
Resultat de retorn:
- XmlNodeList, El node XmlElement amb el nom de classe especificat a l'arbre del document XmlNodeListreunir. L'ordre dels nodes d'elements retornats és l'ordre en què apareixen al document d'origen.
Aquest mètode retornarà un fitxer XmlNodeList Objecte (es pot tractar com una matriu de només lectura). Aquest objecte 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 d'origen. XmlNodeList L'objecte és "actiu", és a dir, si s'afegeix o elimina un element amb el nom d'etiqueta especificat al document, el seu contingut s'actualitzarà automàticament segons sigui necessari.
hasChildNodes
Consulteu si hi ha nodes secundaris
1Boolean XmlElement.hasChildNodes();
Resultat de retorn:
- Boolean, Torneu a true si hi ha nodes secundaris, en cas contrari, torneu a false
normalize
Combineu els nodes de text adjacents i suprimiu els nodes de text buits
1XmlElement.normalize();
Aquest mètode recorrerà tots els nodes descendents del node actual i normalitzarà el document suprimint el node de text buit 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
Creeu una còpia exacta del node especificat
1XmlNode XmlElement.cloneNode(Boolean deep = true);
Paràmetres de trucada:
- deep: Booleà, si voleu copiar en profunditat, quan és cert, el node clonat clonarà tots els nodes fills del node original
Resultat de retorn:
- XmlNode, Retorna el node copiat
Aquest mètode copiarà i retornarà una còpia del node que l’ha anomenat. Si el paràmetre que se li passa és cert, també copiarà recursivament tots els 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 copiï el node Element, es copiaran tots els seus atributs.
lookupPrefix
Retorna el prefix que coincideix amb l'URI de l'espai de noms especificat al node actual
1String XmlElement.lookupPrefix(String namespaceURI);
Paràmetres de trucada:
- namespaceURI: Cadena, especifiqueu l'URI de l'espai de noms coincident
Resultat de retorn:
- String, Retorna el prefix coincident, torna nul si no coincideix
lookupNamespaceURI
Retorna l'URI de l'espai de noms que coincideix amb el prefix especificat al node actual
1String XmlElement.lookupNamespaceURI(String prefix);
Paràmetres de trucada:
- prefix: Cadena, especifiqueu el prefix coincident
Resultat de retorn:
- String, Retorna l'URI de l'espai de noms coincident, torna nul si no coincideix
insertBefore
Inseriu un node fill nou abans del node fill existent
1
2XmlNode XmlElement.insertBefore(XmlNode newChild,
XmlNode refChild);
Paràmetres de trucada:
Resultat de retorn:
- XmlNode, Retorna el nou node fill
Si newChild ja existeix a l'arbre del document, se suprimirà de l'arbre del document i es reintroduirà a la nova posició. Els nodes d'un document (o nodes creats per un document) no es poden inserir en un altre document. En altres paraules, la propietat ownerDocument de newChild ha de ser la mateixa que la propietat ownerDocument del node actual.
insertAfter
Inseriu un node fill nou després del node fill existent
1
2XmlNode XmlElement.insertAfter(XmlNode newChild,
XmlNode refChild);
Paràmetres de trucada:
Resultat de retorn:
- XmlNode, Retorna el nou node fill
Si newChild ja existeix a l'arbre del document, se suprimirà de l'arbre del document i es reintroduirà a la nova posició. Els nodes d'un document (o nodes creats per un document) no es poden inserir en un altre document. En altres paraules, la propietat ownerDocument de newChild ha de ser la mateixa que la propietat ownerDocument del node actual.
appendChild
Afegiu un node fill nou al final de la llista de nodes fills del node
1XmlNode XmlElement.appendChild(XmlNode newChild);
Paràmetres de trucada:
- newChild: XmlNode, Especifiqueu el node afegit
Resultat de retorn:
- XmlNode, Retorna aquest nou node fill
Si newChild ja existeix a l'arbre del document, se suprimirà de l'arbre del document i es reintroduirà a la nova posició. Els nodes d'un document (o nodes creats per un document) no es poden inserir en un altre document. En altres paraules, la propietat ownerDocument de newChild ha de ser la mateixa que la propietat ownerDocument del node actual.
replaceChild
Substitueix un node fill per un altre
1
2XmlNode XmlElement.replaceChild(XmlNode newChild,
XmlNode oldChild);
Paràmetres de trucada:
Resultat de retorn:
- XmlNode, Si la substitució és correcta, aquest mètode pot retornar el node substituït; si la substitució falla, torna nul
Si newChild ja existeix a l'arbre del document, se suprimirà de l'arbre del document i es reintroduirà a la nova posició. Els nodes d'un document (o nodes creats per un document) no es poden inserir en un altre document. En altres paraules, la propietat ownerDocument de newChild ha de ser la mateixa que la propietat ownerDocument del node actual.
removeChild
Elimineu un node de la llista de nodes secundaris
1XmlNode XmlElement.removeChild(XmlNode oldChild);
Paràmetres de trucada:
- oldChild: XmlNode, Especifiqueu el node a suprimir
Resultat de retorn:
- XmlNode, Si la supressió és correcta, aquest mètode pot retornar el node suprimit; si falla, torna nul
toString
Retorna la representació de cadena de l'objecte, generalment retorna "[Objecte natiu]", l'objecte es pot tornar a implementar segons les seves pròpies característiques
1String XmlElement.toString();
Resultat de retorn:
- String, Retorna la representació de cadena de l'objecte
toJSON
Retorna la representació en format JSON de l'objecte, generalment retorna una col·lecció d'atributs llegibles definits per l'objecte
1Value XmlElement.toJSON(String key = "");
Paràmetres de trucada:
- key: Cadena, sense utilitzar
Resultat de retorn:
- Value, Retorna un valor que conté JSON serialitzable