Added in the .delay() method for delaying the execution of queued functions and animations.

jeresig · jeresig · commit bbd933cbfe6d · 2009-12-04T12:06:47.000-05:00
diff --git a/src/data.js b/src/data.js
@@ -166,6 +166,21 @@ jQuery.fn.extend({
 			jQuery.dequeue( this, type );
 		});
 	},
+
+	// Based off of the plugin by Clint Helfers, with permission.
+	// http://blindsignals.com/index.php/2009/07/jquery-delay/
+	delay: function( time, type ) {
+		time = jQuery.fx ? jQuery.fx.speeds[time] || time : time;
+		type = type || "fx";
+
+		return this.queue( type, function() {
+			var elem = this;
+			setTimeout(function() {
+				jQuery.dequeue( elem, type );
+			}, time );
+		});
+	},
+
 	clearQueue: function(type){
 		return this.queue( type || "fx", [] );
 	}
diff --git a/test/unit/data.js b/test/unit/data.js
@@ -257,6 +257,21 @@ test("queue() passes in the next item in the queue as a parameter to fx queues",
 
 });
 
+test("delay()", function() {
+	expect(2);
+	stop();
+
+	var foo = jQuery({}), run = 0;
+
+	foo.delay(100).queue(function(){
+		run = 1;
+		ok( true, "The function was dequeued." );
+		start();
+	});
+
+	equals( run, 0, "The delay delayed the next function from running." );
+});
+
 test("clearQueue(name) clears the queue", function() {
 	expect(1);
 	
