Delay

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

The delay property of the Web Animations API represents the number of milliseconds to delay the start of the animation.

Note: Element.animate(), KeyframeEffectReadOnly.KeyframeEffectReadOnly(), and KeyframeEffect.KeyframeEffect() all accept an object of timing properties including delay. The value of delay corresponds directly to AnimationEffectTimingReadOnly.delay in timing objects returned by AnimationEffectReadOnly, KeyframeEffectReadOnly, and KeyframeEffect.

Syntax

// Delay the animation by 1 second
var timingProperties = {
  delay: 1000
}

Value

A number representing milliseconds. Defaults to 0.

Examples

In the Pool of Tears example, each tear is passed a random delay via its timing object:

// Randomizer function
var getRandomMsRange = function(min, max) {
  return Math.random() * (max - min) + min;
}

// Loop through each tear
tears.forEach(function(el) {  

  // Animate each tear
  el.animate(
    tearsFalling, 
    {
      delay: getRandomMsRange(-1000, 1000), // randomized for each tear
      duration: getRandomMsRange(2000, 6000), // randomized for each tear
      iterations: Infinity,
      easing: "cubic-bezier(0.6, 0.04, 0.98, 0.335)"
    });
});

Specifications

Specification	Status	Comment
Web Animations The definition of 'delay' in that specification.	Working Draft	Editor's draft.

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Basic support	(Yes)	48 (48)	No support	(Yes)	No support

Feature	Android	Android Webview	Chrome for Android	Firefox Mobile (Gecko)	Firefox OS	IE Mobile	Opera Mobile	Safari Mobile
Basic support	?	?	?	?	?	No support	No support	No support

Delay

Syntax

Value

Examples

Specifications

Browser compatibility

See also

Document Tags and Contributors