Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

KeyframeEffect — un effetto di animazione con fotogrammi chiave

KeyframeEffect descrive il bersaglio, i fotogrammi chiave e i parametri temporali di un effetto. Un oggetto Animation separato ne controlla la riproduzione.

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

Sintassi

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

KeyframeEffect è un’interfaccia di Web Animations, non fa parte di ECMAScript. Eredita da AnimationEffect e descrive le modifiche alle proprietà CSS. La sola creazione non avvia la riproduzione: assegna l’effetto a un oggetto Animation, il cui metodo play() avvia la riproduzione. La scorciatoia Element.animate() crea l’effetto e l’animazione e avvia la riproduzione.

target è un elemento oppure null. keyframes accetta un array di fotogrammi chiave o un oggetto contenente valori delle proprietà. options è la durata di un’iterazione in millisecondi oppure un oggetto con impostazioni come duration, delay, iterations, easing e fill. I valori espliciti di offset devono rientrare in [0, 1] ed essere in ordine non decrescente. new KeyframeEffect(source) copia la definizione dell’effetto, non lo stato di riproduzione dell’animazione.

getKeyframes() restituisce fotogrammi chiave con offset calcolati e setKeyframes() sostituisce il loro insieme. Il metodo ereditato updateTiming() modifica i parametri temporali, mentre getComputedTiming() espone il progresso calcolato. Nell’esempio, currentTime = 500 seleziona il punto centrale di una singola iterazione di 1000 ms senza avviare la riproduzione.

Questa è un’API Window; Node 24 nel repository non ne dimostra la disponibilità nel browser. Verifica la disponibilità nell’ambiente di destinazione; l’esempio controlla i costruttori, ma non dimostra il supporto per ogni opzione.

Esempi

(() => {
  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();
})();

Risultato

2
0.5

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti