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 Standard
# handler-onmousedown

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também