mirror of
https://github.com/WordPress/WordPress.git
synced 2024-08-19 20:33:00 +02:00
In many a strange and curious file of forgotten lore— While I pondered, blaming Nacin, my notifications suddenly awakened, As of someone quietly DMing;—DMing me, I can’t ignore. “’Tis some contributor,” I muttered, “DMing me an idea or four— Only this and nothing more.” Ah, distinctly I remember, at WordCamp US, last December; A mad proposal nearly laid me—down out cold—upon the floor. Curious, I listened closely;—to a plan I agreed with, mostly— A way to make our JavaScript—JavaScript which was a chore— Maintainable, extendable, for the future, is what I saw. Guten-ready for evermore. Open here I switch to Slack, when, with many a patch and hack, In there stepped Omar, a JavaScript developer hardcore; Pronouncing all the changes fit; ready now to be commit; “There’s nothing else for us to do,” DMing me, “It’s done!” he swore— “No longer random guessing at which file need next be explored— Let’s move on, we’re all aboard.” Moved all together, grouped and managed, in folders all is packaged, The code had all been cleaned and tidied, important parts moved to the fore, “Though this change be useful here,” I said, “it is too large, I fear, We couldn’t manage such a patch, we’ve done nothing like this before— Tell me where doth go this change, change to make our codebase soar!” Quoth Omar, “In WordPress Core.” Props omarreis for shepherding this significant change. Props adamsilverstein, aduth, atimmer, dingo_bastard, frank-klein, gziolo, herregroen, jaswrks, jeremyfelt, jipmoors, jorbin, netweb, ocean90, pento, tjnowell, and youknowriad for testing, feedback, discussion, encouragement, commiserations, etc. I make no apologies for this commit message. Fixes #43055. Built from https://develop.svn.wordpress.org/trunk@43309 git-svn-id: http://core.svn.wordpress.org/trunk@43138 1a063a9b-81f0-0310-95a4-ce76da25c4cd
116 lines
4.8 KiB
JavaScript
116 lines
4.8 KiB
JavaScript
/*!
|
|
* hoverIntent v1.8.3 // 2014.08.11 // jQuery v1.9.1+
|
|
* http://cherne.net/brian/resources/jquery.hoverIntent.html
|
|
*
|
|
* You may use hoverIntent under the terms of the MIT license. Basically that
|
|
* means you are free to use hoverIntent as long as this header is left intact.
|
|
* Copyright 2007, 2014 Brian Cherne
|
|
*/
|
|
|
|
/* hoverIntent is similar to jQuery's built-in "hover" method except that
|
|
* instead of firing the handlerIn function immediately, hoverIntent checks
|
|
* to see if the user's mouse has slowed down (beneath the sensitivity
|
|
* threshold) before firing the event. The handlerOut function is only
|
|
* called after a matching handlerIn.
|
|
*
|
|
* // basic usage ... just like .hover()
|
|
* .hoverIntent( handlerIn, handlerOut )
|
|
* .hoverIntent( handlerInOut )
|
|
*
|
|
* // basic usage ... with event delegation!
|
|
* .hoverIntent( handlerIn, handlerOut, selector )
|
|
* .hoverIntent( handlerInOut, selector )
|
|
*
|
|
* // using a basic configuration object
|
|
* .hoverIntent( config )
|
|
*
|
|
* @param handlerIn function OR configuration object
|
|
* @param handlerOut function OR selector for delegation OR undefined
|
|
* @param selector selector OR undefined
|
|
* @author Brian Cherne <brian(at)cherne(dot)net>
|
|
*/
|
|
(function($) {
|
|
$.fn.hoverIntent = function(handlerIn,handlerOut,selector) {
|
|
|
|
// default configuration values
|
|
var cfg = {
|
|
interval: 100,
|
|
sensitivity: 6,
|
|
timeout: 0
|
|
};
|
|
|
|
if ( typeof handlerIn === "object" ) {
|
|
cfg = $.extend(cfg, handlerIn );
|
|
} else if ($.isFunction(handlerOut)) {
|
|
cfg = $.extend(cfg, { over: handlerIn, out: handlerOut, selector: selector } );
|
|
} else {
|
|
cfg = $.extend(cfg, { over: handlerIn, out: handlerIn, selector: handlerOut } );
|
|
}
|
|
|
|
// instantiate variables
|
|
// cX, cY = current X and Y position of mouse, updated by mousemove event
|
|
// pX, pY = previous X and Y position of mouse, set by mouseover and polling interval
|
|
var cX, cY, pX, pY;
|
|
|
|
// A private function for getting mouse position
|
|
var track = function(ev) {
|
|
cX = ev.pageX;
|
|
cY = ev.pageY;
|
|
};
|
|
|
|
// A private function for comparing current and previous mouse position
|
|
var compare = function(ev,ob) {
|
|
ob.hoverIntent_t = clearTimeout(ob.hoverIntent_t);
|
|
// compare mouse positions to see if they've crossed the threshold
|
|
if ( Math.sqrt( (pX-cX)*(pX-cX) + (pY-cY)*(pY-cY) ) < cfg.sensitivity ) {
|
|
$(ob).off("mousemove.hoverIntent",track);
|
|
// set hoverIntent state to true (so mouseOut can be called)
|
|
ob.hoverIntent_s = true;
|
|
return cfg.over.apply(ob,[ev]);
|
|
} else {
|
|
// set previous coordinates for next time
|
|
pX = cX; pY = cY;
|
|
// use self-calling timeout, guarantees intervals are spaced out properly (avoids JavaScript timer bugs)
|
|
ob.hoverIntent_t = setTimeout( function(){compare(ev, ob);} , cfg.interval );
|
|
}
|
|
};
|
|
|
|
// A private function for delaying the mouseOut function
|
|
var delay = function(ev,ob) {
|
|
ob.hoverIntent_t = clearTimeout(ob.hoverIntent_t);
|
|
ob.hoverIntent_s = false;
|
|
return cfg.out.apply(ob,[ev]);
|
|
};
|
|
|
|
// A private function for handling mouse 'hovering'
|
|
var handleHover = function(e) {
|
|
// copy objects to be passed into t (required for event object to be passed in IE)
|
|
var ev = $.extend({},e);
|
|
var ob = this;
|
|
|
|
// cancel hoverIntent timer if it exists
|
|
if (ob.hoverIntent_t) { ob.hoverIntent_t = clearTimeout(ob.hoverIntent_t); }
|
|
|
|
// if e.type === "mouseenter"
|
|
if (e.type === "mouseenter") {
|
|
// set "previous" X and Y position based on initial entry point
|
|
pX = ev.pageX; pY = ev.pageY;
|
|
// update "current" X and Y position based on mousemove
|
|
$(ob).on("mousemove.hoverIntent",track);
|
|
// start polling interval (self-calling timeout) to compare mouse coordinates over time
|
|
if (!ob.hoverIntent_s) { ob.hoverIntent_t = setTimeout( function(){compare(ev,ob);} , cfg.interval );}
|
|
|
|
// else e.type == "mouseleave"
|
|
} else {
|
|
// unbind expensive mousemove event
|
|
$(ob).off("mousemove.hoverIntent",track);
|
|
// if hoverIntent state is true, then call the mouseOut function after the specified delay
|
|
if (ob.hoverIntent_s) { ob.hoverIntent_t = setTimeout( function(){delay(ev,ob);} , cfg.timeout );}
|
|
}
|
|
};
|
|
|
|
// listen for mouseenter and mouseleave
|
|
return this.on({'mouseenter.hoverIntent':handleHover,'mouseleave.hoverIntent':handleHover}, cfg.selector);
|
|
};
|
|
})(jQuery);
|