Animation.playState

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2020.

La propiedad Animation.playState de la Web Animations API devuelve y establece un valor enumerado que describe el estado de reproducción de una animación.

Nota: Esta propiedad es de solo lectura para las Animaciones y Transiciones en CSS.

Sintaxis

js
var currentPlayState = Animation.playState;

Animation.playState = newState;

Valor

idle(inactivo)

El tiempo actual de la animación no está resuelto y no hay tareas pendientes.

pending(pendiente)

La animación está esperando que se complete una tarea pendiente.

running(funcionando)

La animación se está ejecutando.

paused(pausado)

La animación se ha suspendido y la propiedad Animation.currentTime no se está actualizando.

finished(finalizado)

La animación ha alcanzado uno de sus límites y la propiedad Animation.currentTime no se está actualizando.

Ejemplo

En el ejemplo Growing/Shrinking Alice Game , los jugadores pueden tener un final con (Alicia llorando en un mar de lágrimas) Alice crying into a pool of tears. En el juego, por razones de rendimiento, las lágrimas solo se deben animar cuando son visibles. Por lo tanto, deben detenerse tan pronto como estén animadas, de esta manera:

js
// Configurando las animaciones de lágrimas

tears.forEach(function (el) {
  el.animate(tearsFalling, {
    delay: getRandomMsRange(-1000, 1000), // cada lágrima aleatoria
    duration: getRandomMsRange(2000, 6000), // cada lágrima aleatoria
    iterations: Infinity,
    easing: "cubic-bezier(0.6, 0.04, 0.98, 0.335)",
  });
  el.playState = "paused";
});

// Reproduce las lágrimas cayendo cuando el final necesita mostrarlas.

tears.forEach(function (el) {
  el.playState = "playing";
});

// Reinicia la animación de las lágrimas y la detiene.

tears.forEach(function (el) {
  el.playState = "paused";
  el.currentTime = 0;
});

Especificaciones

Specification
Web Animations
# dom-animation-playstate

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
playState

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

Ver también