--- /dev/null
+/**\r
+ * jQuery.timers - Timer abstractions for jQuery\r
+ * Written by Blair Mitchelmore (blair DOT mitchelmore AT gmail DOT com)\r
+ * Licensed under the WTFPL (http://sam.zoy.org/wtfpl/).\r
+ * Date: 2009/10/16\r
+ *\r
+ * @author Blair Mitchelmore\r
+ * @version 1.2\r
+ *\r
+ **/\r
+\r
+jQuery.fn.extend({\r
+ everyTime: function(interval, label, fn, times) {\r
+ return this.each(function() {\r
+ jQuery.timer.add(this, interval, label, fn, times);\r
+ });\r
+ },\r
+ oneTime: function(interval, label, fn) {\r
+ return this.each(function() {\r
+ jQuery.timer.add(this, interval, label, fn, 1);\r
+ });\r
+ },\r
+ stopTime: function(label, fn) {\r
+ return this.each(function() {\r
+ jQuery.timer.remove(this, label, fn);\r
+ });\r
+ }\r
+});\r
+\r
+jQuery.extend({\r
+ timer: {\r
+ global: [],\r
+ guid: 1,\r
+ dataKey: "jQuery.timer",\r
+ regex: /^([0-9]+(?:\.[0-9]*)?)\s*(.*s)?$/,\r
+ powers: {\r
+ // Yeah this is major overkill...\r
+ 'ms': 1,\r
+ 'cs': 10,\r
+ 'ds': 100,\r
+ 's': 1000,\r
+ 'das': 10000,\r
+ 'hs': 100000,\r
+ 'ks': 1000000\r
+ },\r
+ timeParse: function(value) {\r
+ if (value == undefined || value == null)\r
+ return null;\r
+ var result = this.regex.exec(jQuery.trim(value.toString()));\r
+ if (result[2]) {\r
+ var num = parseFloat(result[1]);\r
+ var mult = this.powers[result[2]] || 1;\r
+ return num * mult;\r
+ } else {\r
+ return value;\r
+ }\r
+ },\r
+ add: function(element, interval, label, fn, times) {\r
+ var counter = 0;\r
+\r
+ if (jQuery.isFunction(label)) {\r
+ if (!times)\r
+ times = fn;\r
+ fn = label;\r
+ label = interval;\r
+ }\r
+\r
+ interval = jQuery.timer.timeParse(interval);\r
+\r
+ if (typeof interval != 'number' || isNaN(interval) || interval < 0)\r
+ return;\r
+\r
+ if (typeof times != 'number' || isNaN(times) || times < 0)\r
+ times = 0;\r
+\r
+ times = times || 0;\r
+\r
+ var timers = jQuery.data(element, this.dataKey) || jQuery.data(element, this.dataKey, {});\r
+\r
+ if (!timers[label])\r
+ timers[label] = {};\r
+\r
+ fn.timerID = fn.timerID || this.guid++;\r
+\r
+ var handler = function() {\r
+ if ((++counter > times && times !== 0) || fn.call(element, counter) === false)\r
+ jQuery.timer.remove(element, label, fn);\r
+ };\r
+\r
+ handler.timerID = fn.timerID;\r
+\r
+ if (!timers[label][fn.timerID])\r
+ timers[label][fn.timerID] = window.setInterval(handler,interval);\r
+\r
+ this.global.push( element );\r
+\r
+ },\r
+ remove: function(element, label, fn) {\r
+ var timers = jQuery.data(element, this.dataKey), ret;\r
+\r
+ if ( timers ) {\r
+\r
+ if (!label) {\r
+ for ( label in timers )\r
+ this.remove(element, label, fn);\r
+ } else if ( timers[label] ) {\r
+ if ( fn ) {\r
+ if ( fn.timerID ) {\r
+ window.clearInterval(timers[label][fn.timerID]);\r
+ delete timers[label][fn.timerID];\r
+ }\r
+ } else {\r
+ for ( var fn in timers[label] ) {\r
+ window.clearInterval(timers[label][fn]);\r
+ delete timers[label][fn];\r
+ }\r
+ }\r
+\r
+ for ( ret in timers[label] ) break;\r
+ if ( !ret ) {\r
+ ret = null;\r
+ delete timers[label];\r
+ }\r
+ }\r
+\r
+ for ( ret in timers ) break;\r
+ if ( !ret )\r
+ jQuery.removeData(element, this.dataKey);\r
+ }\r
+ }\r
+ }\r
+});\r
+\r
+jQuery(window).bind("unload", function() {\r
+ jQuery.each(jQuery.timer.global, function(index, item) {\r
+ jQuery.timer.remove(item);\r
+ });\r
+});\r