Web Animations
The finish event of the Animation interface is fired when the animation finishes playing, either when the animation completes naturally, or
when the Animation.finish() method is called to immediately cause the
animation to finish up.
[!NOTE] The
"paused"play state supersedes the"finished"play state; if the animation is both paused and finished, the"paused"state is the one that will be reported. You can force the animation into the"finished"state by setting its Animation.startTime todocument.timeline.currentTime - (Animation.currentTime * Animation.playbackRate).
Syntax
Use the event name in EventTarget/addEventListener:
addEventListener("finish", (event) => { })
Alternatively, assign to the event handler property of the interface:
onfinish = (event) => { }
Event type
An AnimationPlaybackEvent. Inherits from Event.
AnimationPlaybackEvent
Examples
Animation.onfinish is used several times in the Alice in Web Animations API Land
Growing/Shrinking Alice Game.
Here is one instance where we add pointer events back to an element after
its opacity animation has faded it in:
// Add an animation to the game's ending credits
const endingUI = document.getElementById("ending-ui");
const bringUI = endingUI.animate(keysFade, timingFade);
// Pause said animation's credits
bringUI.pause();
// This function removes pointer events on the credits.
hide(endingUI);
// When the credits are later faded in,
// we re-add the pointer events when they're done
bringUI.onfinish = (event) => {
endingUI.style.pointerEvents = "auto";
};
Specifications
Browser compatibility
See also
- Web Animations API
- Animation
- Animation.finish()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
