English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Eventos do HTML DOM

Os eventos DOM são enviados para notificar o código de eventos interessantes ocorrendo.

Os eventos são geralmente usados em conjunto com funcionalidades e não são executadas antes do evento ocorrer (por exemplo, quando o usuário clica em um botão).

O evento pode representar tudo, desde interações básicas do usuário até notificações automáticas de eventos ocorrendo no modelo de apresentação.

Nome do eventoDescriçãoTipo de Evento
abortEste evento ocorre quando a carga do recurso foi interrompidaUiEvent, Event
afterprintEste evento ocorre quando o documento relacionado já começou a ser impresso ou a visualização de impressão foi encerradaEvent
animationendEste evento ocorre quando a animação CSS é concluídaAnimationEvent
animationiterationEste evento ocorre ao repetir a animação CSSAnimationEvent
animationstartEste evento ocorre quando a animação CSS começaAnimationEvent
beforeprintOcorre este evento quando o documento relacionado está prestes a ser impresso ou visualizado para impressãoEvent
beforeunloadOcorre este evento quando a janela, o documento e seus recursos estão prestes a serem desmoldadosUiEvent, Event
blurOcorre este evento quando o elemento perde o foco (não bolha)FocusEvent
canplayOcorre este evento quando o navegador pode começar a reproduzir a mídia (quando tiver suficiente buffer para começar a reprodução)Event
canplaythroughOcorre este evento quando o navegador pode reproduzir a mídia sem parar a bufferEvent
changeOcorre este evento quando o conteúdo do estado de seleção ou seleção de um elemento de formulário muda (para <input>, <select> e <textarea>)Event
clickOcorre um evento quando o usuário clica no elementoMouseEvent
contextmenuOcorre este evento quando o usuário clica com o botão direito em algum elemento para abrir o menu de contextoMouseEvent
copyOcorre este evento quando o usuário copia o conteúdo do elementoClipboardEvent
cutOcorre este evento quando o usuário corta o conteúdo do elementoClipboardEvent
dblclickOcorre um evento quando o usuário double-clique no elementoMouseEvent
dragOcorre um evento durante a arrastar do elementoDragEvent
dragendOcorre este evento quando o usuário termina de arrastar o elementoDragEvent
dragenterOcorre um evento quando o elemento arrastado entra no destino de largadaDragEvent
dragleaveOcorre um evento quando o elemento arrastado sai do destino de largadaDragEvent
dragoverOcorre um evento quando o elemento arrastado está acima do destino de largadaDragEvent
dragstartOcorre este evento quando o usuário começa a arrastar o elementoDragEvent
dropOcorre um evento quando o elemento arrastado é colocado no destino de largadaDragEvent
durationchangeOcorre este evento quando a duração da mídia é alteradaEvent
endedEste evento ocorre quando a mídia é reproduzida até o final (útil para mensagens como 'Obrigado por ouvir')Event
errorOcorre quando a carga do recurso falhaProgressEvent, UiEvent, Event
focusOcorre um evento quando o elemento já possui o foco (não bolha)FocusEvent
focusinEste evento ocorre quando algum elemento está prestes a ganhar o focoFocusEvent
focusoutEste evento ocorre quando algum elemento está prestes a perder o focoFocusEvent
fullscreenchangeOcorre um evento ao exibir o elemento em modo de tela cheiaEvent
fullscreenerrorOcorre este evento quando o elemento não pode ser exibido em modo de tela cheiaEvent
hashchangeEste evento ocorre quando a parte de âncora da URL mudaHashChangeEvent
inputOcorre um evento quando o elemento recebe entrada do usuárioInputEvent, Event
invalidOcorre quando o elemento está inválidoEvent
keydownEste evento ocorre quando o usuário pressiona uma teclaKeyboardEvent
keypressOcorre um evento quando o usuário pressiona uma teclaKeyboardEvent
keyupO evento ocorre quando o usuário solta uma tecla.KeyboardEvent
loadO evento ocorre quando o objeto já foi carregado.UiEvent, Event
loadeddataO evento ocorre ao carregar dados de mídia.Event
loadedmetadataO evento ocorre ao carregar metadados (como dimensões e duração).Event
loadstartO evento ocorre quando o navegador começa a buscar o mídia especificado.ProgressEvent
messageO evento ocorre ao receber uma mensagem da fonte do evento.Event
mousedownO evento ocorre quando o usuário pressiona o botão do mouse em um elemento.MouseEvent
mouseenterO evento ocorre quando o ponteiro move para um elemento.MouseEvent
mouseleaveO evento ocorre quando o ponteiro sai de um elemento.MouseEvent
mousemoveO evento ocorre quando o ponteiro move sobre um elemento.MouseEvent
mouseoverO evento ocorre quando o ponteiro move para um elemento ou um de seus elementos filhos.MouseEvent
mouseoutO evento ocorre quando o ponteiro do mouse sai de um elemento ou de um de seus elementos filhos.MouseEvent
mouseupO evento ocorre quando o usuário solta o botão do mouse em um elemento.MouseEvent
mousewheelNão recomendado.Use o evento wheel.WheelEvent
offlineO evento ocorre quando o navegador começa a trabalhar offline.Event
onlineO evento ocorre quando o navegador começa a trabalhar online.Event
openO evento ocorre ao abrir a conexão com a fonte do evento.Event
pagehideO evento ocorre quando o usuário sai da navegação na página.PageTransitionEvent
A página é exibidaO evento ocorre quando o usuário navega para a página da web.PageTransitionEvent
pasteO evento ocorre quando o usuário cola algum conteúdo em um elemento.ClipboardEvent
pauseO evento ocorre quando o usuário ou o código pausa o mídia.Event
playO evento ocorre quando o mídia começa ou deixou de pausar.Event
playingO evento ocorre ao reproduzir o mídia após pausar ou parar a bufferização.Event
popstateO evento ocorre quando a história da janela muda.PopStateEvent
progressO evento ocorre enquanto o navegador está obtendo dados de mídia (baixando mídia).Event
ratechangeO evento ocorre ao alterar a velocidade de reprodução do mídia.Event
resizeO evento ocorre ao ajustar o tamanho da visualização do documento.UiEvent, Event
resetO evento ocorre ao redefinir o formulário.Event
scrollO evento ocorre ao rolar a barra de rolagem de um elemento.UiEvent, Event
searchO evento ocorre quando o usuário digita conteúdo no campo de pesquisa (para <input="search">).Event
seekedQuando o usuário completa o movimento/O evento ocorre ao saltar para uma nova posição no mídia.Event
seekingQuando o usuário começa a mover/O evento ocorre ao saltar para uma nova posição no mídia.Event
selectO evento ocorre após o usuário selecionar algum texto (para <input> e <textarea>).UiEvent, Event
showEste evento ocorre quando o elemento <menu> é exibido como um menu de contextoEvent
stalledEste evento ocorre quando o navegador tenta obter dados de mídia, mas os dados não estão disponíveisEvent
storageEste evento ocorre ao atualizar a área de armazenamento da WebStorageEvent
submitEste evento ocorre quando o formulário é submetidoEvent
suspendEste evento ocorre quando o navegador decide não obter dados de mídiaEvent
timeupdateEste evento ocorre quando a posição de reprodução muda (por exemplo, quando o usuário avança rapidamente para outro ponto no mídia)Event
toggleEste evento ocorre quando o usuário abre ou fecha o elemento <details>Event
touchcancelEste evento ocorre quando o toque é interrompidoTouchEvent
touchendEste evento ocorre quando o dedo é removido da tela do toqueTouchEvent
touchmoveEste evento ocorre quando o dedo é arrastado na telaTouchEvent
touchstartEste evento ocorre quando o dedo é colocado na tela do toqueTouchEvent
transitionendEste evento ocorre quando a conversão CSS é concluídaTransitionEvent
unloadEste evento ocorre quando o documento ou recursos dependentes são desmontadosUiEvent, Event
volumechangeEste evento ocorre quando o volume do mídia é alterado (inclusive ao definir o volume como 'mudo')Event
waitingEste evento ocorre quando o mídia é pausado, mas está esperando para ser restaurado (por exemplo, quando o mídia é pausado para carregar mais dados)Event
wheelEste evento ocorre quando a roda do mouse é rolada para cima ou para baixo no elementoWheelEvent

