Animation.oncancel

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

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
oncancel
Experimental
Chrome Full support 50Edge Full support ≤79Firefox Full support 48
Full support 48
No support 46 — 48
Disabled
Disabled From version 46 until version 48 (exclusive): this feature is behind the dom.animations-api.core.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE No support NoOpera Full support 37Safari No support NoWebView Android Full support 50Chrome Android Full support 50Firefox Android Full support 48
Full support 48
No support 46 — 48
Disabled
Disabled From version 46 until version 48 (exclusive): this feature is behind the dom.animations-api.core.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Full support 37Safari iOS No support NoSamsung 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