Animation

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éfini le gestionnaire d'événement pour l'événement cancel (annuler).
Animation.onfinish: Retourne et défini 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

Spécification	État	Commentaire
Web Animations La définition de 'Animation' dans cette spécification.	Version de travail	Définition initiale

Compatibilité des navigateurs

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Ordinateur
Mobile

Fonctionnalité	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Support simple	39.0 [1]	48 (48)	Pas de support	Pas de support	Pas de support
effet, ligne temporelle, terminée, prête	Pas de support	Pas de support
Constructeur	Pas de support	48 (48)

Fonctionnalité	Android	Firefox Mobile (Gecko)	IE Phone	Opera Mobile	Safari Mobile
Support simple	(Oui) [1]	48.0 (48)	Pas de support	Pas de support	Pas de support

[1] Les version précédent Chomme 44 implémente AnimationPlayer (le nom de l'interface dans la version précédente de cette spécification).