Description
The .unbind() method removes event handles from selected elements.
This method can remove all or selected event handlers, or stop specified functions from running when the event occur.
The .ubind() method works on any event handler attached with jQuery.
Unbind Event Handlers Using an Event Object
Specifies an event object to remove. This is used to unbind an event from within itself (like removing an event handler after the event has been triggered a certain number of times).
If no parameters are specified, the unbind() method will remove ALL event handlers from the specified element.
This method has the form:
.unbind(eventObj)
Parameter | Description |
---|---|
eventObj | (optional) Specifies the event object to remove to use. The eventObj parameter comes from the event binding function |
Return Value
This form returns a jQuery object.
This method has the alternate form:
.unbind(event,false)
Parameter | Description |
---|---|
eventObj | (optional) Specifies the event object to remove to use. The eventObj parameter comes from the event binding function |
false | Unbinds the corresponding 'return false' function |
Return Value
This form returns a jQuery object.
Unbind Event Handlers and Functions from Elements
Specifies one or more event handlers to remove from selected elements.
If no parameters are specified, the unbind() method will remove ALL event handlers from the specified element.
This method has the alternate form:
.unbind(event,function)
Parameter | Description |
---|---|
event | (optional) Specifies one or more events remove from the elements. Multiple event values are separated by space. If this is the only parameter specified, all functions bound to the specified event will be removed. |
function | (optional) Specifies the name of the function to unbind from the specified event for the element |
Return Value
This form returns a jQuery object.
Examples
Remove all event handles for all p elements:
$("button").click(function(){
$("p").unbind();
});