window.cancelAnimationFrame()

La méthode window.cancelAnimationFrame() met fin à une animation précédement configurée par un appel à window.requestAnimationFrame().

Syntaxe

window.cancelAnimationFrame(requestID);

Paramètres

requestID
L'identifiant retourné par l'appel à window.requestAnimationFrame() qui a généré la fonction de rappel (callback)

Exemples

var requestAnimationFrame = window.requestAnimationFrame || window.mozRequestAnimationFrame ||
                            window.webkitRequestAnimationFrame || window.msRequestAnimationFrame;

var cancelAnimationFrame = window.cancelAnimationFrame || window.mozCancelAnimationFrame;

var start = window.mozAnimationStartTime;  // Seulement supporté par Firefox. Les autre navigateurs peuvent utiliser quelque chose comme Date.now()..

var myReq; // Déclarer la variable globalement avant de lancer l'animation

function step(timestamp) {
  var progress = timestamp - start;
  d.style.left = Math.min(progress / 10, 200) + 'px';
  if (progress < 2000) {
    // Ne pas oublier de récupérer l'identifiant à chaque appel de la fonction
    myReq = requestAnimationFrame(step);
  }
}
myReq = requestAnimationFrame(step);
// L'annulation utilise le dernier identifiant
cancelAnimationFrame(myReq);

Spécifications

Spécification
Timing control for script-based animations: cancelAnimationFrameWD

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
cancelAnimationFrameChrome Support complet OuiEdge Support complet 12Firefox Support complet 23
Support complet 23
Aucun support 11 — 23
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : moz
IE Support complet 10Opera Support complet 15Safari Support complet 6.1
Support complet 6.1
Aucun support 6 — 6.1
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
WebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 23
Support complet 23
Aucun support 14 — 23
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : moz
Opera Android Support complet 14Safari iOS Support complet 7Samsung Internet Android Support complet Oui

Légende

Support complet  
Support complet
Cette fonctionnalité nécessite un préfixe particulier ou utilise un autre nom.
Cette fonctionnalité nécessite un préfixe particulier ou utilise un autre nom.

Voir aussi