Posted By

garside on 03/27/09

Tagged

jquery
order

Versions (?)

Last Edited at 03/27/09 07:32pm

Statistics

Viewed 849 times

Favorited by 3 user(s)

Related snippets

jStack - jQuery Event Stack Management

/ Published in: JavaScript

Allows the user to bind an event into a certain position in the call stack for events.

Highlighted TextExpand

/*!
 * jStack - jQuery Event Stack Management
 * by Eric Garside (http://eric.garside.name)
 * 
 * Dual licensed under:
 * 	MIT: http://www.opensource.org/licenses/mit-license.php
 *	GPLv3: http://www.opensource.org/licenses/gpl-3.0.html
 */
(function($){
	
	$.extend($.fn, {
		// Determine the objects position in the cache, if any
		cachePosition: function(){
			return $.data(this[0]);
		},
		
		// Allow the user to splice an event into a specific position in the event cache 
		bindIntoStack: function(pos, type, func){
			return this.each(function(){
				var namespaces = type.split("."),	// Explode out namespaces, if any
					evType = namespaces.shift(),	// Grab the actual type
					el = $(this),					// Use the jQuery reference to the first element instead of the domElement
					position = el.cachePosition();	// Get the location of the element in the cache.
				
				if (!position) return;				// If we have a position, we can access the cache, which holds the jQuery event stack.
					
				var cache = $.cache[ position ];	// Grab a reference to the cache so we can do some sanity checks

el.bind(type, func);				// Now we need to bind the new function to the call stack through jQuery

if (!cache ||						// If we don't have the a pre-existing event cache, bind the function as a new entry and exit
					!cache.events || 
					!cache.events[ evType ]) return;	
					
				var events = cache.events[ evType ],// Grab a copy of the events cache for the given type
					fromExpando = [],				// [stackPosition => uuidIDInjQueryCache, ...]
					toReplace = null,				// A copy of the function we'll be replacing, if any
					i = 0;
					
				$.each(events, function(k){
					fromExpando.push(k);
					if (i == pos) toReplace = this;	// If the positions are equal, this is the function we want to replace
					++i;
				})
				
				if (!toReplace) return;		 		// If the position in the stack has not yet been reached, there's no slicing to be done

var newPos = fromExpando.pop();		// The position we'll be placing in

// Perform the actual position swap in the cache
				$.cache[ position ].events[ evType ][ fromExpando[pos] ] = $.cache[ position ].events[ evType ][ newPos ];
				$.cache[ position ].events[ evType ][ newPos ] = toReplace;
			})
			
			return this;
		}
	});
	
})(jQuery);

// Code to test with
$(function(){
	
	var test = $('#test')
		.bind('clickr.one', function(){ console.log('evt1') })
		.bind('clickr.two', function(){ console.log('evt2') })
		.bind('clickr.three', function(){ console.log('evt3') })
		.bind('clickr.four', function(){ console.log('evt4') })
		.bindIntoStack(0, 'clickr.override', function(e){
			console.log('I am now first, and I prevent all other events.');
			e.stopImmediatePropagation();
			return false;
		})
		.click(function(){ $(this).trigger('clickr') })
	$('#unbind').click(function(){ test.unbind('clickr.override') })
})

/**
 * Test HTML:
	<body>
		<button id="test">Test Events</button>
		<button id="unbind">Unbind Override Trigger</button>
	</body>
 */

Report this snippet Tweet

Comments

Subscribe to comments

Comment:

You need to login to post a comment.