CKTIS / JavaScript
requestAnimationFrame — Aktualisierungen vor dem Rendern
requestAnimationFrame fordert einen einmaligen Callback während einer Renderaktualisierung an. So lassen sich Animationen anhand der vergangenen Zeit steuern, statt eine feste Anzahl von Bildern pro Sekunde vorauszusetzen.
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
const handle = window.requestAnimationFrame((timestamp) => { /* update visual state */ });
window.cancelAnimationFrame(handle);window.requestAnimationFrame(callback) registriert einen einmaligen Callback, der im Rahmen einer Renderaktualisierung und vor der Anzeige des Bildes ausgeführt wird. Die Funktion gibt ein numerisches Anfrage-Handle zurück, nicht das Ergebnis des Callbacks. Um fortzufahren, muss ausdrücklich ein weiterer Frame angefordert werden; window.cancelAnimationFrame(handle) entfernt einen ausstehenden Callback.
Das Argument timestamp ist ein hochauflösender Zeitstempel in Millisekunden, relativ zum Zeitursprung der Umgebung, keine Kalenderzeit und keine Dauer eines Frames. Berechne die vergangene Zeit, indem du Zeitstempel voneinander abziehst. Callbacks, die im selben Batch für dasselbe Ziel aufgerufen werden, erhalten denselben Zeitstempel.
Gehe weder von 60 Bildern pro Sekunde noch von einer festen Verzögerung aus. Die Häufigkeit hängt von den Rendergelegenheiten ab; unsichtbare Dokumente erhalten möglicherweise keine Aktualisierungen. Halte den Callback kurz, denn umfangreiche Arbeit verzögert das Rendern. Zeitbasierte Positionsänderungen verhindern, dass die Bewegungsgeschwindigkeit von der Anzahl der Frames abhängt.
Dies ist eine API des HTML-Standards und keine Funktion einer bestimmten ECMAScript-Ausgabe. Aktuelle Browser-Engines unterstützen sie für Window; dass sich Node 24 in einem Repository befindet, belegt keine Unterstützung. Das Beispiel benötigt eine sichtbare Seite mit einem vorhandenen document.body. Es animiert einen Punkt. Der letzte Callback setzt den Versatz auf 100 Pixel, gibt done: 100px in der Konsole aus und entfernt den Punkt, bevor der Browser ihn an dieser Position zeichnen kann. Die vorgesehene Bewegungsdauer beträgt 1000 ms, der tatsächliche Abschluss kann jedoch später erfolgen.
Beispiele
(() => {
const dot = document.createElement('div');
dot.textContent = '●';
document.body.append(dot);
let start;
function frame(timestamp) {
if (start === undefined) start = timestamp;
const progress = Math.min((timestamp - start) / 1000, 1);
dot.style.transform = `translateX(${100 * progress}px)`;
if (progress < 1) {
window.requestAnimationFrame(frame);
} else {
console.log('done: 100px');
dot.remove();
}
}
window.requestAnimationFrame(frame);
})();Ergebnis
done: 100px
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.