element

Este capítulo dispõe uma breve referência para métodos, propriedades, e eventos em geral disponíveis para a maioria dos elementos HTML e XML no DOM Gecko.

Várias especificações W3C se aplicam aos elementos:

DOM Core Specification—descreve as interfaces centrais compartilhadas pela maioria dos objetos DOM em documentos HTML e XML
DOM HTML Specification—descreve interfaces para objetos nos documentos HTML e XHTML que foram contruídas com base nas especificações centrais
DOM Events Specification—descreve eventos compartilhados pela maioria dos objetos DOM, contruídas com base nas especificações DOM Core e Views

Os artigos listados aqui abrangem as especificações acima, bem como incluem links para as especificações W3C apropriadas.

Enquanto estas interfaces são geralmente compartilhadas pela maioria dos elementos HTML e XML, existem interfaces mais especializadas para objetos particulares listados na especificação do DOM HTML—por exemplo, as interfaces HTML Table Element e HTML Form Element

Propriedades

Nome	Descrição	Tipo	Dosponibilidade
`attibutes`	Todos os atributos associados ao elemento	`NamedNodeMap`	All
`childNodes`	Todos os nós-filhos de um elemento.	`NodeList`	All
`className`	Retorna ou define a classe do elemento.	`String`	HTML, XUL
`clientHeight`	A altura interna de um elemento.	`Number`	HTML
`clientLeft`	A largura da borda esquerda de um elemento.	`Number`	HTML
`clientTop`	A largura da borda superior de um elemento.	`Number`	HTML
`clientWidth`	A largura interna de um elemento.	`Number`	HTML
`dir`	Retorna ou define a direcionalidade do elemento.	`String`	HTML, XUL
`firstChild`	O primeiro nó-filho direto de um elemento, ou `null` se o elemento não tem nós-filhos.	`Node`	All
`id`	Retorna ou define o id do elemento.	`String`	HTML, XUL
`innerHTML`	Retorna ou define a marcação e o conteúdo de um elemento.	`String`	HTML
`lang`	Retorna ou define o atributo linguagem de um elemento, texto, e conteúdo do elemento.	`String`	HTML
`lastChild`	O último nó-filho direto de um elemento, ou `null` se o elemento não tem nós-filhos.	`Node`	All
`localName`	A parte local de um nome qualificado de um elemento.	`String`	All
Nome	Descrição	Tipo	Disponibilidade
`name`	Retorna/define o atributo name de um elemento.	`String`	HTML
`namespaceURI`	A URI de namespace do nó, ou `null` se não está especificado.	`String`	All
`nextSibling`	O nó imediatamente seguinte ao dado numa árvore, ou `null` se não existe nó-irmão.	`Node`	All
`nodeName`	O nome do nó.	`String`	All
`nodeType`	Um número representando o tipo do nó. É sempre igual a `1` para elementos DOM.	`Number`	All
`nodeValue`	O valor do nó. É sempre igual a `null` para elementos DOM.	`String`	All
`offsetHeight`	A altura de um elemento, em relação ao layout.	`Number`	HTML
`offsetLeft`	A distância da borda esquerda do elemento para o a borda esquerda do seu `offsetParent`.	`Number`	HTML
`offsetParent`	O elemento para o qual todos cálculos de offset estão atualmente computados.	`Element`	HTML
`offsetTop`	A distância da borda superior do elemento para o a borda superior do seu `offsetParent`.	`Number`	HTML
`offsetWidth`	A largura de um elemento, em relação ao layout.	`Number`	HTML
`ownerDocument`	O documento no qual o nó está, ou `null` se o nó não está dentro de nenhum.	`Document`	All
Nome	Descrição	Tipo	Disponibilidade
`parentNode`	The parent element of this node, or `null` if the node is not inside of a DOM Document.	`Node`	All
`prefix`	The namespace prefix of the node, or `null` if no prefix is specified.	`String`	All
`previousSibling`	The node immediately preceding the given one in the tree, or `null` if there is no sibling node.	`Node`	All
`scrollHeight`	The scroll view height of an element.	`Number`	HTML
`scrollLeft`	Gets/sets the left scroll offset of an element.	`Number`	HTML
`scrollTop`	Gets/sets the top scroll offset of an element.	`Number`	HTML
`scrollWidth`	The scroll view width of an element.	`Number`	HTML
`style`	An object representing the declarations of an element's style attributes.	`CSSStyle`	HTML, XUL
`tabIndex`	Gets/sets the position of the element in the tabbing order.	`Number`	HTML
`tagName`	The name of the tag for the given element.	`String`	All
`textContent`	Gets/sets the textual contents of an element and all its descendants.	`String`	All

