transitionend

Cette traduction est incomplète. Aidez-nous à traduire cet article depuis l’anglais

L'événement transitionend est déclenché lorsqu'une transition CSS est terminée. Dans le cas où une transition est supprimée avant la fin, par exemple si transition-property est supprimé ou display est défini sur none, alors l'événement ne pourra pas être généré.

Bulles Oui
Annulable Oui
Interface TransitionEvent
Propriété de gestionnaire d'événements ontransitionend

L'événement transitionend est déclenché dans les deux sens - à la fin de la transition vers l'état de transition et lorsqu'il revient complètement à l'état par défaut ou sans transition. S'il n'y a pas de délai ou de durée de transition, si les deux sont 0 ou qu'aucun n'est déclaré, il n'y a pas de transition et aucun des événements de transition n'est déclenché.  Si l'événement transitioncancel est déclenché, l'événement transitionend ne se déclenchera pas.

Propriétés

Propriétés Type Description
target Lecture seule EventTarget The event target (the topmost target in the DOM tree).
type Lecture seule DOMString The type of event.
bubbles Lecture seule Boolean Whether the event normally bubbles or not.
cancelable Lecture seule Boolean Whether the event is cancellable or not.
propertyName Lecture seule DOMString The name of the CSS property associated with the transition.
elapsedTime Lecture seule Float The amount of time the transition has been running, in seconds, as of the time the event was generated. This value is not affected by the value of transition-delay.
pseudoElement Lecture seule DOMString The name (beginning with two colons) of the CSS pseudo-element on which the transition occured (in which case the target of the event is that pseudo-element's corresponding element), or the empty string if the transition occurred on an element (which means the target of the event is that element).

Examples

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

const transition = document.querySelector('.transition');

transition.addEventListener('transitionend', () => {
  console.log('Transition ended');
});

The same, but using the ontransitionend:

const transition = document.querySelector('.transition');

transition.ontransitionend = () => {
  console.log('Transition ended');
};

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: rgba(255,0,0,1);
  transition-property: transform background;
  transition-duration: 2s;
  transition-delay: 1s;
}

.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.

const message = document.querySelector('.message');
const el = document.querySelector('.transition');

el.addEventListener('transitionrun', function() {
  message.textContent = 'transitionrun fired';
});

el.addEventListener('transitionstart', function() {
  message.textContent = 'transitionstart fired';
});

el.addEventListener('transitioncancel', function() {
  message.textContent = 'transitioncancel fired'; 
}); 

el.addEventListener('transitionend', function() {
  message.textContent = 'transitionend fired'; 
});

The transitionend event is fired in both directions: when the box finishes turning and the opacity hits 0 or 1, depending on the direction.

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.

Spécifications

Spécification Statut Commentaire
CSS Transitions
La définition de 'transitionend' dans cette spécification.
Version de travail Définition initiale.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
transitionend eventChrome Support complet 26
Support complet 26
Support complet 1
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : webkitTransitionEnd
Edge Support complet ≤79
Support complet ≤79
Support complet ≤79
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : webkitTransitionEnd
Firefox Support complet 51IE Support complet 10Opera Support complet 12.1
Support complet 12.1
Support complet 15
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : webkitTransitionEnd
Aucun support 11.6 — 15
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : oTransitionEnd
Safari Support complet 6.1
Support complet 6.1
Support complet 4
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : webkitTransitionEnd
WebView Android Support complet ≤37
Support complet ≤37
Support complet 1
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : webkitTransitionEnd
Chrome Android Support complet 26
Support complet 26
Support complet 18
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : webkitTransitionEnd
Firefox Android Support complet 51Opera Android Support complet 12.1
Support complet 12.1
Support complet 14
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : webkitTransitionEnd
Aucun support 12 — 14
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : oTransitionEnd
Safari iOS Support complet 7
Support complet 7
Support complet 3.2
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : webkitTransitionEnd
Samsung Internet Android Support complet 1.5
Support complet 1.5
Support complet 1.0
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : webkitTransitionEnd

Légende

Support complet  
Support complet
Cette fonctionnalité utilise un nom non-standard.
Cette fonctionnalité utilise un nom non-standard.

Voir également