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.
Le dictionnaire AnimationEffectTimingProperties
est utilisé par les méthodes Element.animate()
, KeyframeEffectReadOnly()
et KeyframeEffect()
afin de décrire les propriétés temporelles pour les effets d'animation. L'ensemble de ces propriétés sont optionnelles mais si duration
n'est pas paramétrée, l'animation ne sera pas lancée.
Ces propriétés décrivent la façon dont l'agent utilisateur applique l'animation entre chaque étape (keyframe) et comment elle se comporte au début et à la fin.
Propriétés
delay
Facultatif- Le nombre de millisecondes à attendre avant de démarrer l'animation. La valeur par défaut est 0.
direction
Facultatif- Indique si l'animation se déroule dans le sens the animation runs forwards (
normal
), backwards (reverse
), switches direction after each iteration (alternate
), or runs backwards and switches direction after each iteration (alternate-reverse
). Defaults to"normal"
. duration
Facultatif- La durée d'une itération, exprimée en millisecondes. La valeur par défaut est 0. Bien que cette propriété soit optionnelle, il faut garder à l'esprit que l'animation ne sera pas lancée si la valeur est 0.
easing
Facultatif- La courbe de progression de l'animation au cours du temps. Cette propriété accepte des valeurs pré-paramétrées comme
"linear"
,"ease"
,"ease-in"
,"ease-out"
et"ease-in-out"
ou une fonction"cubic-bezier"
de la forme"cubic-bezier(0.42, 0, 0.58, 1)"
. La valeur par défaut est"linear"
. endDelay
Facultatif- Le nombre de millisecondes à attendre après la fin de l'animation. Cette propriété est principalement utilisée lorsqu'on enchaîne une animation à la suite d'une autre. La valeur par défaut est 0.
fill
Facultatif- Indique si les effets de l'animation doivent s'appliqués sur l'élément avant d'être lancée (
"backwards"
), être conservés après la fin de l'animation ("forwards"
) ou les deuxboth
. La valeur par défaut est"none"
. iterationStart
Facultatif- Décrit le point de départ de l'animation par rapport à une itération. Une valeur de 0.5 indique que l'animation démarre au milieu de la première animation (dans ce cas, après deux itérations, l'animation sera arrivée à la moitié de la troisième itération). La valeur par défaut est 0.0.
iterations
Facultatif- Le nombre de fois que l'animation doit être répétée. La valeur par défaut est 1. Il est possible d'utiliser la valeur
Infinity
pour répéter l'animation aussi longtemps que l'élément existe.
Spécifications
Spécification | État | Commentaires |
---|---|---|
Web Animations La définition de 'AnimationEffectTimingProperties' dans cette spécification. |
Version de travail | Définition initiale. |
Compatibilité des navigateurs
Fonctionnalité | Chrome | Firefox (Gecko) | Microsoft Edge | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Support simple | ? | 45 (45)[1] | ? | ? | ? | ? |
Fonctionnalité | Android | Webview Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile | Chrome pour Android |
---|---|---|---|---|---|---|---|
Support simple | ? | ? | 45.0 (45)[1] | ? | ? | ? | ? |
[1] The Web Animations API is only enabled by default in Firefox Developer Edition and Nightly builds. You can enable it in beta and release builds by setting the preference dom.animations-api.core.enabled
to true
, and can disable it in any Firefox version by setting this preference to false
.