Element

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

A interface Element é a classe base mais geral da qual todos os objetos em um Document herda. Ela somente tem métodos e propriedades comuns para todos os tipos de elementos. Mais classes específicas herdam de Element. Por exemplo, a interface HTMLElement é a interface base para elementos HTML, enquanto a interface SVGElement é a base para todos os elementos SVG. A maioria das funcionalidades é especificada mais abaixo da hierarquia de classes.

Linguagens fora do domínio da plataforma da Web, como XUL através da interface XULElement, também implementa Element.

Propriedades

Herda propriedades de seus parentes Node, e seu próprio parente, EventTarget, e implementa aqueles de ParentNode, ChildNode, NonDocumentTypeChildNode, e Animatable.

Element.attributes Somente leitura

Retorna um NamedNodeMap que lista todos os atributos associados ao elemento.

ParentNode.childElementCount

É um Number representando o número de nós filhos que são elementos.

ParentNode.children

É um HTMLCollection ao vivo contendo todos os elementos filhos do elemento, como uma coleção.

Element.classList Somente leitura

Retorna um DOMTokenList contendo a lista de atributos de classe.

Element.className

É um DOMString representando a classe do elemento.

Element.clientHeight Experimental Somente leitura

Retorna um Number representando a altura interna do elemento.

Element.clientLeft Experimental Somente leitura

Retorna um Number representando a largura da borda do elemento..

Element.clientTop Experimental Somente leitura

Retorna um Number representando a largura da borda do topo do elemento.

Element.clientWidth Experimental Somente leitura

Retorna um Number representando a largura interna do elemento.

ParentNode.firstElementChild

É um Element, o primeiro elemento filho direto de um elemento, ou null se o elemento não tem elementos filho.

Element.id

É um DOMString representando o id do elemento.

Element.innerHTML Experimental

É um DOMString representando a marcação do conteúdo do elemento.

ParentNode.lastElementChild

É um Element, o último elemento filho direto de um elemento, ou null se o elemento não tem elementos filho.

NonDocumentTypeChildNode.nextElementSibling

É um Element, o elemento seguido imediatamente do dito na árvore, ou null se não há nó irmão.

Element.outerHTML Experimental

É um DOMString representando a marcação do elemento incluindo seu conteúdo. Quando usado como um setter, substitui o elemento com nós analisados a partir de uma determinada string.

NonDocumentTypeChildNode.previousElementSibling

É um Element, o elemento precedido imediatamente do dito na árvore, ou nulo se não há elemento irmão.

Element.scrollHeight Experimental Somente leitura

Retorna um Number representando a altura da vista de rolagem de um elemento.

Element.scrollLeft Experimental

É um Number representando o deslocamento de rolagem esquerdo do elemento.

Element.scrollLeftMax Non-standard Somente leitura

Retorna um Number representando o deslocamento de rolagem esquerdo máximo possível para o elemento.

Element.scrollTop Experimental

É um Number representando o deslocamento de rolagem superior de um elemento.

Element.scrollTopMax Non-standard Somente leitura

Retorna um Number representando o deslocamento de rolagem máximo superior possível para o elemento.

Element.scrollWidth Experimental Somente leitura

Retorna um Number representando a largura de exibição de rolagem do elemento.

Element.shadowRoot Experimental Somente leitura

...

Element.tagName Somente leitura

Retorna um String com o nome da tag para o elemento em questão.

Element.undoManager Experimental Somente leitura

Retorna o UndoManager associado com o elemento.

Element.undoScope Experimental

É a Boolean indicando se o elemento é um anular hospedagem de escopo, ou não.

Manipuladores de Eventos

Element.ongotpointercapture

Element.onlostpointercapture

Element.onwheel Non-standard

Retorna o código de manipulação de evento para o evento wheel.

Métodos

Herda métodos de seus parentes Node, e seu proprío parente, EventTarget, e implementa aqueles de ParentNode, ChildNode, NonDocumentTypeChildNode, e Animatable.

EventTarget.addEventListener()

Registra um manipulador de evento para um tipo específico de evento no elemento.

Element.closest() Experimental

Retorna o Element, descendente deste elemento(ou este elemento em si), que é o ancestral mais próximo dos elementos selecionados pelos seletores dados no parâmetro.

Element.createShadowRoot() Experimental

EventTarget.dispatchEvent()

Despacha um evento para este nó no DOM e retorna um Boolean que indica que pelo menos um manipulador não o cancelou.

Element.find() Experimental

...

Element.findAll() Experimental

...

Animatable.getAnimationPlayers() Experimental

