files/fr/web/api/web_animations_api/index.md


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

---
title: Web Animations API
slug: Web/API/Web_Animations_API
tags:
  - API
  - Animation
  - Reference
  - Web Animations
translation_of: Web/API/Web_Animations_API
---
<p>{{DefaultAPISidebar("Web Animations")}}</p>

<p>L'<strong>API Web Animations</strong> permet de synchroniser et de chronométrer les changements de présentation d'une page Web, c'est-à-dire l'animation d'éléments DOM. Pour ce faire, il combine deux modèles : le modèle de synchronisation et le modèle d'animation.</p>

<h2 id="Concepts_et_utilisation">Concepts et utilisation</h2>

<p>L'API Web Animations fournit un langage commun aux navigateurs et aux développeurs pour décrire les animations sur les éléments DOM. Pour obtenir plus d'informations sur les concepts derrière l'API et comment l'utiliser, lisez <a href="/fr/docs/Web/API/Web_Animations_API/Using_the_Web_Animations_API">Utilisation de l'API Web Animations</a>.</p>

<h2 id="Interfaces_danimations_Web">Interfaces d'animations Web</h2>

<dl>
 <dt>{{domxref("Animation")}}</dt>
 <dd>Fournit des commandes de lecture et une chronologie pour un nœud ou une source d'animation. Peut prendre un objet créé avec le constructeur {{domxref("KeyframeEffect.KeyframeEffect", "KeyframeEffect()")}}.</dd>
 <dt>{{domxref("KeyframeEffect")}}</dt>
 <dd>Décrit des ensembles de propriétés et de valeurs animables, appelées <strong>images clés</strong> (<em>keyframes</em>) et leurs <a href="/en-US/docs/Web/API/Web_Animations_API/Animation_timing_options">options de minutage</a> . Ceux-ci peuvent ensuite être lus en utilisant le constructeur {{domxref("Animation.Animation", "Animation()")}}.</dd>
 <dt>{{domxref("AnimationTimeline")}}</dt>
 <dd>Représente la chronologie de l'animation. Cette interface existe pour définir les fonctionnalités de la chronologie (héritées par {{domxref("DocumentTimeline")}} et les futurs objets de chronologie) et n'est pas elle-même accessible par les développeurs.</dd>
 <dt>{{domxref("AnimationEvent")}}</dt>
 <dd>Fait actuellement partie des animations CSS.</dd>
 <dt>{{domxref("DocumentTimeline")}}</dt>
 <dd>Représente les chronologies d'animation, y compris la chronologie du document par défaut (accessible à l'aide de la propriété {{domxref("Document.timeline")}}).</dd>
 <dt>{{domxref("EffectTiming")}}</dt>
 <dd>{{domxref("Element.animate()")}}, {{domxref("KeyframeEffectReadOnly.KeyframeEffectReadOnly()")}} et {{domxref("KeyframeEffect.KeyframeEffect()")}} acceptent tous un dictionnaire facultatif objet des propriétés de synchronisation.</dd>
</dl>

<h2 id="Extensions_à_dautres_interfaces">Extensions à d'autres interfaces</h2>

<p>L'API Web Animations ajoute de nouvelles fonctionnalités à {{domxref("document")}} et {{domxref("element")}}.</p>

<h3 id="Extensions_à_linterface_Document">Extensions à l'interface <code>Document</code></h3>

<dl>
 <dt>{{domxref("document.timeline")}}</dt>
 <dd>L'objet <code>DocumentTimeline</code> représentant la chronologie du document par défaut.</dd>
 <dt>{{domxref("document.getAnimations()")}}</dt>
 <dd>Renvoie un tableau d'objets {{domxref("Animation")}} actuellement en vigueur sur les éléments du <code>document</code>.</dd>
</dl>

<h3 id="Extensions_à_linterface_Element">Extensions à l'interface <code>Element</code></h3>

<dl>
 <dt>{{domxref("Element.animate()")}}</dt>
 <dd>Une méthode de raccourci pour créer et lire une animation sur un élément. Il renvoie l'instance d'objet {{domxref("Animation")}} créée.</dd>
 <dt>{{domxref("Element.getAnimations()")}}</dt>
 <dd>Renvoie un tableau d'objets {{domxref("Animation")}} affectant actuellement un élément ou qui sont programmés pour le faire à l'avenir.</dd>
</dl>

<h2 id="Spécifications">Spécifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">Statut</th>
   <th scope="col">Commentaire</th>
  </tr>
  <tr>
   <td>{{SpecName('Web Animations')}}</td>
   <td>{{Spec2('Web Animations')}}</td>
   <td>Définition initiale</td>
  </tr>
 </tbody>
</table>

<h2 id="Voir_aussi">Voir aussi</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/Web_Animations_API/Using_the_Web_Animations_API">Utilisation de l'API Web Animations</a></li>
 <li><a href="https://mozdevs.github.io/Animation-examples/">Démos d'animations web</a></li>
 <li><a href="https://github.com/web-animations/web-animations-js">Polyfill / Prothèse d'implémentation</a></li>
 <li><a href="https://birtles.github.io/areweanimatedyet/">Implémentation</a> actuelle de Firefox : <a href="https://birtles.github.io/areweanimatedyet/">AreWeAnimatedYet</a></li>
 <li>
  <p><a href="http://codepen.io/danwilson/pen/xGBKVq">Test de prise en charge du navigateur</a></p>
 </li>
</ul>