1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
---
title: Animation
slug: Web/API/Animation
tags:
- API
- Animations
- Experimental
- Interface
- Reference
- Web Animations
- waapi
- web animation api
translation_of: Web/API/Animation
---
{{ APIRef("Web Animations API") }}{{SeeCompatTable}}
L'interface **`Animation`** de [l'API Web Animations](/en-US/docs/Web/API/Web_Animations_API) 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
- {{domxref("Animation.Animation()", "Animation()")}}
- : Crée une nouvelle instance de l'objet `Animation`.
## Propriétés
- {{domxref("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 {{domxref("AnimationTimeline", "timeline")}}, est inactive ou n'a toujours pas été lancée, la valeur est `null`.
<!---->
- {{domxref("Animation.effect")}}
- : Récupère et défini le {{domxref("KeyframeEffect")}} associé à cette animation.
- {{domxref("Animation.finished")}} {{readOnlyInline}}
- : Retourne la `Promise `terminée en cours pour cette animation.
<!---->
- {{domxref("Animation.id")}}
- : Récupère et défini le `String` utilisé pour identifier l'animation.
- {{domxref("Animation.playState")}} {{readOnlyInline}}
- : Retourne une valeur énumérée qui décit l'état de lecture de l'animation.
<!---->
- {{domxref("Animation.playbackRate")}}
- : Retourne et défini la fréquence de lecture de l'animation.
<!---->
- {{domxref("Animation.ready")}} {{readOnlyInline}}
- : Retourne la `Promise `prête en cours pour l'animation.
<!---->
- {{domxref("Animation.startTime")}}
- : Retourne et défini le moment prévu auquel la lecture de l'animation devrait commencer.
<!---->
- {{domxref("Animation.timeline")}}
- : Retourne et défini la {{domxref("AnimationTimeline", "timeline")}} associée à cette animation.
### Gestionnaire d'événements
- {{domxref("Animation.oncancel")}}
- : Retourne et défini le gestionnaire d'événement pour l'événement `cancel `(annuler).
- {{domxref("Animation.onfinish")}}
- : Retourne et défini le gestionnaire d'événement pour l'événement `finish` (terminer).
## Méthodes
- {{domxref("Animation.cancel()")}}
- : Supprime toutes les {{domxref("KeyframeEffect", "keyframeEffects")}} dues à cette animation et interomp la lecture.
<!---->
- {{domxref("Animation.finish()")}}
- : Cherche la fin de l'animation, en fonction que l'animation soit en lecture normale ou inversée.
<!---->
- {{domxref("Animation.pause()")}}
- : Suspend la lecture de l'animation.
<!---->
- {{domxref("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.
<!---->
- {{domxref("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 |
| ------------------------------------------------------------------------------------------------ | ------------------------------------ | ------------------- |
| {{SpecName("Web Animations", "#the-animation-interface", "Animation")}} | {{Spec2("Web Animations")}} | Définition initiale |
## Compatibilité des navigateurs
{{Compat("api.Animation")}}
|