Element.getAttribute()

Recupera o valor do atributo nomeado do nó atual e o retorna como um Object.

Element.getAttributeNS()

Recupera o valor do atributo com o nome especificado e namespace, do nó atual e o retorna como um Object.

Element.getAttributeNode()

Recupera a representação do nó de um atributo nomeado do nó atual e o retorna como um Attr.

Element.getAttributeNodeNS()

Recupera a representação de nó do atributo com o nome especificado e namespace, do nó atual e o retorna como um Attr.

Element.getBoundingClientRect() Experimental

...

Element.getClientRects() Experimental TYPE of returnvalue????

Retorna uma coleção de retângulos que indicam os retângulos delimitadores para cada linha de texto em um cliente.

Element.getDestinationInsertionPoints() Experimental

Element.getElementsByClassName()

Retorna um HTMLCollection vivo que contêm todos os descendentes do elemento atual que possui a lista de classes dadas no parâmetro.

Element.getElementsByTagName()

Retorna um HTMLCollection vivo contendo todos os elementos descendentes, de uma etiqueta de nome particular, do elemento atual.

Element.getElementsByTagNameNS()

Retorna um HTMLCollection vivo contendo todos os elementos descendentes, de uma etiqueta de nome particular e namespace, do elemento atual.

Element.hasAttribute()

Retorna um Boolean indicando se o elemento tem o atributo especificado ou não.

Element.hasAttributeNS()

Retorna um Boolean indicando se o elemento tem um atributo especificado, no namespace especificado, ou não.

Element.insertAdjacentHTML Experimental

Analisa o texto como HTML ou XML e insere os nós resultantes na árvore em dada posição.

Element.matches() Experimental

Retorna um Boolean indicando se o elemento seria ou não selecionado pelo seletor de string specificada.

Element.querySelector()

Retorna Node...

Element.querySelectorAll

Retorna um NodeList...

Element.releasePointerCapture Experimental

ChildNode.remove()

Remove o elemento da lista de filhos de seu parente.

Element.removeAttribute()

Remove um atributo nomeado do nó atual.

Element.removeAttributeNS()

Remove o atributo com o nome especificado ou namespace, do nó atual.

Element.removeAttributeNode()

Remove a representação do nó do atributo nomeado do nó atual.

EventTarget.removeEventListener()

Remove um ouvinte de eventos do elemento.

Element.requestFullscreen() Experimental

Assíncronamente pede o navegador para fazer o elemento tela cheia.

Element.requestPointerLock() Experimental

Permite assíncronamente pedir pelo apontador para ser bloqueado em um dado elemento.

Element.scrollIntoView() Experimental

Rola a página até que o elemento apareça na visão.

Element.setAttribute()

Define o valor de um atributo nomeado do nó atual.

Element.setAttributeNS()

Define o valor do atributo com o nome especificado e namespace, do nó atual.

Element.setAttributeNode()

Define a representação do nó de um atributo nomeado do nó atual.

Element.setAttributeNodeNS()

Define a representação do nó do atributo com o nome especificado e namespace, do nó atual.

Element.setCapture() Non-standard

Define a captura de evento do mouse, redirecionando todos os eventos de mouse para este elemento.

Element.setPointerCapture()

Especificações

