mirror of
https://github.com/WordPress/WordPress.git
synced 2024-08-25 15:22:53 +02:00
This updates the `jquery-hoverintent` dependency from 1.8.3 to 1.10.1. For a full list of changes, see https://github.com/briancherne/jquery-hoverIntent/compare/v1.8.3...v1.10.1. Fixes #52686. Built from https://develop.svn.wordpress.org/trunk@50521 git-svn-id: http://core.svn.wordpress.org/trunk@50134 1a063a9b-81f0-0310-95a4-ce76da25c4cd
165 lines
6.9 KiB
JavaScript
165 lines
6.9 KiB
JavaScript
/*!
|
|
* hoverIntent v1.10.1 // 2019.10.05 // jQuery v1.7.0+
|
|
* http://briancherne.github.io/jquery-hoverIntent/
|
|
*
|
|
* 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-2019 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(factory) {
|
|
'use strict';
|
|
if (typeof define === 'function' && define.amd) {
|
|
define(['jquery'], factory);
|
|
} else if (typeof module === 'object' && module.exports) {
|
|
module.exports = factory(require('jquery'));
|
|
} else if (jQuery && !jQuery.fn.hoverIntent) {
|
|
factory(jQuery);
|
|
}
|
|
})(function($) {
|
|
'use strict';
|
|
|
|
// default configuration values
|
|
var _cfg = {
|
|
interval: 100,
|
|
sensitivity: 6,
|
|
timeout: 0
|
|
};
|
|
|
|
// counter used to generate an ID for each instance
|
|
var INSTANCE_COUNT = 0;
|
|
|
|
// current X and Y position of mouse, updated during mousemove tracking (shared across instances)
|
|
var cX, cY;
|
|
|
|
// saves the current pointer position coordinates based on the given mousemove event
|
|
var track = function(ev) {
|
|
cX = ev.pageX;
|
|
cY = ev.pageY;
|
|
};
|
|
|
|
// compares current and previous mouse positions
|
|
var compare = function(ev,$el,s,cfg) {
|
|
// compare mouse positions to see if pointer has slowed enough to trigger `over` function
|
|
if ( Math.sqrt( (s.pX-cX)*(s.pX-cX) + (s.pY-cY)*(s.pY-cY) ) < cfg.sensitivity ) {
|
|
$el.off(s.event,track);
|
|
delete s.timeoutId;
|
|
// set hoverIntent state as active for this element (permits `out` handler to trigger)
|
|
s.isActive = true;
|
|
// overwrite old mouseenter event coordinates with most recent pointer position
|
|
ev.pageX = cX; ev.pageY = cY;
|
|
// clear coordinate data from state object
|
|
delete s.pX; delete s.pY;
|
|
return cfg.over.apply($el[0],[ev]);
|
|
} else {
|
|
// set previous coordinates for next comparison
|
|
s.pX = cX; s.pY = cY;
|
|
// use self-calling timeout, guarantees intervals are spaced out properly (avoids JavaScript timer bugs)
|
|
s.timeoutId = setTimeout( function(){compare(ev, $el, s, cfg);} , cfg.interval );
|
|
}
|
|
};
|
|
|
|
// triggers given `out` function at configured `timeout` after a mouseleave and clears state
|
|
var delay = function(ev,$el,s,out) {
|
|
var data = $el.data('hoverIntent');
|
|
if (data) {
|
|
delete data[s.id];
|
|
}
|
|
return out.apply($el[0],[ev]);
|
|
};
|
|
|
|
$.fn.hoverIntent = function(handlerIn,handlerOut,selector) {
|
|
// instance ID, used as a key to store and retrieve state information on an element
|
|
var instanceId = INSTANCE_COUNT++;
|
|
|
|
// extend the default configuration and parse parameters
|
|
var cfg = $.extend({}, _cfg);
|
|
if ( $.isPlainObject(handlerIn) ) {
|
|
cfg = $.extend(cfg, handlerIn);
|
|
if ( !$.isFunction(cfg.out) ) {
|
|
cfg.out = cfg.over;
|
|
}
|
|
} else if ( $.isFunction(handlerOut) ) {
|
|
cfg = $.extend(cfg, { over: handlerIn, out: handlerOut, selector: selector } );
|
|
} else {
|
|
cfg = $.extend(cfg, { over: handlerIn, out: handlerIn, selector: handlerOut } );
|
|
}
|
|
|
|
// A private function for handling mouse 'hovering'
|
|
var handleHover = function(e) {
|
|
// cloned event to pass to handlers (copy required for event object to be passed in IE)
|
|
var ev = $.extend({},e);
|
|
|
|
// the current target of the mouse event, wrapped in a jQuery object
|
|
var $el = $(this);
|
|
|
|
// read hoverIntent data from element (or initialize if not present)
|
|
var hoverIntentData = $el.data('hoverIntent');
|
|
if (!hoverIntentData) { $el.data('hoverIntent', (hoverIntentData = {})); }
|
|
|
|
// read per-instance state from element (or initialize if not present)
|
|
var state = hoverIntentData[instanceId];
|
|
if (!state) { hoverIntentData[instanceId] = state = { id: instanceId }; }
|
|
|
|
// state properties:
|
|
// id = instance ID, used to clean up data
|
|
// timeoutId = timeout ID, reused for tracking mouse position and delaying "out" handler
|
|
// isActive = plugin state, true after `over` is called just until `out` is called
|
|
// pX, pY = previously-measured pointer coordinates, updated at each polling interval
|
|
// event = string representing the namespaced event used for mouse tracking
|
|
|
|
// clear any existing timeout
|
|
if (state.timeoutId) { state.timeoutId = clearTimeout(state.timeoutId); }
|
|
|
|
// namespaced event used to register and unregister mousemove tracking
|
|
var mousemove = state.event = 'mousemove.hoverIntent.hoverIntent'+instanceId;
|
|
|
|
// handle the event, based on its type
|
|
if (e.type === 'mouseenter') {
|
|
// do nothing if already active
|
|
if (state.isActive) { return; }
|
|
// set "previous" X and Y position based on initial entry point
|
|
state.pX = ev.pageX; state.pY = ev.pageY;
|
|
// update "current" X and Y position based on mousemove
|
|
$el.off(mousemove,track).on(mousemove,track);
|
|
// start polling interval (self-calling timeout) to compare mouse coordinates over time
|
|
state.timeoutId = setTimeout( function(){compare(ev,$el,state,cfg);} , cfg.interval );
|
|
} else { // "mouseleave"
|
|
// do nothing if not already active
|
|
if (!state.isActive) { return; }
|
|
// unbind expensive mousemove event
|
|
$el.off(mousemove,track);
|
|
// if hoverIntent state is true, then call the mouseOut function after the specified delay
|
|
state.timeoutId = setTimeout( function(){delay(ev,$el,state,cfg.out);} , cfg.timeout );
|
|
}
|
|
};
|
|
|
|
// listen for mouseenter and mouseleave
|
|
return this.on({'mouseenter.hoverIntent':handleHover,'mouseleave.hoverIntent':handleHover}, cfg.selector);
|
|
};
|
|
});
|