ObjetoXmlElemento
Los objetos XmlElement representan elementos en un documento XML
relación de herencia
propiedades de miembros
namespaceURI
Cadena, URI del espacio de nombres del elemento de consulta. Si el nodo seleccionado no tiene espacio de nombres, esta propiedad devuelve NULL
1readonly String XmlElement.namespaceURI;
prefix
Cadena, consulta y establece el prefijo del espacio de nombres del elemento. Si el nodo seleccionado no tiene espacio de nombres, esta propiedad devuelve NULL
1String XmlElement.prefix;
localName
Cadena, el nombre local del elemento de consulta. Si el nodo seleccionado no tiene espacio de nombres, esta propiedad es equivalente a nodeName
1readonly String XmlElement.localName;
tagName
Cadena, devuelve el nombre de la etiqueta del elemento.
1readonly String XmlElement.tagName;
id
Cadena, consulta y establece el atributo de identificación del elemento
1String XmlElement.id;
innerHTML
Encadena, consulta y establece el texto HTML de los descendientes del elemento seleccionado, solo válido en modo html. Al realizar la consulta, devuelva la codificación HTML de todos los nodos secundarios dentro del nodo del elemento; al configurar, elimine todos los nodos secundarios y reemplácelos con la decodificación HTML especificada.
1String XmlElement.innerHTML;
outerHTML
String, consulta el texto HTML del elemento seleccionado y sus descendientes, solo válido en modo html. Al realizar la consulta, devuelva la codificación HTML del elemento y todos los nodos secundarios dentro del nodo.
1readonly String XmlElement.outerHTML;
className
Cadena, consulta y establece el atributo de clase del elemento, solo válido en modo html
1String XmlElement.className;
attributes
XmlNamedNodeMap, devuelve un NamedNodeMap que contiene los atributos del nodo seleccionado. Si el nodo seleccionado no es un elemento, esta propiedad devuelve NULL.
1readonly XmlNamedNodeMap XmlElement.attributes;
nodeType
Entero, devuelve el tipo de nodo del nodo.
1readonly Integer XmlElement.nodeType;
El tipo de nodo de diferentes objetos devolverá valores diferentes:
- XmlElement: ELEMENT_NODE(1)
- XmlAttr:ATTRIBUTE_NODE(2)
- XmlText: TEXTO_NODO(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, devuelve el nombre del nodo, según su tipo
1readonly String XmlElement.nodeName;
El nombre de nodo de diferentes objetos devolverá valores diferentes:
- XmlElement:nombre del elemento
- XmlAttr: Nombre del Atributo
- XmlText: #texto
- XmlCDATASection: #sección-cdata
- XmlProcessingInstruction: Devuelve el objetivo objetivo especificado
- XmlComment: #comentario
- XmlDocument: #documento
- XmlDocumentType: nombre del tipo de documento
nodeValue
String, devuelve el nombre del nodo, según su tipo
1String XmlElement.nodeValue;
El nombre de nodo de diferentes objetos devolverá valores diferentes:
- XmlElement: nulo
- XmlAttr: valor de atributo
- XmlText: el contenido del nodo
- XmlCDATASection: el contenido del nodo
- XmlProcessingInstruction: Devuelve los datos de contenido especificados
- XmlComment: texto de anotación
- XmlDocument: nulo
- XmlDocumentType: nulo
ownerDocument
XmlDocument, devuelve el elemento raíz del nodo (XmlDocumentobjeto)
1readonly XmlDocument XmlElement.ownerDocument;
parentNode
XmlNode, puede devolver el nodo padre de un nodo
1readonly XmlNode XmlElement.parentNode;
childNodes
XmlNodeList, devuelve la lista de nodos secundarios del nodo especificado
1readonly XmlNodeList XmlElement.childNodes;
children
XmlNodeList, devuelve la lista de nodos de los nodos de elementos secundarios del nodo especificado.
1readonly XmlNodeList XmlElement.children;
firstChild
XmlNode, devuelve el primer nodo hijo del nodo
1readonly XmlNode XmlElement.firstChild;
lastChild
XmlNode, devuelve el último nodo hijo del nodo
1readonly XmlNode XmlElement.lastChild;
previousSibling
XmlNode, devuelve el nodo inmediatamente anterior a un nodo (en el mismo nivel de árbol). Si no existe tal nodo, esta propiedad devuelve nulo.
1readonly XmlNode XmlElement.previousSibling;
nextSibling
XmlNode, devuelve el nodo inmediatamente después de un elemento (en el mismo nivel de árbol). Si no existe tal nodo, el atributo devuelve nulo.
1readonly XmlNode XmlElement.nextSibling;
firstElementChild
XmlNode, devuelve el primer nodo elemento hijo del nodo
1readonly XmlNode XmlElement.firstElementChild;
lastElementChild
XmlNode, devuelve el último nodo del elemento hijo del nodo
1readonly XmlNode XmlElement.lastElementChild;
previousElementSibling
XmlNode, devuelve el nodo del elemento inmediatamente anterior a un nodo (en el mismo nivel de árbol). Si no existe tal nodo, esta propiedad devuelve nulo.
1readonly XmlNode XmlElement.previousElementSibling;
nextElementSibling
XmlNode, devuelve el nodo del elemento inmediatamente después de un elemento (en el mismo nivel de árbol). Si no existe tal nodo, el atributo devuelve nulo.
1readonly XmlNode XmlElement.nextElementSibling;
textContent
Cadena, consulta y establece el texto del elemento seleccionado. Al realizar la consulta, devuelve los valores de todos los nodos de texto dentro del nodo del elemento; al configurar, elimina todos los nodos secundarios y los reemplaza con un solo nodo de texto.
1String XmlElement.textContent;
función miembro
getAttribute
Consultar el valor de un atributo por nombre.
1String XmlElement.getAttribute(String name);
Parámetros de llamada:
- name: Cadena, especifica el nombre del atributo de la consulta.
Resultados de devolución:
- String, devuelve el valor del atributo
getAttributeNS
Obtener el valor del atributo por URI de espacio de nombres y nombre
1
2String XmlElement.getAttributeNS(String namespaceURI,
String localName);
Parámetros de llamada:
- namespaceURI: Cadena, que especifica el URI del espacio de nombres de la consulta
- localName: Cadena, especifica el nombre del atributo de la consulta.
Resultados de devolución:
- String, devuelve el valor del atributo
setAttribute
Crear o cambiar una nueva propiedad
1
2XmlElement.setAttribute(String name,
String value);
Parámetros de llamada:
- name: Cadena, especifica el nombre del atributo que se establecerá
- value: Cadena, especifica el valor del atributo que se establecerá
Este método establece la propiedad especificada en el valor especificado. Si una propiedad con el nombre especificado no existe, este método crea una nueva propiedad
setAttributeNS
Crear o modificar propiedades de espacio de nombres
1
2
3XmlElement.setAttributeNS(String namespaceURI,
String qualifiedName,
String value);
Parámetros de llamada:
- namespaceURI: Cadena, especifica el URI del espacio de nombres que se establecerá
- qualifiedName: Cadena, especifica el nombre del atributo que se establecerá
- value: Cadena, especifica el valor del atributo que se establecerá
Este método es similar al método setAttribute, excepto que el atributo que se va a crear o establecer se especifica mediante un URI de espacio de nombres y un nombre calificado que consta de un prefijo de espacio de nombres, dos puntos y un nombre local en el espacio de nombres. Además de cambiar el valor de un atributo, también puede utilizar este método para cambiar el prefijo del espacio de nombres del atributo.
removeAttribute
Eliminar atributo especificado por nombre
1XmlElement.removeAttribute(String name);
Parámetros de llamada:
- name: Cadena, especifica el nombre del atributo que se eliminará
removeAttributeNS
Eliminar propiedades especificadas por espacio de nombres y nombre
1
2XmlElement.removeAttributeNS(String namespaceURI,
String localName);
Parámetros de llamada:
- namespaceURI: Cadena, especifica el URI del espacio de nombres que se eliminará
- localName: Cadena, especifica el nombre del atributo que se eliminará
hasAttribute
Consultar si el nodo actual tiene un atributo con el nombre especificado
1Boolean XmlElement.hasAttribute(String name);
Parámetros de llamada:
- name: Cadena, especifica el nombre del atributo de la consulta.
Resultados de devolución:
- Boolean, si el nodo del elemento actual tiene el atributo especificado, devuelve verdadero; de lo contrario, devuelve falso
hasAttributeNS
Consultar si el nodo actual tiene atributos con el espacio de nombres y el nombre especificados
1
2Boolean XmlElement.hasAttributeNS(String namespaceURI,
String localName);
Parámetros de llamada:
- namespaceURI: Cadena, especifica el URI del espacio de nombres que se consultará
- localName: Cadena, especifica el nombre del atributo de la consulta.
Resultados de devolución:
- Boolean, si el nodo del elemento actual tiene el atributo especificado, devuelve verdadero; de lo contrario, devuelve falso
getElementsByTagName
Devuelve todos los elementos con el nombre especificado.XmlNodeList
1XmlNodeList XmlElement.getElementsByTagName(String tagName);
Parámetros de llamada:
- tagName: Cadena, el nombre de la etiqueta que se recuperará. El valor "*" coincide con todas las etiquetas
Resultados de devolución:
- XmlNodeList, el nodo XmlElement con la etiqueta especificada en el árbol de nodosXmlNodeListrecolectar. El orden de los nodos de elementos devueltos es el orden en que aparecen en el documento fuente.
Este método atravesará los nodos descendientes del elemento especificado y devolverá un nodo XmlElement.XmlNodeListObjeto que representa todos los elementos del documento con el nombre de etiqueta especificado. El orden de los elementos en la matriz devuelta es el orden en que aparecen en el código fuente del documento.
XmlDocumentLa interfaz también define el método getElementsByTagName, que es similar a este método, pero atraviesa todo el documento en lugar de atravesar los nodos descendientes de un elemento.
getElementsByTagNameNS
Devuelve todos los elementos con el espacio de nombres y el nombre especificados.XmlNodeList
1
2XmlNodeList XmlElement.getElementsByTagNameNS(String namespaceURI,
String localName);
Parámetros de llamada:
- namespaceURI: Cadena, especifica el URI del espacio de nombres que se consultará
- localName: Cadena, el nombre de la etiqueta que se recuperará. El valor "*" coincide con todas las etiquetas
Resultados de devolución:
- XmlNodeList, el nodo XmlElement con la etiqueta especificada en el árbol de nodosXmlNodeListrecolectar. El orden de los nodos de elementos devueltos es el orden en que aparecen en el documento fuente.
Este método es similar al método getElementsByTagName, excepto que el nombre de etiqueta del elemento que desea obtener se especifica como una combinación del URI del espacio de nombres y el nombre local definido en el espacio de nombres.
getElementById
Devuelve el elemento con el atributo id especificado
1XmlElement XmlElement.getElementById(String id);
Parámetros de llamada:
- id: Cadena, la identificación que se recuperará
Resultados de devolución:
- XmlElement, el nodo XmlElement con el atributo id especificado en el árbol de nodos
Este método atravesará los nodos descendientes del elemento especificado y devolverá un objeto de nodo XmlElement que representa el primer elemento del documento con el atributo de identificación especificado. .
XmlDocumentLa interfaz también define el método getElementsByTagName, que es similar a este método, pero atraviesa todo el documento en lugar de atravesar los nodos descendientes de un elemento.
getElementsByClassName
Devuelve una lista de nodos de todos los elementos con el nombre de clase especificado
1XmlNodeList XmlElement.getElementsByClassName(String className);
Parámetros de llamada:
- className: Cadena, el nombre de la clase que se recuperará
Resultados de devolución:
- XmlNodeList, el nodo XmlElement con el nombre de clase especificado en el árbol del documentoXmlNodeListrecolectar. El orden de los nodos de elementos devueltos es el orden en que aparecen en el documento fuente.
Este método devolverá unXmlNodeListObjeto (se puede procesar como una matriz de solo lectura), que almacena todos los nodos XmlElement con el nombre de clase especificado en el documento. El orden en que se almacenan es el orden en que aparecen en el documento fuente.XmlNodeListEl objeto está "activo", es decir, si se agrega o elimina un elemento con el nombre de etiqueta especificado en el documento, su contenido se actualizará automáticamente según sea necesario.
hasChildNodes
Consultar si hay nodos secundarios
1Boolean XmlElement.hasChildNodes();
Resultados de devolución:
- Boolean, devuelve verdadero si hay nodos secundarios; de lo contrario, devuelve falso
normalize
Fusionar nodos de texto adyacentes y eliminar nodos de texto vacíos
1XmlElement.normalize();
Este método atravesará todos los nodos descendientes del nodo actual y normalizará el documento eliminando los nodos de Texto vacíos y fusionando todos los nodos de Texto adyacentes. Este método es útil para simplificar la estructura del árbol del documento después de insertar o eliminar nodos.
cloneNode
Crea una copia exacta del nodo especificado.
1XmlNode XmlElement.cloneNode(Boolean deep = true);
Parámetros de llamada:
- deep: booleano, si se realiza una copia profunda; cuando es verdadero, el nodo clonado clonará todos los nodos secundarios del nodo original
Resultados de devolución:
- XmlNode, devuelve el nodo copiado
Este método copiará y devolverá una copia del nodo en el que se llamó. Si el argumento que se le pasa es verdadero, también copiará recursivamente todos los nodos descendientes del nodo actual. De lo contrario, sólo copia el nodo actual. El nodo devuelto no pertenece al árbol del documento y su propiedad parentNode es nula. Cuando se copia un nodo Elemento, se copiarán todas sus propiedades.
lookupPrefix
Devuelve el prefijo que coincide con el URI del espacio de nombres especificado en el nodo actual
1String XmlElement.lookupPrefix(String namespaceURI);
Parámetros de llamada:
- namespaceURI: Cadena, especifica el URI del espacio de nombres coincidente
Resultados de devolución:
- String, devuelve el prefijo coincidente, devuelve nulo si no coincide.
lookupNamespaceURI
Devuelve el URI del espacio de nombres que coincide con el prefijo especificado en el nodo actual
1String XmlElement.lookupNamespaceURI(String prefix);
Parámetros de llamada:
- prefix: Cadena, especifica el prefijo coincidente
Resultados de devolución:
- String, devuelve el URI del espacio de nombres coincidente, devuelve nulo si no coincide.
insertBefore
Insertar un nuevo nodo secundario antes de un nodo secundario existente
1
2XmlNode XmlElement.insertBefore(XmlNode newChild,
XmlNode refChild);
Parámetros de llamada:
Resultados de devolución:
- XmlNode, devuelve el nuevo nodo hijo
Si newChild ya existe en el árbol de documentos, se eliminará del árbol de documentos y se reinsertará en su nueva posición. Los nodos de un documento (o los nodos creados por un documento) no se pueden insertar en otro documento. Es decir, el atributoownerDocument de newChild debe ser el mismo que el atributoownerDocument del nodo actual.
insertAfter
Insertar un nuevo nodo secundario después de un nodo secundario existente
1
2XmlNode XmlElement.insertAfter(XmlNode newChild,
XmlNode refChild);
Parámetros de llamada:
Resultados de devolución:
- XmlNode, devuelve el nuevo nodo hijo
Si newChild ya existe en el árbol de documentos, se eliminará del árbol de documentos y se reinsertará en su nueva posición. Los nodos de un documento (o los nodos creados por un documento) no se pueden insertar en otro documento. Es decir, el atributoownerDocument de newChild debe ser el mismo que el atributoownerDocument del nodo actual.
appendChild
Agrega un nuevo nodo secundario al final de la lista de nodos secundarios de un nodo
1XmlNode XmlElement.appendChild(XmlNode newChild);
Parámetros de llamada:
- newChild:XmlNode, especifique el nodo agregado
Resultados de devolución:
- XmlNode, devuelve este nuevo nodo hijo
Si newChild ya existe en el árbol de documentos, se eliminará del árbol de documentos y se reinsertará en su nueva posición. Los nodos de un documento (o los nodos creados por un documento) no se pueden insertar en otro documento. Es decir, el atributoownerDocument de newChild debe ser el mismo que el atributoownerDocument del nodo actual.
replaceChild
Reemplazar un nodo hijo por otro
1
2XmlNode XmlElement.replaceChild(XmlNode newChild,
XmlNode oldChild);
Parámetros de llamada:
- newChild:XmlNode, especifique el nuevo nodo
- oldChild:XmlNode, especifica el nodo que se va a reemplazar
Resultados de devolución:
- XmlNodeSi el reemplazo es exitoso, este método puede devolver el nodo reemplazado, si el reemplazo falla, devuelve nulo.
Si newChild ya existe en el árbol de documentos, se eliminará del árbol de documentos y se reinsertará en su nueva posición. Los nodos de un documento (o los nodos creados por un documento) no se pueden insertar en otro documento. Es decir, el atributoownerDocument de newChild debe ser el mismo que el atributoownerDocument del nodo actual.
removeChild
Eliminar un nodo de la lista de nodos secundarios
1XmlNode XmlElement.removeChild(XmlNode oldChild);
Parámetros de llamada:
- oldChild:XmlNode, especifica el nodo que se eliminará
Resultados de devolución:
- XmlNodeSi la eliminación es exitosa, este método puede devolver el nodo eliminado, si falla, devuelve nulo.
toString
Devuelve la representación de cadena del objeto. Generalmente, se devuelve "[Objeto nativo]". El objeto se puede volver a implementar de acuerdo con sus propias características.
1String XmlElement.toString();
Resultados de devolución:
- String, devuelve la representación de cadena del objeto
toJSON
Devuelve una representación en formato JSON del objeto, que generalmente devuelve una colección de propiedades legibles definidas por el objeto.
1Value XmlElement.toJSON(String key = "");
Parámetros de llamada:
- key: Cadena, no utilizada
Resultados de devolución:
- Value, devuelve un valor que contiene JSON serializable