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