--- title: element slug: Web/API/Element tags: - API - API da Web - DOM - Element - Elemento - Interface - Referencia - Referência DOM translation_of: Web/API/Element original_slug: DOM/element ---

Element é a classe base mais geral da qual todos os objetos em um {{DOMxRef("Document","documento")}} herdam. Este só tem métodos e propriedades comuns para todos os tipos de elementos. Classes mais específicas herdam de Element. Por exemplo, a interface {{DOMxRef("HTMLElement")}} é a interface base para os elementos HTML, enquanto a interface {{DOMxRef("SVGElement")}} é a base para todos os elementos SVG. A maioria das funcionalidades é especificada mais abaixo na hierarquia de classes.

Linguagens fora do âmbito da plataforma Web, como XUL através da interface XULElement, também implementa Element.

Propriedades

Inherits properties from its parent interface, {{DOMxRef("Node")}}, and by extension that interface's parent, {{DOMxRef("EventTarget")}}. It implements the properties of {{DOMxRef("ParentNode")}}, {{DOMxRef("ChildNode")}}, {{DOMxRef("NonDocumentTypeChildNode")}}, and {{DOMxRef("Animatable")}}.

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.

Propriedades

Métodos

Event Handlers

Compatibilidade de navegador