Search jQuery

jQuery Forum

API: onMouseDown, onMouseUp and onClick

in Getting Started • 9 years ago

Do you think it would be nice to add to those pages of API an explanation telling people the differences between them?

It would be something like this:

onMouseDown will trigger when either the left or right (or middle) is pressed. Similarly, onMouseUp will trigger when any button is released. onMouseDown will trigger even when the mouse is clicked on the object then moved off of it, while onMouseUp will trigger if you click and hold the button elsewhere, then release it above the object.

onClick will only trigger when the left mouse button is pressed and released on the same object. In case you care about order, if the same object has all 3 events set, it's onMouseDown, onMouseUp, then onClick. Each even should only trigger once though.

Replies(1)

jay.blanc..

Re: API: onMouseDown, onMouseUp and onClick

9 years ago

From http://api.jquery.com/mousedown/

The mousedown event is sent when any mouse button is clicked. To act only on specific buttons, we can use the event object's which property. Not all browsers support this property (Internet Explorer uses button instead), but jQuery normalizes the property so that it is safe to use in any browser. The value of which will be 1 for the left button, 2 for the middle button, or 3 for the right button.

From http://api.jquery.com/mouseup/

If the user clicks outside an element, drags onto it, and releases the button, this is still counted as a mouseup event. This sequence of actions is not treated as a button press in most user interfaces, so it is usually better to use the click event unless we know that the mouseup event is preferable for a particular situation.

From http://api.jquery.com/click/

The click event is only triggered after this exact series of events:

The mouse button is depressed while the pointer is inside the element.
The mouse button is released while the pointer is inside the element.

This is usually the desired sequence before taking an action. If this is not required, the mousedown or mouseup event may be more suitable.

Each event is explained fairly clearly and there are references to other events if the user doesn't find that one of these does not work for them.

Top Reply

Response title

Attachments

jQuery Forum

API: onMouseDown, onMouseUp and onClick

Replies(1)

Re: API: onMouseDown, onMouseUp and onClick

Statistics

Tags

Actions