Element: transitionrun event
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2020.
Thetransitionrun event is fired when aCSS transition is first created, i.e., before anytransition-delay has begun.
This event is not cancelable.
In this article
Syntax
Use the event name in methods likeaddEventListener(), or set an event handler property.
addEventListener("transitionrun", (event) => { })ontransitionrun = (event) => { }Event type
ATransitionEvent. Inherits fromEvent.
Event properties
Also inherits properties from its parentEvent.
TransitionEvent.propertyNameRead onlyA string containing the name CSS property associated with the transition.
TransitionEvent.elapsedTimeRead onlyA
floatgiving the amount of time the transition has been running, in seconds, when this event fired. This value is not affected by thetransition-delayproperty.TransitionEvent.pseudoElementRead onlyA 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 adds a listener to thetransitionrun event:
el.addEventListener("transitionrun", () => { console.log( "Transition is running but hasn't necessarily started transitioning yet", );});The same, but using theontransitionrun property instead ofaddEventListener():
el.ontransitionrun = () => { console.log( "Transition started running, and will start transitioning when the transition delay has expired", );};Live example
In the following example, we have a simple<div> element, styled with a transition that includes a delay:
<div>Hover over me</div><div></div>.transition { width: 100px; height: 100px; background: red; transition-property: transform, background; transition-duration: 2s; transition-delay: 1s;}.transition:hover { transform: rotate(90deg); background: transparent;}To this, we'll add some JavaScript to indicate where thetransitionstart andtransitionrun events fire.
const el = document.querySelector(".transition");const message = document.querySelector(".message");el.addEventListener("transitionrun", () => { message.textContent = "transitionrun fired";});el.addEventListener("transitionstart", () => { message.textContent = "transitionstart fired";});el.addEventListener("transitionend", () => { message.textContent = "transitionend fired";});The difference is that:
transitionrunfires when the transition is created (i.e., at the start of any delay).transitionstartfires when the actual animation has begun (i.e., at the end of any delay).
Thetransitionrun will occur even if the transition is canceled before the delay expires. If there is no transition delay or if transition-delay is negative, bothtransitionrun andtransitionstart are fired.
Specifications
| Specification |
|---|
| CSS Transitions> # transitionrun> |
Browser compatibility
See also
- The
TransitionEventinterface - CSS properties:
transition,transition-delay,transition-duration,transition-property,transition-timing-function - Related events:
transitionend,transitionstart,transitioncancel