Animation

Baseline 2022

Newly available

Since September 2022, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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

Compatibilité des navigateurs

BCD tables only load in the browser