☰

jquery.bind-first

jquery bind-first plugin

As of 2014-06-27. See the latest version.

This script should not be not be installed directly. It is a library for other scripts to include with the meta directive // @require https://update.greatest.deepsurf.us/scripts/2857/8036/jquerybind-first.js 

  1. // ==UserScript==
  2. // @name           jquery.bind-first
  3. // @namespace      private-face
  4. // @description    jquery bind-first plugin
  5. // @source         https://github.com/private-face/jquery.bind-first
  6. // @copyright      Vladimir Zhuravlev
  7. // @version        0.2.3
  8. // @license        MIT
  9. // ==/UserScript==
  10.  
  11.  
  12. /*
  13.  * jQuery.bind-first library v0.2.3
  14.  * Copyright (c) 2013 Vladimir Zhuravlev
  15.  *
  16.  * Released under MIT License
  17.  * @license
  18.  *
  19.  * Date: Thu Feb  6 10:13:59 ICT 2014
  20.  **/
  21.  
  22. (function($) {
  23. 	var splitVersion = $.fn.jquery.split(".");
  24. 	var major = parseInt(splitVersion[0]);
  25. 	var minor = parseInt(splitVersion[1]);
  26.  
  27. 	var JQ_LT_17 = (major < 1) || (major == 1 && minor < 7);
  28. 	
  29. 	function eventsData($el) {
  30. 		return JQ_LT_17 ? $el.data('events') : $._data($el[0]).events;
  31. 	}
  32. 	
  33. 	function moveHandlerToTop($el, eventName, isDelegated) {
  34. 		var data = eventsData($el);
  35. 		var events = data[eventName];
  36.  
  37. 		if (!JQ_LT_17) {
  38. 			var handler = isDelegated ? events.splice(events.delegateCount - 1, 1)[0] : events.pop();
  39. 			events.splice(isDelegated ? 0 : (events.delegateCount || 0), 0, handler);
  40.  
  41. 			return;
  42. 		}
  43.  
  44. 		if (isDelegated) {
  45. 			data.live.unshift(data.live.pop());
  46. 		} else {
  47. 			events.unshift(events.pop());
  48. 		}
  49. 	}
  50. 	
  51. 	function moveEventHandlers($elems, eventsString, isDelegate) {
  52. 		var events = eventsString.split(/\s+/);
  53. 		$elems.each(function() {
  54. 			for (var i = 0; i < events.length; ++i) {
  55. 				var pureEventName = $.trim(events[i]).match(/[^\.]+/i)[0];
  56. 				moveHandlerToTop($(this), pureEventName, isDelegate);
  57. 			}
  58. 		});
  59. 	}
  60. 	
  61. 	function makeMethod(methodName) {
  62. 		$.fn[methodName + 'First'] = function() {
  63. 			var args = $.makeArray(arguments);
  64. 			var eventsString = args.shift();
  65.  
  66. 			if (eventsString) {
  67. 				$.fn[methodName].apply(this, arguments);
  68. 				moveEventHandlers(this, eventsString);
  69. 			}
  70.  
  71. 			return this;
  72. 		}
  73. 	}
  74.  
  75. 	// bind
  76. 	makeMethod('bind');
  77.  
  78. 	// one
  79. 	makeMethod('one');
  80.  
  81. 	// delegate
  82. 	$.fn.delegateFirst = function() {
  83. 		var args = $.makeArray(arguments);
  84. 		var eventsString = args[1];
  85. 		
  86. 		if (eventsString) {
  87. 			args.splice(0, 2);
  88. 			$.fn.delegate.apply(this, arguments);
  89. 			moveEventHandlers(this, eventsString, true);
  90. 		}
  91.  
  92. 		return this;
  93. 	};
  94.  
  95. 	// live
  96. 	$.fn.liveFirst = function() {
  97. 		var args = $.makeArray(arguments);
  98.  
  99. 		// live = delegate to the document
  100. 		args.unshift(this.selector);
  101. 		$.fn.delegateFirst.apply($(document), args);
  102.  
  103. 		return this;
  104. 	};
  105. 	
  106. 	// on (jquery >= 1.7)
  107. 	if (!JQ_LT_17) {
  108. 		$.fn.onFirst = function(types, selector) {
  109. 			var $el = $(this);
  110. 			var isDelegated = typeof selector === 'string';
  111.  
  112. 			$.fn.on.apply($el, arguments);
  113.  
  114. 			// events map
  115. 			if (typeof types === 'object') {
  116. 				for (type in types)
  117. 					if (types.hasOwnProperty(type)) {
  118. 						moveEventHandlers($el, type, isDelegated);
  119. 					}
  120. 			} else if (typeof types === 'string') {
  121. 				moveEventHandlers($el, types, isDelegated);
  122. 			}
  123.  
  124. 			return $el;
  125. 		};
  126. 	}
  127.  
  128. })(jQuery);