This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The oncancel
property of the Web Animations API's Animation
interface is the event handler for the cancel
event.
The cancel
event can be triggered manually with Animation.cancel()
when the animation enters the "idle"
play state from another state, such as when the animation is removed from an element before it finishes playing
Creating a new animation that is initially idle does not trigger a cancel
event on the new animation.
Syntax
var cancelHandler = Animation.oncancel; Animation.oncancel = cancelHandler;
Value
A function to be executed when the animation is cancelled, or null
if there is no cancel
event handler.
Examples
If this animation is canceled, remove its element.
animation.oncancel = function() { animation.effect.target.remove(); };
Specifications
Specification | Status | Comment |
---|---|---|
Web Animations The definition of 'Animation.oncancel' in that specification. |
Working Draft | Editor's draft. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 50 | 48 (48) | No support | 37 | No support |
Feature | Android Webview | Chrome for Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | 50 | 50 | 48.0 (48) | No support | 37 | No support |
See also
- Web Animations API
Animation
- The
cancel
event