RandomSec/main/webapp/modules/core/externals/jquery.eventstack-0.3.js
David Huynh a5c6a3af34 Support ESC key to dismiss menus and dialogs (which required jquery eventstack plugin).
Updated binding names in project.vt so that the bound HTML elements are distinguished from the JS objects that manage them (e.g., summarBarDiv vs summaryBar).

git-svn-id: http://google-refine.googlecode.com/svn/trunk@1591 7d457c2a-affb-35e4-300a-418c747d4874
2010-10-18 01:07:35 +00:00

94 lines
2.7 KiB
JavaScript

/**
* Copyright (c) 2008, Ben XO <me@ben-xo.com>
*
* Dual licensed under the MIT (MIT-LICENSE.txt)
* and GPL (GPL-LICENSE.txt) licenses.
*
*
* This is a jQuery plugin that allows events to be handled in reverse order of
* binding - add events to the head of the queue rather than the end.
*
* Particularly useful if you apply your "do"s in a modular order and wish to
* apply your "undo"s in reverse order.
*
* It adds the following two methods:
*
* reverse(event): reverses the order that functions attached to <event> are
* applied to this element.
*
* stack( event, data, fn ): just like bind(), except adds to the front of the
* event queue instead of the end.
*
* Also, every event method (.click(), .focus(), .resize(), .submit(), etc -
* 21 methods in all) can take an extra parameter "reverse" that controls if
* the event is added to the front or end of the event queue. For example:
*
* $("body").click(function() { alert("1"); });
* $("body").click(function() { alert("2"); });
* $("body").click(function() { alert("3"); }, true);
*
* ... will show "3", "1" then "2" when the document is clicked.
*
* @version 0.3
*/
jQuery.fn.extend({
// reverse the order of events bound to an element
reverse: function( event ) {
var events = this.data("events");
if ( events != undefined && events[event] != undefined) {
// can't reverse what's not there
var reverseEvent = new Array;
for (var e in events[event]) {
reverseEvent.unshift(events[event][e]);
}
events[event] = reverseEvent;
}
return this;
},
// add an event to the front of an event queue rather than the back
// we do this by reversing the queue, adding, then reversing again
stack: function( event, data, fn ) {
return this
.reverse( event )
.bind( event, data, fn )
.reverse( event )
;
},
hover: function( fnOver, fnOut, reverse ) {
if(reverse) {
return this
.stack('mouseenter', fnOver)
.stack('mouseleave', fnOut)
;
} else {
return this
.bind('mouseenter', fnOver)
.bind('mouseleave', fnOut)
;
}
}
});
// every event handler - blur(), focus(), click() etc now has a 2nd param which
// if true will add the passed function to the beginning of the event list
// instead of the end
jQuery.each( ("blur,focus,load,resize,scroll,unload,click,dblclick," +
"mousedown,mouseup,mousemove,mouseover,mouseout,change,select," +
"submit,keydown,keypress,keyup,error").split(","), function(i, name){
// Handle event binding
jQuery.fn[name] = function(fn, reverse){
if(fn) {
return reverse ?
this.stack(name, fn) :
this.bind(name, fn)
;
} else {
return this.trigger(name);
}
};
});