jQuery - Events Reference

jQuery Events Methods

Following is a list of jQuery Methods which can be called on an Event Object −

Method	Description
preventDefault()	Prevents the browser from executing the default action.
isDefaultPrevented()	Returns whether event.preventDefault() was ever called on this event object.
stopPropagation()	Stops the bubbling of an event to parent elements, preventing any parent handlers from being notified of the event.
isPropagationStopped()	Returns whether event.stopPropagation() was ever called on this event object.
stopImmediatePropagation()	Stops the rest of the handlers from being executed.
isImmediatePropagationStopped()	Returns whether event.stopImmediatePropagation() was ever called on this event object.

Event Manipulation Methods

Following table lists down important event-related methods −

Method	Description
bind()	Binds a handler to one or more events (like click) for each matched element. Can also bind custom events.
off()	This does the opposite of live, it removes a bound live event.
hover( )	Simulates hovering for example moving the mouse on, and off, an object.
on()	Binds a handler to an event (like click) for all current − and future − matched element. Can also bind custom events.
one() )	Binds a handler to one or more events to be executed once for each matched element.
ready()	Binds a function to be executed whenever the DOM is ready to be traversed and manipulated.
trigger()	Trigger an event on every matched element.
triggerHandler( )	Triggers all bound event handlers on an element.
unbind()	This does the opposite of bind, it removes bound events from each of the matched elements.

Event Helper Methods

jQuery also provides a set of event helper functions which can be used either to trigger an event to bind any event types mentioned above.

Trigger Methods

Following is an example which would triggers the blur event on all paragraphs −

$("p").blur();

Binding Methods

Following is an example which would bind a click event on all the <div> −

$("div").click( function () { 
   // do something here
});

Here is a complete list of all the jQuery Support Methods −

Method	Description
blur( )	Triggers or binds the blur event of each matched element.
change()	Triggers or binds the change event of each matched element.
click( )	Triggers or binds the click event of each matched element.
dblclick()	Triggers or binds the dblclick event of each matched element.
error()	Triggers or binds the error event of each matched element.
focus( )	Triggers or binds the focus event of each matched element.
keydown( )	Triggers or binds the keydown event of each matched element.
keypress()	Triggers or binds the keypress event of each matched element.
keyup()	Triggers or binds the keyup event of each matched element.
load()	Binds a function to the load event of each matched element.
mousedown()	Binds a function to the mousedown event of each matched element.
mouseenter()	Bind a function to the mouseenter event of each matched element.
mouseleave()	Bind a function to the mouseleave event of each matched element.
mousemove()	Bind a function to the mousemove event of each matched element.
mouseout()	Bind a function to the mouseout event of each matched element.
mouseover( )	Bind a function to the mouseover event of each matched element.
mouseup( )	Bind a function to the mouseup event of each matched element.
resize()	Bind a function to the resize event of each matched element.
scroll()	Bind a function to the scroll event of each matched element.
select()	Trigger or binds the select event of each matched element.
submit( )	Trigger or binds the submit event of each matched element.
unload()	Binds a function to the unload event of each matched element.

Event Attributes

The following event properties/attributes are available and safe to access in a platform independent manner −

Attributes	Description
altKey	Set to true if the Alt key was pressed when the event was triggered, false if not. The Alt key is labeled Option on most Mac keyboards.
ctrlKey	Set to true if the Ctrl key was pressed when the event was triggered, false if not.
data	The value, if any, passed as the second parameter to the bind() command when the handler was established.
keyCode	For keyup and keydown events, this returns the key that was pressed.
metaKey	Set to true if the Meta key was pressed when the event was triggered, false if not. The Meta key is the Ctrl key on PCs and the Command key on Macs.
pageX	For mouse events, specifies the horizontal coordinate of the event relative from the page origin.
pageY	For mouse events, specifies the vertical coordinate of the event relative from the page origin.
relatedTarget	For some mouse events, identifies the element that the cursor left or entered when the event was triggered.
screenX	For mouse events, specifies the horizontal coordinate of the event relative from the screen origin.
screenY	For mouse events, specifies the vertical coordinate of the event relative from the screen origin.
shiftKey	Set to true if the Shift key was pressed when the event was triggered, false if not.
target	Identifies the element for which the event was triggered.
timeStamp	The timestamp (in milliseconds) when the event was created.
type	For all events, specifies the type of event that was triggered (for example, click).
which	For keyboard events, specifies the numeric code for the key that caused the event, and for mouse events, specifies which button was pressed (1 for left, 2 for middle, 3 for right).