XML DOM - ElementObjeto


Objeto Element

El objeto Element representa un elemento en un documento XML. Los elementos pueden contener atributos, otros elementos o texto. Si un elemento contiene texto, ese texto se representa en un nodo de texto.

Puntos importantes:El texto siempre se almacena en nodos de texto. Un error común en el procesamiento del DOM es navegar a un nodo de elemento y pensar que este nodo contiene texto. Sin embargo, incluso el nodo de elemento más simple tiene un nodo de texto debajo. Por ejemplo, en <year>2005</year>, hay un nodo de elemento (year), y debajo de este nodo existe un nodo de texto que contiene el texto (2005).

Dado que el objeto Element también es un nodo, puede heredar las propiedades y métodos del objeto Node.

Propiedades del objeto Element

Propiedad Descripción
attributes Devuelve un NamedNodeMap de los atributos del elemento.
baseURI Devuelve el URI base absoluto del elemento.
childNodes Devuelve una NodeList de los nodos hijos del elemento.
firstChild Devuelve el primer nodo hijo del elemento.
lastChild Devuelve el último nodo hijo del elemento.
localName Devuelve la parte local del nombre del elemento.
namespaceURI Devuelve el URI de espacio de nombres del elemento.
nextSibling Devuelve el nodo inmediatamente siguiente al elemento.
nodeName Devuelve el nombre del nodo, según su tipo.
nodeType Devuelve el tipo de nodo.
ownerDocument Devuelve el elemento raíz (objeto document) al que pertenece el elemento.
parentNode Devuelve el nodo padre del elemento.
prefix Establece o devuelve el prefijo de espacio de nombres del elemento.
previousSibling Devuelve el nodo inmediatamente anterior al elemento.
schemaTypeInfo Devuelve la información de tipo asociada con el elemento.
tagName Devuelve el nombre del elemento.
textContent Establece o devuelve el contenido de texto del elemento y sus descendientes.

Métodos del objeto Element

Método Descripción
appendChild() Agrega un nuevo nodo hijo al final de la lista de nodos hijos del nodo.
cloneNode() Clona un nodo.
compareDocumentPosition() Compara la posición en el documento de dos nodos.
getAttribute() Devuelve el valor de un atributo.
getAttributeNS() Devuelve el valor de un atributo (con espacio de nombres).
getAttributeNode() Devuelve el nodo de atributo como un objeto Attribute.
getAttributeNodeNS() Devuelve el nodo de atributo como un objeto Attribute (con espacio de nombres).
getElementsByTagName() Devuelve una NodeList de los nodos de elemento que coinciden y sus nodos hijos.
getElementsByTagNameNS() Devuelve una NodeList de los nodos de elemento que coinciden (con espacio de nombres) y sus nodos hijos.
getFeature(feature,version) Devuelve un objeto DOM que puede ejecutar una API especializada con la característica y versión especificadas.
getUserData(key) Devuelve el objeto asociado con una clave en el nodo. Este objeto debe establecerse primero en este nodo llamando a setUserData con la misma clave.
hasAttribute() Devuelve si el elemento tiene un atributo que coincida con el nombre especificado.
hasAttributeNS() Devuelve si el elemento tiene un atributo que coincida con el nombre y el espacio de nombres especificados.
hasAttributes() Devuelve si el elemento tiene atributos.
hasChildNodes() Devuelve si el elemento tiene nodos hijos.
insertBefore() Inserta un nuevo nodo hijo antes de un nodo hijo existente.
isDefaultNamespace(URI) Devuelve si el namespaceURI especificado es el predeterminado.
isEqualNode() Comprueba si dos nodos son iguales.
isSameNode() Comprueba si dos nodos son el mismo nodo.
isSupported(feature,version) Devuelve si la característica especificada está soportada en este elemento.
lookupNamespaceURI() Devuelve el URI de espacio de nombres que coincide con el prefijo especificado.
lookupPrefix() Devuelve el prefijo que coincide con el URI de espacio de nombres especificado.
normalize() Coloca todos los nodos de texto bajo el nodo (incluidos los atributos) en un formato "estándar", en el que solo la estructura (como elementos, comentarios, instrucciones de procesamiento, secciones CDATA y referencias a entidades) separa los nodos de texto, de modo que no haya nodos de texto adyacentes ni nodos de texto vacíos.
removeAttribute() Elimina el atributo especificado.
removeAttributeNS() Elimina el atributo especificado (con espacio de nombres).
removeAttributeNode() Elimina el nodo de atributo especificado.
removeChild() Elimina un nodo hijo.
replaceChild() Reemplaza un nodo hijo.
setUserData(key,data,handler) Asocia un objeto a una clave en el elemento.
setAttribute() Agrega un nuevo atributo.
setAttributeNS() Agrega un nuevo atributo (con espacio de nombres).
setAttributeNode() Agrega un nuevo nodo de atributo.
setAttributeNodeNS(attrnode) Agrega un nuevo nodo de atributo (con espacio de nombres).
setIdAttribute(name,isId) Si la propiedad isId del objeto Attribute es true, este método declarará el atributo especificado como un atributo de ID determinado por el usuario (user-determined ID attribute).
setIdAttributeNS(uri,name,isId) Si la propiedad isId del objeto Attribute es true, este método declarará el atributo especificado como un atributo de ID determinado por el usuario (user-determined ID attribute) (con espacio de nombres).
setIdAttributeNode(idAttr,isId) Si la propiedad isId del objeto Attribute es true, este método declarará el atributo especificado como un atributo de ID determinado por el usuario (user-determined ID attribute).

Otras extensiones