The MouseEvent.buttons
read-only property indicates which buttons are pressed on the mouse (or other input device) when the event is triggered.
Each button that can be pressed is represented by a given number (see below). If more than one button is pressed, the value of the buttons is combined to produce a new number. For example, if the primary (2
) and auxilary (4
) buttons are pressed together, the value is 6
(i.e. 2 + 4
).
Note: Do not confuse this property with the MouseEvent.button
property. The MouseEvent.buttons
property indicates the state of buttons pressed during any kind of mouse event, while the MouseEvent.button
property only guarantees the correct value for mouse events caused by pressing or releasing one or multiple buttons.
Syntax
var buttonPressed = instanceOfMouseEvent.buttons
Return value
A number representing one or more buttons. For more than one button pressed simultaneously, the values are combined (e.g. 3 is primary + secondary).
0
: No button or un-initialized1
: Primary button (usually left)2
: Secondary button (usually right)4
: Auxilary button (usually middle or mouse wheel button)8
: 4th button (typically the "Browser Back" button)16
: 5th button (typically the "Browser Forward" button)
Specifications
Specification | Status | Comment |
---|---|---|
Document Object Model (DOM) Level 3 Events Specification The definition of 'MouseEvent.buttons' in that specification. |
Obsolete | Initial definition |
Browser compatibility
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 43 | (Yes) | (Yes)[1] | 9 | (Yes) | No support |
Feature | Android Webview | Chrome for Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Basic support | No support | No support | (Yes) | ? | ? | ? | ? |
[1] Gecko supports the buttons
attribute on Windows, Linux (GTK), and Mac OS with the following restrictions:
- Utilities allow customization of button actions so that primary may not the the left button on the device, secondary may not be the right button, and so on. The middle (wheel) button, 4th button and 5th button might not be assigned a value, even when they are pressed.
- Single button devices may emulate additional buttons with combinations of button and keyboard presses
- Touch devices may emulate buttons with configurable gestures (e.g. single touch for primary, two-finger touch for secondary, etc.)
- On Linux (GTK), the 4th button and the 5th button are not supported. In addition, a mouseup event always has the releasing button information in this attribute value.
- On Mac OS X 10.5, the buttons attribute always returns 0 because there is no platform API for implementing this feature.