Specification
DOM
# interface-element
Pointer Events
# extensions-to-the-element-interface
Fullscreen API
# api
DOM Parsing and Serialization
# extensions-to-the-element-interface
CSSOM View Module
# extension-to-the-element-interface

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Element
DOMActivate event
Deprecated
DOMMouseScroll event
DeprecatedNon-standard
MozMousePixelScroll event
DeprecatedNon-standard
after
afterscriptexecute event
Non-standard
animate
Implicit to/from keyframes are supported
options.composite parameter
options.id parameter
options.iterationComposite parameter
Experimental
options.pseudoElement parameter
options.rangeEnd parameter
Experimental
options.rangeStart parameter
Experimental
options.timeline parameter
animationcancel event
animationend event
animationiteration event
animationstart event
append
ariaActiveDescendantElement
Experimental
ariaAtomic
ariaAutoComplete
ariaBrailleLabel
ariaBrailleRoleDescription
ariaBusy
ariaChecked
ariaColCount
ariaColIndex
ariaColIndexText
ariaColSpan
ariaControlsElements
Experimental
ariaCurrent
ariaDescribedByElements
Experimental
ariaDescription
ariaDetailsElements
Experimental
ariaDisabled
ariaErrorMessageElements
Experimental
ariaExpanded
ariaFlowToElements
Experimental
ariaHasPopup
ariaHidden
ariaInvalid
ariaKeyShortcuts
ariaLabel
ariaLabelledByElements
Experimental
ariaLevel
ariaLive
ariaModal
ariaMultiLine
ariaMultiSelectable
ariaOrientation
ariaOwnsElements
Experimental
ariaPlaceholder
ariaPosInSet
ariaPressed
ariaReadOnly
ariaRelevant
Non-standard
ariaRequired
ariaRoleDescription
ariaRowCount
ariaRowIndex
ariaRowIndexText
ariaRowSpan
ariaSelected
ariaSetSize
ariaSort
ariaValueMax
ariaValueMin
ariaValueNow
ariaValueText
assignedSlot
attachShadow
options.clonable parameter
options.delegatesFocus parameter
options.serializable parameter
Experimental
attributes
auxclick event
Is a PointerEvent
Experimental
before
beforeinput event
beforematch event
Experimental
beforescriptexecute event
Non-standard
beforexrselect event
Experimental
blur event
checkVisibility
options.checkOpacity parameter
options.checkVisibilityCSS parameter
options.contentVisibilityAuto parameter
options.opacityProperty parameter
options.visibilityProperty parameter
childElementCount
children
classList
className
click event
Is a PointerEvent
Experimental
clientHeight
clientLeft
clientTop
clientWidth
closest
compositionend event
compositionstart event
compositionupdate event
computedStyleMap
contentvisibilityautostatechange event
contextmenu event
Is a PointerEvent
Experimental
copy event
currentCSSZoom
cut event
dblclick event
elementTiming
Experimental
firstElementChild
focus event
focusin event
focusout event
fullscreenchange event
fullscreenerror event
gesturechange event
Non-standard
gestureend event
Non-standard
gesturestart event
Non-standard
getAnimations
getAttribute
getAttributeNS
getAttributeNames
getAttributeNode
getAttributeNodeNS
getBoundingClientRect
getBoxQuads
Experimental
getClientRects
getElementsByClassName
getElementsByTagName
getElementsByTagName("*")
getElementsByTagNameNS
getElementsByTagNameNS(namespaceURI, "*")
getHTML
gotpointercapture event
hasAttribute
hasAttributeNS
hasAttributes
hasPointerCapture
id
innerHTML
Can be set with a TrustedHTML instance
input event
insertAdjacentElement
insertAdjacentHTML
insertAdjacentText
keydown event
keypress event
Deprecated
keyup event
lastElementChild
localName
lostpointercapture event
matches
mousedown event
mouseenter event
mouseleave event
mousemove event
mouseout event
mouseover event
mouseup event
mousewheel event
DeprecatedNon-standard
moveBefore
Experimental
namespaceURI
nextElementSibling
outerHTML
part
paste event
pointercancel event
pointerdown event
pointerenter event
pointerleave event
pointermove event
pointerout event
pointerover event
pointerrawupdate event
Experimental
pointerup event
prefix
prepend
previousElementSibling
querySelector
querySelectorAll
releasePointerCapture
remove
removeAttribute
removeAttributeNS
removeAttributeNode
replaceChildren
replaceWith
requestFullscreen
options.navigationUI parameter
options.screen parameter
Experimental
Returns a Promise
requestPointerLock
options.unadjustedMovement parameter
ExperimentalNon-standard
role
scroll
options.behavior parameter
options.left parameter
options.top parameter
scrollBy
options.behavior parameter
options.left parameter
options.top parameter
scrollHeight
scrollIntoView
options parameter
scrollIntoViewIfNeeded
Non-standard
scrollLeft
scrollLeftMax
Non-standard
scrollTo
options.behavior parameter
options.left parameter
options.top parameter
scrollTop
scrollTopMax
Non-standard
scrollWidth
scroll event
scrollend event
scrollsnapchange event
Experimental
scrollsnapchanging event
Experimental
securitypolicyviolation event
setAttribute
setAttributeNS
setAttributeNode
setAttributeNodeNS
setCapture
DeprecatedNon-standard
setHTMLUnsafe
setPointerCapture
shadowRoot
slot
tagName
toggleAttribute
touchcancel event
touchend event
touchmove event
touchstart event
transitioncancel event
transitionend event
transitionrun event
transitionstart event
webkitmouseforcechanged event
Non-standard
webkitmouseforcedown event
Non-standard
webkitmouseforceup event
Non-standard
webkitmouseforcewillbegin event
Non-standard
wheel event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
User must explicitly enable this feature.
Uses a non-standard name.
Requires a vendor prefix or different name for use.
Has more compatibility info.