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 iterations
property of AnimationEffectTimingReadOnly
represents the number of times the animation should repeat. It defaults to 1
, and can also take a value of Infinity
to make it loop infinitely.
Note: In AnimationEffectTiming
, a mutable subclass of AnimationEffectTimingReadOnly
used withKeyframeEffects
, the property acts as both a getter and a setter.
Syntax
// Getting the number of iterations var animationLoops = animation.effect.timing.iterations; // Setting the number of iterations animation.effect.timing.iterations = 2.3;
Value
A whole number or decimal greater than or equal to 0
, or Infinity
. Defaults to 0
.
Examples
In the Red Queen's Race example, we can inspect the timing property on the redQueen_alice
animation to discover how many loops Alice and the Red Queen's animation has:
// Infinity return redQueen_alice.effect.timing.iterations;
Specifications
Specification | Status | Comment |
---|---|---|
Web Animations The definition of 'AnimationEffectTimingReadOnly.iterations' in that specification. |
Working Draft | Editor's draft. |
Browser compatibility
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 |
See also
- Web Animations API
AnimationEffectReadOnly.timing
returns aAnimationEffectTimingReadOnly
object...- ...while
AnimationEffect.timing
returns a mutableAnimationEffectTiming
object. - CSS's
animation-iteration-count