/static/scripts/jquery.event.hover.js

https://bitbucket.org/cistrome/cistrome-harvard/ · JavaScript · 85 lines · 60 code · 8 blank · 17 comment · 10 complexity · 210e4e602473a1bed838bfd7e68fe84b MD5 · raw file

  1. ;(function($){ // secure $ jQuery alias
  2. /*******************************************************************************************/
  3. // jquery.event.hover.js - rev 5
  4. // Copyright (c) 2008, Three Dub Media (http://threedubmedia.com)
  5. // Liscensed under the MIT License (MIT-LICENSE.txt)
  6. // http://www.opensource.org/licenses/mit-license.php
  7. // Created: 2008-06-02 | Updated: 2008-07-30
  8. /*******************************************************************************************/
  9. // USE THESE PROPERTIES TO CUSTOMIZE SETTINGS...
  10. // $.event.special.hover.delay = 100;
  11. // Defines the delay (msec) while mouse is inside the element before checking the speed
  12. // $.event.special.hover.speed = 100;
  13. // Defines the maximum speed (px/sec) the mouse may be moving to trigger the hover event
  14. // save the old jquery "hover" method
  15. $.fn._hover = $.fn.hover;
  16. // jquery method
  17. $.fn.hover = function( fn1, fn2, fn3 ) {
  18. if ( fn3 ) this.bind('hoverstart', fn1 ); // 3 args
  19. if ( fn2 ) this.bind('hoverend', fn3 ? fn3 : fn2 ); // 2+ args
  20. return !fn1 ? this.trigger('hover') // 0 args
  21. : this.bind('hover', fn3 ? fn2 : fn1 ); // 1+ args
  22. };
  23. // special event configuration
  24. var hover = $.event.special.hover = {
  25. delay: 100, // milliseconds
  26. speed: 100, // pixels per second
  27. setup: function( data ){
  28. data = $.extend({ speed: hover.speed, delay: hover.delay, hovered:0 }, data||{} );
  29. $.event.add( this, "mouseenter mouseleave", hoverHandler, data );
  30. },
  31. teardown: function(){
  32. $.event.remove( this, "mouseenter mouseleave", hoverHandler );
  33. }
  34. };
  35. // shared event handler
  36. function hoverHandler( event ){
  37. var data = event.data || event;
  38. switch ( event.type ){
  39. case 'mouseenter': // mouseover
  40. data.dist2 = 0; // init mouse distance?
  41. data.event = event; // store the event
  42. event.type = "hoverstart"; // hijack event
  43. if ( $.event.handle.call( this, event ) !== false ){ // handle "hoverstart"
  44. data.elem = this; // ref to the current element
  45. $.event.add( this, "mousemove", hoverHandler, data ); // track the mouse
  46. data.timer = setTimeout( compare, data.delay ); // start async compare
  47. }
  48. break;
  49. case 'mousemove': // track the event, mouse distance? = x? + y?
  50. data.dist2 += Math.pow( event.pageX-data.event.pageX, 2 )
  51. + Math.pow( event.pageY-data.event.pageY, 2 );
  52. data.event = event; // store current event
  53. break;
  54. case 'mouseleave': // mouseout
  55. clearTimeout( data.timer ); // uncompare
  56. if ( data.hovered ){
  57. event.type = "hoverend"; // hijack event
  58. $.event.handle.call( this, event ); // handle "hoverend"
  59. data.hovered--; // reset flag
  60. }
  61. else $.event.remove( data.elem, "mousemove", hoverHandler ); // untrack
  62. break;
  63. default: // timeout compare // distance? = x? + y? = ( speed * time )?
  64. if ( data.dist2 <= Math.pow( data.speed*( data.delay/1e3 ), 2 ) ){ // speed acceptable
  65. $.event.remove( data.elem, "mousemove", hoverHandler ); // untrack
  66. data.event.type = "hover"; // hijack event
  67. if ( $.event.handle.call( data.elem, data.event ) !== false ) // handle "hover"
  68. data.hovered++; // flag for "hoverend"
  69. }
  70. else data.timer = setTimeout( compare, data.delay ); // async recurse
  71. data.dist2 = 0; // reset distance? for next compare
  72. break;
  73. }
  74. function compare(){ hoverHandler( data ); }; // timeout/recursive function
  75. };
  76. /*******************************************************************************************/
  77. })(jQuery); // confine scope