Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
mousedown
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.
O eventomousedown é ativado quando um botão de um dispositivo apontador é pressionado sobre um elemento.
Informação geral
- Especificação
- 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 |
|---|---|---|
targetSomente leitura | EventTarget | O alvo do evento (o alvo mais alto na árvore do DOM). |
typeSomente leitura | DOMString | O tipo de evento |
bubblesSomente leitura | Boolean | Whether the event normally bubbles or not |
cancelableSomente leitura | Boolean | O evento é cancelável ou não? |
viewSomente leitura | WindowProxy | document.defaultView (window do documento) |
detailSomente leitura | long (float) | Um número de cliques consecutivos que aconteceu num pequeno espaço de tempo, acrescido em um. |
currentTargetSomente leitura | EventTarget | O nó que teve o listener do evento anexado. |
relatedTargetSomente leitura | EventTarget | Para os eventosmouseover,mouseout,mouseenter emouseleave: o alvo do evento complementar (o alvo domouseleave no caso de um eventomouseenter). Caso contrário,null. |
screenXSomente leitura | long | A coordenada X do mouse baseada nas coordenadas globais (tela). |
screenYSomente leitura | long | A coordenada Y do mouse baseada nas coordenadas globais (tela). |
clientXSomente leitura | long | A coordenada X do ponteiro do mouse baseada nas coordenadas locais (conteúdo do DOM). |
clientYSomente leitura | long | A coordenada Y do ponteiro do mouse baseada nas coordenadas locais (conteúdo do DOM). |
buttonSomente 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. |
buttonsSomente 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. |
mozPressureSomente 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). |
ctrlKeySomente leitura | boolean | true se a tecla control estava pressionada quando o evento foi ativado. Caso contrário,false. |
shiftKeySomente leitura | boolean | true se a tecla shift estava pressionada quando o evento foi ativado. Caso contrário,false. |
altKeySomente leitura | boolean | true se a tecla alt estava pressionada quando o evento foi ativado. Caso contrário,false. |
metaKeySomente 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 |