Detecting which mouse button was pressed
Created on February 11, 2014.
I recently completed a task that required dragging functionality on a web element. The element had to support dragging on the Y axis, using JavaScript mouseup, mousemove and mousedown events to capture the action. The problem with this, and the actual task I completed, was catering for the right mouse button on this component. The drag functionality worked for both mouse buttons, but this was undesirable.
When using right-click to drag the component, a context menu appears and causes issues with "letting go" of the element (as well as appearing messy and somewhat unfinished). A simple detection as to which mouse button was pressed was required, so that we could only accept events from the left button.
I started digging in to the detection of which mouse button was pressed for an event, and found a huge difference between browsers (mainly in regards to older versions). JavaScript mouse events hold a couple of properties: button and which. Some browsers only have 1 of these, many these-days have both - But the problem is, they hold different values! To properly support as many browsers as possible, which keeping detection implementation sane, we should check for both of these. This great article discusses the differences between the values on the two properties, and presents a very handy table that clearly shows what we're dealing with:
In this table, you can see the difference between the two properties, and how much they differ between browser systems and versions. You should note that these codes are only applicable for mousedown and mouseup - 0 will be returned for click, dblclick and contextmenu events.
In the project I'm working on, we're not supporting anything below IE 9.0, so that saves us a little trouble. I wrote a little function to handle the basics for us:
function getMouseButton(event) {
var buttonPressed = "none";
if (event) {
if (event.which) { // preferrable
if (event.which === 1) {
buttonPressed = "left";
} else if (event.which === 3) {
buttonPressed = "right";
}
} else if (event.button) {
if (event.button === 0) {
buttonPressed = "left";
} else if (event.button === 2) {
buttonPressed = "right";
}
}
}
return buttonPressed;
}
Let's have a quick look at what we've got here:
- It takes a JavaScript event object
- Default output is "none"
- The 'which' property is checked first in preference
- It checks the codes 1 & 3 for left and right buttons (respectively)
- The 'button' property is checked second
- It checks the codes 0 & 2 for left and right buttons (respectively)
These codes I've used, judging by the information in the table above, will support the following browsers (though no guarantees are made):
- IE 9.0 and newer
- Chrome
- Firefox
- Opera 8.0 and newer
- Konqueror 4.3 and newer
If you need to support earlier than IE 9, you could possibly accomplish this by adding an 'attachEvent' window property detection for the 'button' property, which would allow you to detect if it's IE 8 or lower. If that's the case, use the first column of the table above for the event.button property.
This was a quick solution - If you have any recommendations, or have done this before, I'd be interested to hear how you solved it.
Update:
After some time of using this solution, we discovered several inaccuracies with how it detected mouse buttons on browsers like IE 9 and 10. Since we still support these fantastic browsers, it was required to rework the function. This is what we're using now:
function getMouseButton(event) {
var buttonPressed = "none";
if (event) {
if ((event.which === null) || (event.which === 'undefined') || (!event.hasOwnProperty("which"))) {
buttonPressed = (event.button < 2) ? 'left' :
((event.button === 4) ? 'middle' : 'right');
} else {
buttonPressed = (event.which < 2) ? 'left' :
((event.which === 2) ? 'middle' : 'right');
}
}
return buttonPressed;
}
The credit for this more complete solution goes to this article.