Animation.currentTime

Baseline 2022

Newly available

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

La propiedad Animation.currentTime de la Web Animations API (en-US) devuelve y establece el valor del tiempo de la animación en milisegundos, tanto si se está ejecutando como en pausa.

Si la animación carece de un timeline (en-US), está inactiva, o no ha sido reproducida todavía, el valor devuelto por currentTime es null.

Sintaxis

js
var currentTime = Animation.currentTime;
Animation.currentTime = newTime;

Valor

Un número que representa el tiempo actual en milisegundos, o null para desactivar la animación.

Ejemplos

En el juego Drink Me/Eat Me, la altura de Alicia está animada, por lo que puede cambiar de pequeña a grande y de grande a pequeña. Al inicio del juego, su altura de fija estableciendo el currentTime (tiempoActual) a la mitad de la duración total delKeyframeEffect (en-US):

js
aliceChange.currentTime = aliceChange.effect.timing.duration / 2;

Un modo más genérico para encontrar la marca del 50% en una animación sería :

js
animation.currentTime =
  animation.effect.getComputedTiming().delay +
  animation.effect.getComputedTiming().activeDuration / 2;

Especificaciones

Specification
Web Animations
# dom-animation-currenttime

Compatibilidad con navegadores

BCD tables only load in the browser

Ver también