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 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 = 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 | 39.0 | 48 (48)[1] | No support | No support | No support |
| Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | (Yes) | 48.0 (48)[1] | No support | No support | No support |
[1] The Web Animations API is only enabled by default in Firefox Developer Edition and Nightly builds. You can enable it in beta and release builds by setting the preference dom.animations-api.core.enabled to true, and can disable it in any Firefox version by setting this preference to false.
See also
- Web Animations API
Animation- The
cancelevent