The animationiteration
event is fired when an iteration of a CSS Animation ends, and another one begins. This event does not occur at the same time as the animationend
event, and therefore does not occur for animations with an animation-iteration-count
of one.
Bubbles | Yes |
---|---|
Cancelable | No |
Interface | AnimationEvent |
Event handler property | onanimationiteration |
The original target for this event is the Element
that had the animation applied. You can listen for this event on the Window
interface to handle it in the capture or bubbling phases. For full details on this event please see the page on HTMLElement: animationiteration.
Examples
This code uses animationiteration
to keep track of the number of iterations an animation has completed:
let iterationCount = 0; window.addEventListener('animationiteration', () => { iterationCount++; console.log(`Animation iteration count: ${iterationCount}`); });
The same, but using the onanimationiteration
event handler property:
let iterationCount = 0; window.onanimationiteration = () => { iterationCount++; console.log(`Animation iteration count: ${iterationCount}`); };
See a live example of this event.
Specifications
Specification | Status | Comment |
---|---|---|
CSS Animations | Working Draft | Initial definition |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
animationiteration event | Chrome
Full support
43
| Edge
Full support
≤79
| Firefox Full support 51 | IE ? | Opera ? | Safari Full support 9 | WebView Android
Full support
43
| Chrome Android
Full support
43
| Firefox Android Full support 51 | Opera Android ? | Safari iOS Full support 9 | Samsung Internet Android
Full support
4.0
|
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
- Requires a vendor prefix or different name for use.
- Requires a vendor prefix or different name for use.
See also
- CSS Animations
- Using CSS Animations
AnimationEvent
- Related events:
animationstart
,animationend
,animationcancel
- This event on
Document
targets:animationiteration
- This event on
HTMLElement
targets:animationiteration