HTMLElement: transitioncancel event

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

The transitioncancel event is fired when a CSS transition is canceled.

See GlobalEventHandlers.ontransitioncancel for more information.

Bubbles Yes
Cancelable No
Interface TransitionEvent
Event handler property GlobalEventHandlers.ontransitioncancel

Examples

This code gets an element that has a transition defined and adds a listener to the transitioncancel event:

const transition = document.querySelector('.transition');

transition.addEventListener('transitioncancel', () => {
  console.log('Transition canceled');
});

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

const transition = document.querySelector('.transition');

transition.ontransitioncancel = () => {
  console.log('Transition canceled');
};

Live example

In the following example, we have a simple <div> element, styled with a transition that includes a delay:

<div class="transition"></div>
<div class="message"></div>
.transition {
  width: 100px;
  height: 100px;
  background: rgba(255,0,0,1);
  transition-property: transform background;
  transition-duration: 2s;
  transition-delay: 2s;
}

.transition:hover {
  transform: rotate(90deg);
  background: rgba(255,0,0,0);
}

To this, we'll add some JavaScript to indicate that the transitionstart, transitionrun, transitioncancel and transitionend events fire. In this example, to cancel the transition, stop hovering over the transitioning box before the transition ends. For the transition end event to fire, stay hovered over the transition until the transition ends.

const message = document.querySelector('.message');
const el = document.querySelector('.transition');

el.addEventListener('transitionrun', function() {
  message.textContent = 'transitionrun fired';
});

el.addEventListener('transitionstart', function() {
  message.textContent = 'transitionstart fired';
});

el.addEventListener('transitioncancel', function() {
  message.textContent = 'transitioncancel fired'; 
}); 

el.addEventListener('transitionend', function() {
  message.textContent = 'transitionend fired'; 
});

The transitioncancel event is fired if the transition is cancelled in either direction after the transitionrun event occurs and before the transitionend is fired.

If there is no transition delay or duration, if both are 0s or neither is declared, there is no transition, and none of the transition events are fired.

If the transitioncancel event is fired, the transitionend event will not fire.

Specifications

Specification Status Comment
CSS Transitions
The definition of 'transitioncancel' in that specification.
Working Draft Initial definition.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
transitioncancel eventChrome Full support 74Edge Full support ≤79Firefox Full support 53IE ? Opera Full support 62Safari Full support 13.1
Full support 13.1
Full support 12
Disabled
Disabled From version 12: this feature is behind the Web Animations preference and the CSS Animations via Web Animations preference.
WebView Android Full support 74Chrome Android Full support 74Firefox Android Full support 53Opera Android Full support 53Safari iOS Full support 13.4
Full support 13.4
Full support 12
Disabled
Disabled From version 12: this feature is behind the Web Animations preference and the CSS Animations via Web Animations preference.
Samsung Internet Android Full support 11.0

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown
User must explicitly enable this feature.
User must explicitly enable this feature.

See also