Atributos do evento HTML DOM

A tabela a seguir lista os atributos do evento DOM:

AtributosDescriçãoTipo de Evento
altKeyRetorna se a tecla 'ALT' foi pressionada ao ativar o evento do mouseMouseEvent
altKeyRetorna se a tecla 'ALT' foi pressionada ao ativar o evento de teclaKeyboardEvent, TouchEvent
animationNameRetorna o nome da animaçãoAnimationEvent
bolhasRetorna se o evento específico é um evento de bolhaEvent
buttonRetorna o botão do mouse pressionado ao desencadear o evento do mouseMouseEvent
buttonsRetorna o botão do mouse pressionado ao desencadear o evento do mouseMouseEvent
cancelávelRetorna se o evento pode ser cancelado para evitar sua operação padrãoEvent
charCodeRetorna o código do caractere Unicode da tecla que ativou o evento onkeypressKeyboardEvent
changeTouchesRetorna a lista de todos os objetos de toque cujo estado mudou entre o toque anterior e o toque atualTouchEvent
clientXRetorna a coordenada horizontal do ponteiro do mouse em relação à janela atual ao ativar o evento do mouseMouseEvent, TouchEvent
clientYRetorna a coordenada vertical do ponteiro do mouse em relação à janela atual ao ativar o evento do mouseMouseEvent, TouchEvent
clipboardDataRetorna um objeto que contém os dados afetados pela operação na área de transferênciaClipboardData
códigoRetorna o código da tecla que ativou o eventoKeyboardEvent
compostoRetorna se o evento é compostoEvent
ctrlKeyRetorna se a tecla 'CTRL' foi pressionada ao ativar o evento do mouseMouseEvent
ctrlKeyRetorna se o botão 'CTRL' foi pressionado ao ativar o evento de teclaKeyboardEvent, TouchEvent
currentTargetRetorna o elemento que desencadeou o evento de ouvinte de eventoEvent
dataRetorna o caractere inseridoInputEvent
dataTransferRetorna um objeto que contém o que será arrastado e soltado/Dado inserido ou excluídoDragEvent, InputEvent
defaultPreventedRetorna se o método preventDefault() foi chamado para o eventoEvent
deltaXRetorna a quantidade de rolagem horizontal do mouse rolo (eixo x)WheelEvent
deltaYRetorna a quantidade de rolagem vertical do mouse rolo (eixo y)WheelEvent
deltaZRetorna a quantidade de rolagem do mouse rolo na Z-axiWheelEvent
deltaModeRetorna um número que representa a unidade de medida do valor de incremento (píxeis, linhas ou páginas)WheelEvent
detailRetorna um número que indica quantas vezes o mouse foi clicadoUiEvent
elapsedTimeRetorna os segundos transcorridos da animaçãoAnimationEvent
elapsedTimeRetorna os segundos transcorridos da transição 
eventPhaseRetorna qual fase do fluxo de eventos está sendo avaliada atualmenteEvent
inputTypeRetorna o tipo de alteração (ou seja, 'inserção' ou 'exclusão')InputEvent
isComposingRetorna se o estado do evento está sendo compostoInputEvent, KeyboardEvent
isTrustedRetorna se o evento é confiávelEvent
keyRetorna o valor do caractere da chave da tecla representada pelo eventoKeyboardEvent
keyRetorna a chave do item de armazenamento alteradoStorageEvent
keyCodeRetorna o código Unicode do caractere que desencadeou o evento onkeypress, ou o código de chave Unicode do caractere que desencadeou os eventos onkeydown ou onkeyup.KeyboardEvent
locationRetorna a localização da tecla na tecla ou no dispositivoKeyboardEvent
lengthComputableRetorna se o comprimento do progresso pode ser calculadoProgressEvent
loadedRetorna a quantidade de trabalho carregadoProgressEvent
metaKeyRetorna se o botão 'META' foi pressionado ao ativar o eventoMouseEvent
metaKeyRetorna se o botão 'meta' foi pressionado ao ativar o evento de teclaKeyboardEvent, TouchEvent
MovementXRetorna a coordenada horizontal do cursor do mouse em relação à posição da última evento mousemoveMouseEvent
MovementYRetorna a coordenada vertical do cursor do mouse em relação à posição da última evento mousemoveMouseEvent
newValueRetorna o novo valor do item de armazenamento alteradoStorageEvent
newURLRetorna a URL do documento após a alteração do hashHasChangeEvent
offsetXRetorna a coordenada horizontal do cursor do mouse em relação à margem do elemento alvoMouseEvent
offsetYRetorna a coordenada vertical do cursor do mouse em relação à margem do elemento alvoMouseEvent
oldValueRetorna o valor antigo do item de armazenamento alteradoStorageEvent
oldURLRetorna a URL do documento antes da alteração do hashHasChangeEvent
onemptiedEste evento ocorre quando ocorre uma situação adversa e o arquivo de mídia fica inesperadamente indisponível (por exemplo, desconexão acidental) 
pageXRetorna a coordenada horizontal do cursor do mouse em relação ao documento ao desencadear o evento do mouseMouseEvent
pageYRetorna a coordenada vertical do cursor do mouse em relação ao documento ao desencadear o evento do mouseMouseEvent
persistedRetorna se a página da web foi armazenada no cache do navegadorPageTransitionEvent
propertyNameRetorna o nome da propriedade CSS associada à animação ou transiçãoAnimationEvent, TransitionEvent
pseudoElementRetorna o nome do pseudo-elemento da animação ou transiçãoAnimationEvent, TransitionEvent
region
MouseEvent
relatedTargetRetorna o elemento relacionado ao elemento que desencadeou o evento do mouseMouseEvent
relatedTargetRetorna o elemento relacionado ao elemento que desencadeou o eventoFocusEvent
repeatRetorna se alguma tecla foi pressionada repetidamenteKeyboardEvent
screenXRetorna a coordenada horizontal do cursor do mouse em relação à tela ao desencadear o eventoMouseEvent
screenYRetorna a coordenada vertical do cursor do mouse em relação à tela ao desencadear o eventoMouseEvent
shiftKeyRetorna se a tecla 'SHIFT' foi pressionada ao desencadear o eventoMouseEvent
shiftKeyRetorna se a tecla 'SHIFT' foi pressionada ao desencadear o evento de teclaKeyboardEvent, TouchEvent
stateRetorna um objeto que contém uma cópia do item de históricoPopStateEvent
storageAreaRetorna um objeto que representa o objeto de armazenamento afetadoStorageEvent
targetRetorna o elemento que desencadeou o eventoEvent
targetTouchesRetorna a lista de todos os objetos de toque em contato com a superfície e os eventos touchstart ocorreram no mesmo elemento-alvo que o elemento-alvo atualTouchEvent
timeStampRetorna o tempo de criação do evento (em milissegundos em relação ao êxodo)Event
totalRetorna a quantidade total de trabalho a ser carregadoProgressEvent
touchesRetorna a lista de todos os objetos de toque em contato com a superfície atualTouchEvent
transitionendEste evento ocorre quando a conversão CSS é concluídaTransitionEvent
typeRetorna o nome do eventoEvent
urlRetorna a URL do documento do item alteradoStorageEvent
whichRetorna o botão do mouse pressionado ao desencadear o evento do mouseMouseEvent
whichRetorna o código Unicode do caractere que desencadeou o evento onkeypress, ou o código de chave Unicode do caractere que desencadeou os eventos onkeydown ou onkeyup.KeyboardEvent
viewRetorna uma Referência para a Janela do Evento OcorridoUiEvent

Métodos de Evento do HTML DOM

A tabela a seguir lista os métodos de eventos DOM:

MétodoDescriçãoTipo de Evento
createEvent()Criar um Novo EventoEvent
getTargetRanges()Retorna um Array Contendo o Alcance do Alvo, que Será Afetado pela Inserção/Efeito da ExclusãoInputEvent
getModifierState()Retorna um Array Contendo o Alcance do Alvo, que Será Afetado pela Inserção/Efeito da ExclusãoMouseEvent
preventDefault()Bloquear a Execução Padrão do Navegador do Elemento SelecionadoEvent
stopImmediatePropagation()Prevenir que outros Escutadores do Mesmo Evento Sejam ChamadosEvent
stopPropagation()Prevenir a Propagação de Eventos no Fluxo de EventosEvent

Referências Relacionadas

Tutorial de Javascript:Eventos do Javascript

Tutorial de Javascript:Escutador de Eventos

Tutorial de Javascript:Propagação de Eventos