CKTIS / JavaScript
requestAnimationFrame — updates vóór het renderen
requestAnimationFrame vraagt een callback aan die tijdens een renderupdate één keer wordt uitgevoerd. Zo kun je animeren op basis van verstreken tijd, zonder uit te gaan van een vast aantal frames per seconde.
Versie: 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) registreert een callback die één keer wordt uitgevoerd als onderdeel van een renderupdate, voordat het beeld wordt weergegeven. De functie retourneert een numerieke aanvraaghandle, niet het resultaat van de callback. Vraag expliciet nog een frame aan om door te gaan; window.cancelAnimationFrame(handle) verwijdert een callback die nog in de wachtrij staat.
Het argument timestamp is een tijdstempel met hoge resolutie in milliseconden, relatief aan het tijdsoorsprongspunt van de omgeving. Het is geen kalenderdatum en ook geen frameduur. Bereken de verstreken tijd door tijdstempels van elkaar af te trekken. Callbacks die in dezelfde batch voor hetzelfde doel worden aangeroepen, krijgen dezelfde tijdstempel.
Ga niet uit van 60 frames per seconde of van een vaste vertraging. De frequentie hangt af van de mogelijkheden om te renderen; onzichtbare documenten ontvangen mogelijk geen updates. Houd de callback kort, want langdurig werk vertraagt het renderen. Positiewijzigingen op basis van tijd voorkomen dat de bewegingssnelheid afhangt van het aantal frames.
Dit is een API uit de HTML-standaard, geen functie van een bepaalde ECMAScript-editie. Huidige browserengines ondersteunen deze API voor Window; de aanwezigheid van Node 24 in een repository bewijst niet dat er ondersteuning is. Het voorbeeld vereist een zichtbare pagina waarin document.body bestaat. Het animeert een stip. De laatste callback stelt de verschuiving in op 100 pixels, schrijft done: 100px naar de console en verwijdert de stip voordat de browser die op die positie kan tekenen. De beoogde bewegingsduur is 1000 ms, maar de daadwerkelijke voltooiing kan later plaatsvinden.
Voorbeelden
(() => {
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);
})();Resultaat
done: 100px
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.