Animation
=========

Baseline 2022
-------------

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

* Learn more
* See full compatibility
* Report feedback
**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()` (en-US)

Crée une nouvelle instance de l'objet `Animation`.

Propriétés
----------

`Animation.currentTime` (en-US)

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` (en-US), est inactive ou n'a toujours pas été lancée, la valeur est `null`.


`Animation.effect` (en-US)

Récupère et défini le `KeyframeEffect` (en-US) associé à cette animation.

`Animation.finished` (en-US) Lecture seule 

Retourne la `Promise` terminée en cours pour cette animation.


`Animation.id` (en-US)

Récupère et défini le `String` utilisé pour identifier l'animation.

`Animation.playState` (en-US) Lecture seule 

Retourne une valeur énumérée qui décit l'état de lecture de l'animation.


`Animation.playbackRate` (en-US)

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


`Animation.ready` (en-US) 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` (en-US)

Retourne et défini la `timeline` (en-US) associée à cette animation.

### Gestionnaire d'événements

`Animation.oncancel` (en-US)

Retourne et définit le gestionnaire d'évènement pour l'évènement `cancel` (annuler).

`Animation.onfinish` (en-US)

Retourne et définit le gestionnaire d'évènement pour l'évènement `finish` (terminer).

Méthodes
--------

`Animation.cancel()` (en-US)

Supprime toutes les `keyframeEffects` (en-US) dues à cette animation et interomp la lecture.


`Animation.finish()` (en-US)

Cherche la fin de l'animation, en fonction que l'animation soit en lecture normale ou inversée.


`Animation.pause()` (en-US)

Suspend la lecture de l'animation.


`Animation.play()` (en-US)

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()` (en-US)

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 with JavaScript enabled. Enable JavaScript to view data.