jquery.timer.js 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147
  1. /**
  2. * jQuery.timers - Timer abstractions for jQuery
  3. * Written by Blair Mitchelmore (blair DOT mitchelmore AT gmail DOT com)
  4. * Licensed under the WTFPL (http://sam.zoy.org/wtfpl/).
  5. * Date: 2009/02/08
  6. *
  7. * @author Blair Mitchelmore
  8. * @version 1.1.2
  9. *
  10. **/
  11. jQuery.fn.extend({
  12. everyTime: function(interval, label, fn, times, belay) {
  13. return this.each(function() {
  14. jQuery.timer.add(this, interval, label, fn, times, belay);
  15. });
  16. },
  17. oneTime: function(interval, label, fn) {
  18. return this.each(function() {
  19. jQuery.timer.add(this, interval, label, fn, 1);
  20. });
  21. },
  22. stopTime: function(label, fn) {
  23. return this.each(function() {
  24. jQuery.timer.remove(this, label, fn);
  25. });
  26. }
  27. });
  28. jQuery.event.special
  29. jQuery.extend({
  30. timer: {
  31. global: [],
  32. guid: 1,
  33. dataKey: "jQuery.timer",
  34. regex: /^([0-9]+(?:\.[0-9]*)?)\s*(.*s)?$/,
  35. powers: {
  36. // Yeah this is major overkill...
  37. 'ms': 1,
  38. 'cs': 10,
  39. 'ds': 100,
  40. 's': 1000,
  41. 'das': 10000,
  42. 'hs': 100000,
  43. 'ks': 1000000
  44. },
  45. timeParse: function(value) {
  46. if (value == undefined || value == null)
  47. return null;
  48. var result = this.regex.exec(jQuery.trim(value.toString()));
  49. if (result[2]) {
  50. var num = parseFloat(result[1]);
  51. var mult = this.powers[result[2]] || 1;
  52. return num * mult;
  53. } else {
  54. return value;
  55. }
  56. },
  57. add: function(element, interval, label, fn, times, belay) {
  58. var counter = 0;
  59. if (jQuery.isFunction(label)) {
  60. if (!times)
  61. times = fn;
  62. fn = label;
  63. label = interval;
  64. }
  65. interval = jQuery.timer.timeParse(interval);
  66. if (typeof interval != 'number' || isNaN(interval) || interval <= 0)
  67. return;
  68. if (times && times.constructor != Number) {
  69. belay = !!times;
  70. times = 0;
  71. }
  72. times = times || 0;
  73. belay = belay || false;
  74. var timers = jQuery.data(element, this.dataKey) || jQuery.data(element, this.dataKey, {});
  75. if (!timers[label])
  76. timers[label] = {};
  77. fn.timerID = fn.timerID || this.guid++;
  78. var handler = function() {
  79. if (belay && this.inProgress)
  80. return;
  81. this.inProgress = true;
  82. if ((++counter > times && times !== 0) || fn.call(element, counter) === false)
  83. jQuery.timer.remove(element, label, fn);
  84. this.inProgress = false;
  85. };
  86. handler.timerID = fn.timerID;
  87. if (!timers[label][fn.timerID])
  88. timers[label][fn.timerID] = window.setInterval(handler,interval);
  89. this.global.push( element );
  90. },
  91. remove: function(element, label, fn) {
  92. var timers = jQuery.data(element, this.dataKey), ret;
  93. if ( timers ) {
  94. if (!label) {
  95. for ( label in timers )
  96. this.remove(element, label, fn);
  97. } else if ( timers[label] ) {
  98. if ( fn ) {
  99. if ( fn.timerID ) {
  100. window.clearInterval(timers[label][fn.timerID]);
  101. delete timers[label][fn.timerID];
  102. }
  103. } else {
  104. for ( var fn in timers[label] ) {
  105. window.clearInterval(timers[label][fn]);
  106. delete timers[label][fn];
  107. }
  108. }
  109. for ( ret in timers[label] ) break;
  110. if ( !ret ) {
  111. ret = null;
  112. delete timers[label];
  113. }
  114. }
  115. for ( ret in timers ) break;
  116. if ( !ret )
  117. jQuery.removeData(element, this.dataKey);
  118. }
  119. }
  120. }
  121. });
  122. jQuery(window).bind("unload", function() {
  123. jQuery.each(jQuery.timer.global, function(index, item) {
  124. jQuery.timer.remove(item);
  125. });
  126. });