Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

Element

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 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 Somente leitura

Retorna um Number representando a altura interna do elemento.

Element.clientLeft Somente leitura

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

Element.clientTop Somente leitura

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

Element.clientWidth 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

É 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

É 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 Somente leitura

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

Element.scrollLeft

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

Element.scrollLeftMax Somente leitura

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

Element.scrollTop

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

Element.scrollTopMax Somente leitura

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

Element.scrollWidth Somente leitura

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

Element.shadowRoot Somente leitura

...

Element.tagName Somente leitura

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

Element.undoManager Somente leitura

Retorna o UndoManager associado com o elemento.

Element.undoScope

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

Manipuladores de Eventos

Element.ongotpointercapture

Element.onlostpointercapture

Element.onwheel

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()

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()

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()

...

Element.findAll()

...

Animatable.getAnimationPlayers()

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()

...

Element.getClientRects() 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()

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

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

Element.matches()

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

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()

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

Element.requestPointerLock()

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

Element.scrollIntoView()

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()

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