Document: animationcancel event

Experimental

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The animationcancel event is fired when a CSS Animation unexpectedly aborts. In other words, any time it stops running without sending an animationend event. This might happen when the animation-name is changed such that the animation is removed, or when the animating node is hidden using CSS. Therefore, either directly or because any of its containing nodes are hidden.

Bubbles Yes
Cancelable No
Interface AnimationEvent
Event handler property onanimationcancel

The original target for this event is the Element that had the animation applied. You can listen for this event on the Document interface to handle it in the capture or bubbling phases. For full details on this event please see the page on HTMLElement: animationcancel.

Examples

This code adds a listener to the animationcancel event.

document.addEventListener('animationcancel', () => {
  console.log('Animation canceled');
});

The same, but using the onanimationcancel property instead of addEventListener():

document.onanimationcancel = () => {
  console.log('Animation canceled');
};

See a live example of this event.

Specifications

Specification Status Comment
CSS Animations Level 1 Working Draft Initial definition

Browser compatibility

BCD tables only load in the browser

See also