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
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
transitioncancel event | Chrome Full support 74 | Edge Full support ≤79 | Firefox Full support 53 | IE ? | Opera Full support 62 | Safari
Full support
13.1
| WebView Android Full support 74 | Chrome Android Full support 74 | Firefox Android Full support 53 | Opera Android Full support 53 | Safari iOS
Full support
13.4
| 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
- The
GlobalEventHandlers.ontransitioncancel
event handler - The
TransitionEvent
interface - CSS properties:
transition
,transition-delay
,transition-duration
,transition-property
,transition-timing-function
- Related events:
transitionrun
,transitionstart
,transitionend
- This event on
Document
targets:transitioncancel
- This event on
Window
targets:transitioncancel