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.