Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de MDN Web Docs.
element
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.
* Some parts of this feature may have varying levels of support.
Este capítulo proporciona una breve explicación para los métodos generales, las propiedades y los eventos disponibles para los elementos HTML y XML en el DOM de Gecko.
Varias especificaciones aplicadas a los elementos:
- Especificaciones esenciales del DOM —describe las interfaces esenciales compartidas por la mayoría de los objetos DOM en los documentos HTML y XML.
- Especificaciones HTML del DOM —describe las interfaces para objetos en documentos HTML y XHTML construidos con la especificación base.
- Especificiones de los eventos DOM —describe los eventos compartidos por la mayoría de objetos DOM, construidos con las especificaciones y base DOMOpiniones.
Los artículos listados aquí amplían lo antedicho e incluyen enlaces a la especificación apropiada del DOM de W3C.
Mientras que estas interfaces son generalmente compartidas por la mayoría de los elementos HTML y XML, hay muchas más especiales para los objetos particulares listados en la especificación HTML del DOM —por ejemplo las interfaces delelemento tabla de HTML yelemento formulario de HTML.
Propiedades
| Nombre | Descripción | Tipo | Disponibilidad |
|---|---|---|---|
attributes | Todos los atributos asociados a un elemento. | NamedNodeMap | paratodos |
childNodes | Todos los nodos hijos de un elemento. | Listado de nudo | paratodos |
className | La clase del elemento. | Secuencia | paraHTML,XUL |
clientHeight | El alto interior del elemento. | Número | paraHTML |
clientWidth | El ancho interior del elemento. | Número | paraHTML |
dir | La direccionalidad del elemento. | Secuencia | paraHTML,XUL |
firstChild | El primer hijo directo del elemento,null si no hay. | Nudo | paratodos |
id | La identificación del elemento. | Secuencia | paraHTML,XUL |
innerHTML | El contenido y el código que hay dentro del elemento. | Secuencia | paraHTML |
lang | El lenguaje de los atributos, texto y contenidos del elemento. | Secuencia | paraHTML |
lastChild | El último hijo directo del elemento,null si no hay. | Node | paratodos |
localName | La parte local del nombre cualificado del elemento. | Secuencia | paratodos |
| Nombre | Descripción | Tipo | Disponibilidad |
name | El nombre del elemento. | Secuencia | paraHTML |
namespaceURI | El URI del espacio de nombre de ese nodo,null si no está especificado. | Secuencia | paratodos |
nextSibling | El nodo inmediatamente posterior al primero dado en el árbol,null si no hay. | Nudo | paratodos |
nodeName | El nombre del nodo de ese elemento. | Secuencia | paratodos |
nodeType | Un número que representa el tipo del nodo. Lo mismo que1 para los elementos DOM. | Número | paratodos |
nodeValue | El valor del nodo. Lo mismo quenull para los elementos DOM. | Secuencia | paratodos |
offsetHeight | El alto de un elemento, tal cual está escrito en la composición. | Número | paraHTML |
offsetLeft | La distancia que hay desde el borde izquierdo del elemento al de suoffsetParent. | Número | paraHTML |
offsetParent | El elemento del cual todos los cálculos de distancia son actualmente computados. | Elemento | paraHTML |
offsetTop | La distancia desde el borde superior del elemento hasta el de suoffsetParent. | Número | paraHTML |
offsetWidth | El ancho de un elemento, tal cual está escrito en la composición. | Número | paraHTML |
ownerDocument | El documento en el cual está ese nodo,null si no hay. | Documento | paratodos |
| Nombre | Descripción | Tipo | Disponibilidad |
parentNode | El elemento original(padre) de ese nodo,null si no hay dentro deldocumento de DOM. | Nudo | paratodos |
prefix | El prefijo del espacio de nombre del nodo,null si no está especificado. | Secuencia | paratodos |
previousSibling | El nodo inmediatamente anterior al primero dado en el árbol ,null si no hay. | Nudo | paratodos |
scrollHeight | Muestra la altura de deslizamiento del elemento. | Número | paraHTML |
scrollLeft | Obtiene/establece el offset de scroll izquierdo de un elemento. | Número | paraHTML |
scrollTop | Obtiene/establece el offset de scroll superior de un elemento. | Número | paraHTML |
scrollWidth | Muestra el ancho de deslizamiento de un elemento. | Número | paraHTML |
style | Un objeto representando las declaraciones de los atributos de estilo del elemento. | Estilo CSS | paraHTML,XUL |
tabIndex | Obtiene/establece la posición del elemento en el órden de tabulación. | Número | paraHTML |
tagName | El nombre de la etiqueta para el elemento dado. | Secuencia | paratodos |
textContent | Obtiene/establece los contenidos textuales de un elemento y todos sus descendentes. | Secuencia | paratodos |
Métodos
| Nombre y Descripción | Devuelve | Disponible |
|---|---|---|
addEventListener (type,handler,bubble)Registra un controlador de evento para un tipo de evento específico en un elemento. | - | Todos |
appendChild(appendedNode )Inserta un nodo así como el último nodo hijo de este elemento. | Node | Todos |
blur()Quita el foco del teclado del elemento actual. | - | paraHTML,XUL |
click()Simula un clic sobre el elemento actual. | - | paraHTML,XUL |
cloneNode(deep)Hace copia de un nudo, y opcionalmente, de todo sus contenidos | Node | paraTodos |
dispatchEvent(event )Envía un evento a este nodo en el DOM. | Boolean | Todos |
getAttribute(name )Devuelve el valor de un atributo nombrado desde el nodo actual. | Object | Todos |
getAttributeNS(namespace,name )Devuelve el valor del atributo con el nombre especificado, desde el nodo actual. | Object | Todos |
getAttributeNode(name )Devuelve la representación del nodo del atributo nombrado desde el nodo actual. | Attr | Todos |
getAttributeNodeNS(namespace,name )Devuelve la representación del nodo del atributo con el nombre especificado, desde el nodo actual. | Attr | Todos |
| Nombre y Descripción | Devuelve | Disponibilidad |
getElementsByTagName(name )Devuelve un conjunto de todos los elementos descendentes, de un nombre de etiqueta particular, desde el elemento actual. | NodeSet | Todos |
getElementsByTagNameNS(namespace,name )Devuelve un conjunto de todos los elementos descendentes, de un nombre de etiqueta y espacio particular, desde el elemento actual. | NodeSet | Todos |
hasAttribute(name )Verifica si el elemento tiene el atributo especificado o no. | Boolean | Todos |
hasAttributeNS(namespace,name )Verifica si el elemento tiene el atributo especificado, en el nombre de espacio especificado o no. | Boolean | Todos |
hasAttributes()Verifica si el elemento tiene o no algún atributo. | Boolean | Todos |
hasChildNodes()Verifica si el elemento tiene nodos hijos o no. | Boolean | Todos |
insertBefore(insertedNode,adjacentNode )Inserta el primer nodo antes que el segundo, Nodo hijo en el DOM. | Node | Todos |
normalize()Limpia todos los nodos de texto debajo de este elemento (une lo adyacente, quita lo vacío). | - | Todos |
removeAttribute(name )Quita el atributo nombrado desde el nodo actual. | - | All |
removeAttributeNS(namespace,name )Quita el atributo con el nombre y nombre de espacio especificado desde el nodo actual. | - | Todos |
| Nombre y Descripción | Devuelve | Disponibilidad |
removeAttributeNode(name )Quita la representación del nodo del atributo nombrado desde el nodo actual. | - | Todos |
removeChild(removedNode )Quita el nodo hijo desde el elemento actual. | Node | Todos |
removeEventListener(type,handler )Quita un oyente de evento desde el elemento. | - | Todos |
replaceChild(insertedNode,replacedNode )Reemplaza un nodo hijo en el elemento actual con otro. | Node | Todos |
scrollIntoView(alignWithTop )Recorre la página hasta que el elemento se obtiene en la vista. | - | HTML |
setAttribute(name,value )Establece el valor de un atributo nombrado desde el nodo actual. | - | Todos |
setAttributeNS(namespace,name,value )Establece el valor del atributo con el nombre y nombre de espacio especificado desde el nodo actual. | - | Todos |
setAttributeNode(name,attrNode )Establece la representación del nodo del atributo nombrado desde el nodo actual. | - | Todos |
setAttributeNodeNS(namespace,name,attrNode )Establece la representación del nodo del atributo con el nombre y nombre de espacio especificado desde el nodo actual. | - | Todos |
Eventos
Son propiedades correspondientes a los atributos del evento "on" en HTML.
A diferencia de los atributos correspondientes, los valores de esas propiedades son funciones (o cualquier otro objeto trabajando con la interfazEventListener) más bien que una cadena de carácteres. En efecto, asignar un atributo de evento en HTML crea una función envolvente alrededor del código especificado. Por ejemplo, el siguiente HTML:
<div>clic aquí!</div>
Sielement es una referencia a estadiv, el valor deelement.onclick será:
function onclick(event) { foo();}El objetoevent es pasado al parámetroevent de esta función envolvente.
- onblur - (al quitar el foco)
Devuelve el código de manejo de evento para el evento
blur.
- onchange - (al modificar)
Devuelve el código de manejo de evento para el evento
change.
- onclick - (al hacer clic)
Devuelve el código de manejo de evento para el evento
onclick.
- ondblclick - (al hacer doble clic)
Devuelve el código de manejo de evento para el evento
ondblclick.
- onfocus - (al poner el foco)
Devuelve el código de manejo de evento para el evento
onfocus.
- onkeydown - (al tener una tecla apretada)
Devuelve el código de manejo de evento para el evento
onkeydown.
- onkeypress - (al apretar una tecla)
Devuelve el código de manejo de evento para el evento
onkeypress.
- onkeyup - (al soltar una tecla)
Devuelve el código de manejo de evento para el evento
onkeyup.
- onmousedown - (al tener el botón del ratón apretado)
Devuelve el código de manejo de evento para el evento
onmousedown.
- onmousemove - (al mover el ratón)
Devuelve el código de manejo de evento para el evento
onmousemove.
- onmouseout - (al quitar el puntero del ratón)
Devuelve el código de manejo de evento para el evento
onmouseout.
- onmouseover - (al pasar el ratón encima)
Devuelve el código de manejo de evento para el evento
onmouseover.
- onmouseup - (al soltar el botón del ratón)
Devuelve el código de manejo de evento para el evento
onmouseup.
- onresize - (al re-dimensionar la pantalla)
Devuelve el código de manejo de evento para el evento
onresize.