This is an experimental technologyCheck 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 AnimationsThe definition of 'Animation.oncancel' in that specification. | Working Draft | Editor's draft. |
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.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome
Full support 50 |
Edge
Full support 79 |
Firefox Full support 48 Full support 48 No support 46 — 48 Disabled' From version 46 until version 48 (exclusive): this feature is behind the |
IE
No support No |
Opera
Full support 37 |
Safari
No support No |
WebView Android
Full support 50 |
Chrome Android
Full support 50 |
Firefox Android Full support 48 Full support 48 No support 46 — 48 Disabled' From version 46 until version 48 (exclusive): this feature is behind the |
Opera Android
Full support 37 |
Safari iOS
No support No |
Samsung Internet Android
Full support 5.0 |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.'
- Experimental. Expect behavior to change in the future.
- User must explicitly enable this feature.'
- User must explicitly enable this feature.
See also
- Web Animations API
Animation
- The
cancel
event
Animation.oncancel by Mozilla Contributors is licensed under CC-BY-SA 2.5.