mousedown

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.

O evento mousedown é ativado quando um botão de um dispositivo apontador é pressionado sobre um elemento.

Informação geral

Especificação

DOM L3

Interface
MouseEvent
Bubbles

Sim

Cancelável

Sim

Alvo

Elemento

Ação Padrão

Varia: Inicia um operação de arrastar/soltar; inicia a seleção de texto; inicia a interação de rolagem/arrastar (junto do botão do meio do mouse, se suportado)

Propriedades

Property Type Description
target Somente leitura EventTarget O alvo do evento (o alvo mais alto na árvore do DOM).
type Somente leitura DOMString O tipo de evento
bubbles Somente leitura Boolean Whether the event normally bubbles or not
cancelable Somente leitura Boolean O evento é cancelável ou não?
view Somente leitura WindowProxy document.defaultView (window do documento)
detail Somente leitura long (float) Um número de cliques consecutivos que aconteceu num pequeno espaço de tempo, acrescido em um.
currentTarget Somente leitura EventTarget O nó que teve o listener do evento anexado.
relatedTarget Somente leitura EventTarget Para os eventos mouseover, mouseout, mouseenter e mouseleave: o alvo do evento complementar (o alvo do mouseleave no caso de um evento mouseenter). Caso contrário, null.
screenX Somente leitura long A coordenada X do mouse baseada nas coordenadas globais (tela).
screenY Somente leitura long A coordenada Y do mouse baseada nas coordenadas globais (tela).
clientX Somente leitura long A coordenada X do ponteiro do mouse baseada nas coordenadas locais (conteúdo do DOM).
clientY Somente leitura long A coordenada Y do ponteiro do mouse baseada nas coordenadas locais (conteúdo do DOM).
button Somente leitura unsigned short O número do botão que foi pressionado quando o evento mouse foi ativado: Botão esquerdo = 0, botão do meio = 1 (se presente), botão direito = 2. Para os mouses configurados para uso por canhotos onde as ações do mouse são invertidas, os valores são lidos da direita para a esquerda.
buttons Somente leitura unsigned short Os botões pressionados que foram pressionados quando o evento do mouse foi ativado: Botão esquerdo = 1, botão direito = 2, botão do meio (roda) = 4, 4º botão (geralmente, o "botão de voltar") = 8, 5º botão (geralmente, o "botão de avançar") = 16. Se dois ou mais botões são pressionados, retorna a soma lógica dos valores. Exemplo: se o Botão esquerdo e o Botão direito são pressionados, retorna 3 (=1 | 2). Mais informações.
mozPressure Somente leitura float A quantidade de pressão aplicada a um dispositivo touch ou tablet quando o evento estava sendo gerado; este valor varia entre 0.0 (pressão mínima) e 1.0 (pressão máxima).
ctrlKey Somente leitura boolean true se a tecla control estava pressionada quando o evento foi ativado. Caso contrário, false.
shiftKey Somente leitura boolean true se a tecla shift estava pressionada quando o evento foi ativado. Caso contrário, false.
altKey Somente leitura boolean true se a tecla alt estava pressionada quando o evento foi ativado. Caso contrário, false.
metaKey Somente leitura boolean true se a tecla meta estava pressionada quando o evento foi ativado. Caso contrário, false.

Especificações

Specification
UI Events
# event-type-mousedown
HTML
# handler-onmousedown

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
mousedown event

Legend

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

Full support
Full support

Veja também