Métodos

Nome & Descrição	Retorna	Disponibilidade
`addEventListener( type, listener, useCapture )` Register an event handler to a specific event type on the element.	-	All
`appendChild( appendedNode )` Insert a node as the last child node of this element.	Node	All
`blur()` Removes keyboard focus from the current element.	-	HTML, XUL
`click()` Simulates a click on the current element.	-	HTML, XUL
`cloneNode( deep )` Clone a node, and optionally, all of its contents.	Node	All
`dispatchEvent( event )` Dispatch an event to this node in the DOM.	Boolean	All
`focus()` Gives keyboard focus to the current element.	-	HTML, XUL
`getAttribute( name )` Retrieve the value of the named attribute from the current node.	Object	All
`getAttributeNS( namespace, name )` Retrieve the value of the attribute with the specified name and namespace, from the current node.	Object	All
`getAttributeNode( name )` Retrieve the node representation of the named attribute from the current node.	Attr	All
`getAttributeNodeNS( namespace, name )` Retrieve the node representation of the attribute with the specified name and namespace, from the current node.	Attr	All
Nome & Descrição	Retorna	Disponibilidade
`getElementsByTagName( name )` Retrieve a set of all descendant elements, of a particular tag name, from the current element.	NodeSet	All
`getElementsByTagNameNS( namespace, name )` Retrieve a set of all descendant elements, of a particular tag name and namespace, from the current element.	NodeSet	All
`hasAttribute( name )` Check if the element has the specified attribute, or not.	Boolean	All
`hasAttributeNS( namespace, name )` Check if the element has the specified attribute, in the specified namespace, or not.	Boolean	All
`hasAttributes()` Check if the element has any attributes, or not.	Boolean	All
`hasChildNodes()` Check if the element has any child nodes, or not.	Boolean	All
`insertBefore( insertedNode, adjacentNode )` Inserts the first node before the second, child, Node in the DOM.	Node	All
`normalize()` Clean up all the text nodes under this element (merge adjacent, remove empty).	-	All
`removeAttribute( name )` Remove the named attribute from the current node.	-	All
`removeAttributeNS( namespace, name )` Remove the attribute with the specified name and namespace, from the current node.	-	All
Nome & Descrição	Retorna	Disponibilidade
`removeAttributeNode( name )` Remove the node representation of the named attribute from the current node.	-	All
`removeChild( removedNode )` Removes a child node from the current element.	Node	All
`removeEventListener( type, handler, useCapture )` Removes an event listener from the element.	-	All
`replaceChild( insertedNode, replacedNode )` Replaces one child node in the current element with another.	Node	All
`scrollIntoView( alignWithTop )` Scrolls the page until the element gets into the view.	-	HTML
`setAttribute( name, value )` Set the value of the named attribute from the current node.	-	All
`setAttributeNS( namespace, name, value )` Set the value of the attribute with the specified name and namespace, from the current node.	-	All
`setAttributeNode( name, attrNode )` Set the node representation of the named attribute from the current node.	-	All
`setAttributeNodeNS( namespace, name, attrNode )` Set the node representation of the attribute with the specified name and namespace, from the current node.	-	All

Event Handlers

These are properties that correspond to the HTML 'on' event attributes.

Unlike the corresponding attributes, the values of these properties are functions (or any other object implementing the EventListener interface) rather than a string. In fact, assigning an event attribute in HTML creates a wrapper function around the specified code. For example, given the following HTML:

<div onclick="foo();">click me!</div>

If element is a reference to this div, the value of element.onclick is effectively:

function onclick(event) {
   foo();
}

Note how the event object is passed as parameter event to this wrapper function.

onblur: Returns the event handling code for the blur event.

onchange: Returns the event handling code for the change event.

onclick: Returns the event handling code for the click event.

ondblclick: Returns the event handling code for the dblclick event.

onfocus: Returns the event handling code for the focus event.

onkeydown: Returns the event handling code for the keydown event.

onkeypress: Returns the event handling code for the keypress event.

onkeyup: Returns the event handling code for the keyup event.

onmousedown: Returns the event handling code for the mousedown event.

onmousemove: Returns the event handling code for the mousemove event.

onmouseout: Returns the event handling code for the mouseout event.

onmouseover: Returns the event handling code for the mouseover event.

onmouseup: Returns the event handling code for the mouseup event.

onresize: Returns the event handling code for the resize event.

onscroll: Returns the event handling code for the scroll event.

element

Propriedades

Métodos

Event Handlers

Etiquetas do documento e colaboradores