Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

KeyframeEffect — un efecto de animación de fotogramas clave

KeyframeEffect describe el objetivo, los fotogramas clave y los parámetros temporales de un efecto. Un objeto Animation independiente controla la reproducción.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

new KeyframeEffect(target, keyframes, options)
new KeyframeEffect(source)

KeyframeEffect es una interfaz de Web Animations, no forma parte de ECMAScript. Hereda de AnimationEffect y describe cambios en las propiedades CSS. Crear el efecto no inicia la reproducción: asígnalo a un objeto Animation, cuyo método play() inicia la reproducción. El atajo Element.animate() crea el efecto y la animación, y comienza a reproducirla.

target es un elemento o null. keyframes acepta un array de fotogramas clave o un objeto con valores de propiedades. options es la duración de una iteración en milisegundos o un objeto con opciones como duration, delay, iterations, easing y fill. Los valores explícitos de offset deben estar en [0, 1] y ordenarse de forma no decreciente. new KeyframeEffect(source) copia la definición del efecto, no el estado de reproducción de la animación.

getKeyframes() devuelve fotogramas clave con desplazamientos calculados, y setKeyframes() sustituye el conjunto. El método heredado updateTiming() cambia los parámetros temporales, mientras que getComputedTiming() expone el progreso calculado. En el ejemplo, currentTime = 500 selecciona el punto medio de una única iteración de 1000 ms sin reproducirla.

Esta es una API de Window; Node 24 del repositorio no demuestra su disponibilidad en el navegador. Comprueba la disponibilidad en el entorno de destino; el ejemplo comprueba los constructores, pero no demuestra la compatibilidad con todas las opciones.

Ejemplos

(() => {
  if (typeof KeyframeEffect !== "function" || typeof Animation !== "function") {
    throw new Error("Web Animations API required");
  }
  const target = document.createElement("div");
  const effect = new KeyframeEffect(
    target,
    [{ opacity: 0 }, { opacity: 1 }],
    { duration: 1000, easing: "linear" }
  );
  const animation = new Animation(effect, document.timeline);
  animation.currentTime = 500;
  console.log(effect.getKeyframes().length);
  console.log(effect.getComputedTiming().progress);
  animation.cancel();
})();

Resultado

2
0.5

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes