@constructor jQuery.event.default @parent jquerypp
jQuery.event.default allows you to perform default actions as a result of an event.
Event based APIs are a powerful way of exposing functionality of your widgets. It also fits in quite nicely with how the DOM works.
Like default events in normal functions (e.g. submitting a form), synthetic default events run after
all event handlers have been triggered and no event handler has called
event.preventDefault() or returned false.
To listen to a default event, just prefix the event with default namespace:
$("div").on("default.show", function(ev){ ... });
$("ul").on("default.activate", "li", function(ev){ ... });
Default events are useful in cases where you want to provide an event based
API for users of your widgets. Users can simply listen to your synthetic events and
prevent your default functionality by calling event.preventDefault().
In the example below, the tabs widget provides a show event. Users of the tabs widget can simply listen for show, and, if they wish to prevent a tab from being shown for some reason, they can call preventDefault to avoid showing the tab.
In this case, the application developer doesn't want to show the second tab until the checkbox is checked.
@demo jquerypp/event/default/defaultjquery.html 300