The transitioncancel
event is fired when a CSS transition is canceled.
The transitioncancel
event is fired when a CSS transition is canceled.
Use the event name in methods like addEventListener()
, or set an event handler property.
js
addEventListener("transitioncancel", (event) => {}); ontransitioncancel = (event) => {};
A TransitionEvent
. Inherits from Event
.
Also inherits properties from its parent Event
.
TransitionEvent.propertyName
Read only
A string containing the name CSS property associated with the transition.
TransitionEvent.elapsedTime
Read only
A float
giving the amount of time the transition has been running, in seconds, when this event fired. This value is not affected by the transition-delay
property.
TransitionEvent.pseudoElement
Read only
A string, starting with ::
, containing the name of the pseudo-element the animation runs on. If the transition doesn't run on a pseudo-element but on the element, an empty string: ''
.
This code gets an element that has a transition defined and adds a listener to the transitioncancel
event:
js
const transition = document.querySelector(".transition"); transition.addEventListener("transitioncancel", () => { console.log("Transition canceled"); });
The same, but using the ontransitioncancel
property instead of addEventListener()
:
js
const transition = document.querySelector(".transition"); transition.ontransitioncancel = () => { console.log("Transition canceled"); };
In the following example, we have a simple <div>
element, styled with a transition that includes a delay:
html
<div class="transition"></div> <div class="message"></div>
css
.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.
js
const message = document.querySelector(".message"); const el = document.querySelector(".transition"); el.addEventListener("transitionrun", () => { message.textContent = "transitionrun fired"; }); el.addEventListener("transitionstart", () => { message.textContent = "transitionstart fired"; }); el.addEventListener("transitioncancel", () => { message.textContent = "transitioncancel fired"; }); el.addEventListener("transitionend", () => { 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.
Specification |
---|
CSS Transitions # transitioncancel |
CSS Transitions # dom-globaleventhandlers-ontransitioncancel |
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
transitioncancel_event |
8774–87Theontransitioncancel event handler property is not supported. To listen to this event, use element.addEventListener('transitioncancel', function() {}); . |
8779–87Theontransitioncancel event handler property is not supported. To listen to this event, use element.addEventListener('transitioncancel', function() {}); . |
53 | No | 7362–73Theontransitioncancel event handler property is not supported. To listen to this event, use element.addEventListener('transitioncancel', function() {}); . |
13.112–13.1Although theontransitioncancel event handler property is supported, the transitioncancel event is never fired. |
8774–87Theontransitioncancel event handler property is not supported. To listen to this event, use element.addEventListener('transitioncancel', function() {}); . |
8774–87Theontransitioncancel event handler property is not supported. To listen to this event, use element.addEventListener('transitioncancel', function() {}); . |
53 | 6253–62Theontransitioncancel event handler property is not supported. To listen to this event, use element.addEventListener('transitioncancel', function() {}); . |
13.412–13.4Although theontransitioncancel event handler property is supported, the transitioncancel event is never fired. |
14.011.0–14.0Theontransitioncancel event handler property is not supported. To listen to this event, use element.addEventListener('transitioncancel', function() {}); . |
TransitionEvent
interfacetransition
, transition-delay
, transition-duration
, transition-property
, transition-timing-function
transitionrun
, transitionstart
, transitionend
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/transitioncancel_event