Thetransitioncancel event is fired when aCSS transition is canceled.

Syntax

Use the event name in methods likeaddEventListener(), or set an event handler property.

addEventListener("transitioncancel", (event) => { })ontransitioncancel = (event) => { }

Event type

ATransitionEvent. Inherits fromEvent.

Event properties

Also inherits properties from its parentEvent.

TransitionEvent.propertyNameRead only

A string containing the name CSS property associated with the transition.

TransitionEvent.elapsedTimeRead only

Afloat giving the amount of time the transition has been running, in seconds, when this event fired. This value is not affected by thetransition-delay property.

TransitionEvent.pseudoElementRead only

A string, starting with::, containing the name of thepseudo-element the animation runs on. If the transition doesn't run on a pseudo-element but on the element, an empty string:''.

Examples

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

const transition = document.querySelector(".transition");transition.addEventListener("transitioncancel", () => {  console.log("Transition canceled");});

The same, but using theontransitioncancel property instead ofaddEventListener():

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></div><div></div>

.transition {  width: 100px;  height: 100px;  background: red;  transition-property: transform, background;  transition-duration: 2s;  transition-delay: 2s;}.transition:hover {  transform: rotate(90deg);  background: transparent;}

To this, we'll add some JavaScript to indicate that thetransitionstart,transitionrun,transitioncancel, andtransitionend 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", () => {  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";});

Thetransitioncancel event is fired if the transition is cancelled in either direction after thetransitionrun event occurs and before thetransitionend 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 thetransitioncancel event is fired, thetransitionend event will not fire.

Specifications

Browser compatibility

See also

• TheTransitionEvent interface
• CSS properties:transition,transition-delay,transition-duration,transition-property,transition-timing-function
• Related events:transitionrun,transitionstart,transitionend