The ontransitionend
property of the GlobalEventHandlers
mixin is an EventHandler
that processes transitionend
events.
The transitionend
event is sent to when a CSS transition completes.
If the transition is removed from its target node before the transition completes execution, the transitionend
event won't be generated. One way this can happen is by changing the value of the transition-property
attribute which applies to the target. Another is if the display
attribute is set to none
.
Syntax
var transitionEndHandler = target.ontransitionend; target.ontransitionend = Function
Value
A Function
to be called when a transitionend
event occurs indicating that a CSS transition has completed on the target
, where the target object is an HTML element (HTMLElement
), document (Document
), or window (Window
). The function receives as input a single parameter: a TransitionEvent
object describing the event which occurred; the event's TransitionEvent.elapsedTime
property's value should be the same as the value of transition-duration
.
elapsedTime
does not include time prior to the transition effect beginning; that means that the value of transition-delay
doesn't affect the value of elapsedTime
, which is zero until the delay period ends and the animation begins.
Example
In this example, we use the transitionrun
and transitionend
events to detect when the transition begins and ends, to cause a text update to occur during the transition. This could also be used to trigger animations or other effects, to allow chaining of reactions.
HTML
This simply creates a <div>
which we'll style with CSS below to make into a box that resizes and changes color and such.
<div class="box"></div>
CSS
The CSS below styles the box and applies a transition effect which makes the box's color and size change, and causes the box to rotate, while the mouse cursor hovers over it.
.box { margin-left: 70px; margin-top: 30px; border-style: solid; border-width: 1px; display: block; width: 100px; height: 100px; background-color: #0000FF; color: #FFFFFF; padding: 20px; font: bold 1.6em "Helvetica", "Arial", sans-serif; transition: width 2s, height 2s, background-color 2s, transform 2s, color 2s; } .box:hover { background-color: #FFCCCC; color: #000000; width: 200px; height: 200px; transform: rotate(180deg); }
JavaScript
Next, we need to establish our event handlers to change the text content of the box when the transition begins and ends.
let box = document.querySelector(".box");
box.ontransitionrun = function(event) {
box.innerHTML = "Zooming...";
}
box.ontransitionend = function(event) {
box.innerHTML = "Done!";
}
Result
The resulting content looks like this:
Notice what happens when you hover your mouse cursor over the box, then move it away.
Specification
Specification | Status | Comment |
---|---|---|
CSS TransitionsThe definition of 'ontransitionend' in that specification. | Working Draft |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
ontransitionend
|
Chrome Full support Yes Full support Yes Alternate Name' Uses the non-standard name: |
Edge Full support ≤79 Full support ≤79 Alternate Name' Uses the non-standard name: |
Firefox
Full support 51 |
IE
? |
Opera
? |
Safari
Full support Yes |
WebView Android Full support Yes Full support Yes Alternate Name' Uses the non-standard name: |
Chrome Android Full support Yes Full support Yes Alternate Name' Uses the non-standard name: |
Firefox Android
Full support 51 |
Opera Android
? |
Safari iOS
Full support Yes |
Samsung Internet Android Full support Yes Full support Yes Alternate Name' Uses the non-standard name: |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
- Uses a non-standard name.'
- Uses a non-standard name.
See also
- The
transitionend
event this event handler is triggered by TransitionEvent
- The
transitionrun
event, which occurs when the transition begins
GlobalEventHandlers.ontransitionend by Mozilla Contributors is licensed under CC-BY-SA 2.5.