Element: transitionstart event
The transitionstart event is fired when a CSS transition has actually started, i.e., after any transition-delay has ended.
This event is not cancelable.
Syntax
Use the event name in methods like addEventListener(), or set an event handler property.
addEventListener("transitionstart", (event) => {});
ontransitionstart = (event) => {};
Event type
A TransitionEvent. Inherits from Event.
Event properties
Also inherits properties from its parent Event.
TransitionEvent.propertyNameRead only-
A string containing the name CSS property associated with the transition.
TransitionEvent.elapsedTimeRead only-
A
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 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:''.
Examples
This code adds a listener to the transitionstart event:
element.addEventListener("transitionstart", () => {
console.log("Started transitioning");
});
The same, but using the ontransitionstart property instead of addEventListener():
element.ontransitionstart = () => {
console.log("Started transitioning");
};
Live example
In the following example, we have a simple <div> element, styled with a transition that includes a delay:
<div class="transition">Hover over me</div>
<div class="message"></div>
.transition {
width: 100px;
height: 100px;
background: rgb(255 0 0 / 100%);
transition-property: transform, background;
transition-duration: 2s;
transition-delay: 1s;
}
.transition:hover {
transform: rotate(90deg);
background: rgb(255 0 0 / 0%);
}
To this, we'll add some JavaScript to indicate where the transitionstart and transitionrun events fire.
const transition = document.querySelector(".transition");
const message = document.querySelector(".message");
transition.addEventListener("transitionrun", () => {
message.textContent = "transitionrun fired";
});
transition.addEventListener("transitionstart", () => {
message.textContent = "transitionstart fired";
});
transition.addEventListener("transitionend", () => {
message.textContent = "transitionend fired";
});
The difference is that:
- transitionrun fires when the transition is created (i.e. at the start of any delay).
- transitionstart fires when the actual animation has begun (i.e. at the end of any delay).
Specifications
| Specification |
|---|
| CSS Transitions # transitionstart |
Browser compatibility
BCD tables only load in the browser
See also
- The
TransitionEventinterface - CSS properties:
transition,transition-delay,transition-duration,transition-property,transition-timing-function - Related events:
transitionend,transitionrun,transitioncancel