Atributo buttons do MouseEvent

Definição e uso

Atributo button retorna um número que indica qual ou quais botões do mouse foram pressionados ao trigger o evento do mouse.

Este atributo é principalmente usado juntamente com o evento onmousedown.

Dica:Devido à falta de suporte do navegador, você pode precisar consultar Atributo button.

Observações:Este atributo é somente leitura.

Exemplo

Encontre os botões do mouse pressionados ao trigger o evento do mouse:

var x = event.buttons;

Experimente você mesmo

Sintaxe

event.buttons

Detalhes técnicos

Valor retornado:

Valores numéricos, representando um ou mais botões do mouse pressionados durante o evento do mouse.

Se vários botões forem pressionados, combine esses valores para gerar um novo número (por exemplo, se o botão esquerdo (1) e o botão direito (2) forem pressionados, o valor retornado será 1+2, ou seja, 3).

Valores possíveis:

  • 1: Botão esquerdo do mouse
  • 2: Botão direito do mouse
  • 4: Botão de rolagem ou botão central
  • 8: Terceiro botão do mouse (normalmente o botão 'voltar' do navegador)
  • 16: Quarto botão do mouse (normalmente o botão 'avançar' do navegador)

Observações:Para configurações de mouse esquerdo, o valor retornado é o oposto.

DOM Versão: DOM Level 3 Events

Suporte do navegador

Os números na tabela indicam a primeira versão do navegador que suporta completamente essa propriedade.

Atributos Chrome IE Firefox Safari Opera
buttons 53.0 9.0 Suporte Não suportado Suporte

Páginas relacionadas

Manual de referência do HTML DOM:Atributo button do MouseEvent

Manual de referência do HTML DOM:Atributo which do MouseEvent