Animation

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.

Expérimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

L'interface Animation de l'API Web Animations correspond à un lecteur d'animations et offre les commandes nécessaires au contrôle et à la chronologie d'un noeud ou d'une source d'animation.

Constructeur

Animation(): Crée une nouvelle instance de l'objet Animation.

Propriétés

Animation.currentTime: La valeur actuelle de temps de l'animation en millisecondes, que l'animation soit en pause ou en cours. Si l'animation ne possède pas de timeline, est inactive ou n'a toujours pas été lancée, la valeur est null.

Animation.effect: Récupère et défini le KeyframeEffect associé à cette animation.
Animation.finished Lecture seule: Retourne la Promise terminée en cours pour cette animation.

Animation.id: Récupère et défini le String utilisé pour identifier l'animation.
Animation.playState Lecture seule: Retourne une valeur énumérée qui décit l'état de lecture de l'animation.

Animation.playbackRate: Retourne et défini la fréquence de lecture de l'animation.

Animation.ready Lecture seule: Retourne la Promise prête en cours pour l'animation.

Animation.startTime: Retourne et défini le moment prévu auquel la lecture de l'animation devrait commencer.

Animation.timeline: Retourne et défini la timeline associée à cette animation.

Gestionnaire d'événements

Animation.oncancel: Retourne et définit le gestionnaire d'évènement pour l'évènement cancel (annuler).
Animation.onfinish: Retourne et définit le gestionnaire d'évènement pour l'évènement finish (terminer).

Méthodes

Animation.cancel(): Supprime toutes les keyframeEffects dues à cette animation et interomp la lecture.

Animation.finish(): Cherche la fin de l'animation, en fonction que l'animation soit en lecture normale ou inversée.

Animation.pause(): Suspend la lecture de l'animation.

Animation.play(): Démarre ou reprend la lecture de l'animation, ou redémarre l'animation au début si celle-ci est déjà terminée.

Animation.reverse(): Inverse la direction de lecture, en s'arrêtant au début de l'animation. Si l'animation est terminée ou annulée, elle sera jouée de la fin vers le début.

Spécifications

Specification
Web Animations # the-animation-interface