CKTIS / JavaScript
KeyframeEffect — ein Keyframe-Animationseffekt
KeyframeEffect beschreibt das Ziel, die Keyframes und die Zeitparameter eines Effekts. Ein separates Animation-Objekt steuert die Wiedergabe.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new KeyframeEffect(target, keyframes, options)
new KeyframeEffect(source)KeyframeEffect ist eine Schnittstelle der Web Animations API und kein Bestandteil von ECMAScript. Sie erbt von AnimationEffect und beschreibt Änderungen an CSS-Eigenschaften. Die Erstellung allein startet keine Wiedergabe: Weise den Effekt einem Animation-Objekt zu, dessen Methode play() die Wiedergabe startet. Die Kurzform Element.animate() erstellt Effekt und Animation und startet die Wiedergabe.
target ist ein Element oder null. keyframes akzeptiert ein Array von Keyframes oder ein Objekt mit Eigenschaftswerten. options ist entweder die Dauer einer Iteration in Millisekunden oder ein Objekt mit Einstellungen wie duration, delay, iterations, easing und fill. Explizite offset-Werte müssen im Bereich [0, 1] liegen und nicht absteigend sortiert sein. new KeyframeEffect(source) kopiert die Effektdefinition, nicht den Wiedergabestatus der Animation.
getKeyframes() gibt Keyframes mit berechneten Offsets zurück, und setKeyframes() ersetzt deren Menge. Das geerbte updateTiming() ändert Zeitparameter, während getComputedTiming() den berechneten Fortschritt bereitstellt. Im Beispiel legt currentTime = 500 den Mittelpunkt einer einzelnen Iteration von 1000 ms fest, ohne die Wiedergabe zu starten.
Dies ist eine Window-API; Node 24 im Repository belegt nicht ihre Verfügbarkeit im Browser. Prüfe die Verfügbarkeit in der Zielumgebung. Das Beispiel prüft die Konstruktoren, belegt aber nicht die Unterstützung jeder Option.
Beispiele
(() => {
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();
})();Ergebnis
2 0.5
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.