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

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

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

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;

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.

1
String 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 fills del node element; en configurar-los, suprimiu tots els nodes fills i substituïu-los per l'HTML especificat després de descodificar-los.

1
String XmlElement.innerHTML;

className

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

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

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

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

1
String 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
2
String 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
2
XmlElement.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
3
XmlElement.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

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

1
Boolean 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
2
Boolean 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

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

Resultat de retorn:

XmlNodeList, Del node XmlElement amb la marca especificada a l'arbre del node XmlNodeListconjunt. 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
2
XmlNodeList 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 XmlNodeListconjunt. 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

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

1
XmlNodeList 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 XmlNodeListconjunt. 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

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

1
XmlNode 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 d'espai de noms especificat al node actual

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

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

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 seva 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
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

Resultat de retorn:

XmlNode, Retorna el nou node fill

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

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 un nou node
oldChild: XmlNode, Especifiqueu el node a substituir

Resultat de retorn:

XmlNode, Si la substitució és correcta, aquest mètode pot retornar el node substituït; si la substitució falla, torna nul

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

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

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

Paràmetres de trucada:

key: Cadena, sense utilitzar

Resultat de retorn:

Value, Retorna un valor que conté JSON serialitzable

Guia de desenvolupament

Mòdul bàsic

Objectes incorporats

Mòdul de comunitat

Objecte XmlElement

Herència

Atributs de membre

namespaceURI

prefix

localName

tagName

id

textContent

innerHTML

className

attributes

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

firstChild

lastChild

previousSibling

nextSibling

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