El 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, el texto se representa en un texto-nodo.
IMPORTANT! El texto se almacena siempre en los nodos de texto. Un error común en el procesamiento DOM es para navegar hasta un nodo elemento y esperar que contiene el texto. Sin embargo, incluso el elemento más simple nodo tiene un nodo de texto debajo de ella. Por ejemplo, en <year>2005</year> , hay un nodo de elemento (year) , y un nodo de texto debajo de ella, que contiene el texto (2005) .
Debido a que el objeto Element es también un nodo, hereda las propiedades y métodos del objeto de nodo.
Propiedades del objeto Element
| Propiedad | Descripción |
|---|---|
| attributes | Devuelve una NamedNodeMap de atributos para el elemento |
| baseURI | Devuelve el URI base absoluta del elemento |
| childNodes | Devuelve un NodeList de los nodos secundarios para el elemento |
| firstChild | Devuelve el primer hijo del elemento |
| lastChild | Devuelve el último hijo del elemento |
| localName | Devuelve la parte local del nombre del elemento |
| namespaceURI | Devuelve el URI de espacio del elemento |
| nextSibling | Devuelve el nodo inmediatamente después del elemento |
| nodeName | Devuelve el nombre del nodo, dependiendo de su tipo |
| nodeType | Devuelve el tipo del nodo |
| ownerDocument | Devuelve el elemento raíz (document object) para un 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 antes del elemento |
| schemaTypeInfo | Devuelve la información de tipo asociado 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() | Añade un nuevo nodo secundario al final de la lista de hijos del nodo |
| cloneNode() | Clones de un nodo |
| compareDocumentPosition() | Compara la posición de documento de dos nodos |
| getAttribute() | Devuelve el valor de un atributo |
| getAttributeNS() | Devuelve el valor de un atributo (with a namespace) |
| getAttributeNode() | Devuelve un nodo de atributo como un atributo de objeto |
| getAttributeNodeNS() | Devuelve un nodo de atributo (with a namespace) como un objeto Atributo |
| getElementsByTagName() | Devuelve un NodeList de hacer coincidir nodos de elementos, y sus hijos |
| getElementsByTagNameNS() | Devuelve un NodeList de hacer coincidir nodos de elemento (with a namespace) , y sus hijos |
| getFeature(feature,version) | Devuelve un objeto DOM que implementa las APIs especializadas de la función y la versión especificada |
| getUserData(key) | Devuelve el objeto asociado a una tecla en un este nodo. El objeto, primero debe haberse establecido en este nodo llamando setUserData con la misma clave |
| hasAttribute() | Devuelve si un elemento tiene atributos que coinciden con un nombre especificado |
| hasAttributeNS() | Devuelve si un elemento tiene atributos que coinciden con un nombre y espacio de nombres especificado |
| hasAttributes() | Devuelve si el elemento tiene algún atributo |
| hasChildNodes() | Devuelve si el elemento tiene nodos secundarios |
| insertBefore() | Inserta un nuevo nodo hijo antes de que un nodo hijo existente |
| isDefaultNamespace(URI) | Devuelve si el namespaceURI especificado es el valor por defecto |
| isEqualNode() | Comprueba si dos nodos son iguales |
| lookupNamespaceURI() | Devuelve el URI de espacio de búsqueda de un prefijo especificado |
| lookupPrefix() | Devuelve el prefijo de búsqueda de un espacio de nombres especificado URI |
| normalize() | Pone todos los nodos de texto debajo de este elemento (including attributes) en un "normal" forma que sólo la estructura (por ejemplo, elementos, comentarios, instrucciones de procesamiento, secciones CDATA y referencias a entidades) separa los nodos de texto, es decir, no hay ni nodos de texto adyacentes ni Los nodos de texto vacíos |
| removeAttribute() | Elimina un atributo especificado |
| removeAttributeNS() | Elimina un atributo especificado (with a namespace) |
| removeAttributeNode() | Elimina un nodo de atributo especificado |
| removeChild() | Elimina un nodo hijo |
| replaceChild() | Sustituye a un nodo hijo |
| setUserData(key,data,handler) | Asocia un objeto a una tecla en el elemento |
| setAttribute() | Añadirá un nuevo atributo |
| setAttributeNS() | Añadirá un nuevo atributo (with a namespace) |
| setAttributeNode() | Añade un nuevo nodo de atributo |
| setAttributeNodeNS(attrnode) | Añade un nuevo nodo de atributo (with a namespace) |
| setIdAttribute(name,isId) | Si la propiedad del objeto isId atributo es true, este método declara el specified el atributo de ser un atributo ID determinada por el usuario |
| setIdAttributeNS(uri,name,isId) | Si la propiedad del objeto isId atributo es true, este método declara el specified atributo (with a namespace) a ser un atributo ID determinada por el usuario |
| setIdAttributeNode(idAttr,isId) | Si la propiedad del objeto isId atributo es true, este método declara el specified el atributo de ser un atributo ID determinada por el usuario |