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.
var cancelHandler = Animation.oncancel; Animation.oncancel = cancelHandler;
A function to be executed when the animation is cancelled, or null
if there is no cancel
event handler.
If this animation is canceled, remove its element.
animation.oncancel = animation.effect.target.remove();
Specification | Status | Comment |
---|---|---|
Web Animations The definition of 'Animation.oncancel' in that specification. | Working Draft | Editor's draft. |
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
.
Animation
cancel
event
© 2005–2017 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Animation/oncancel