CKTIS / JavaScript
requestAnimationFrame — ažuriranja prije iscrtavanja
requestAnimationFrame traži jednokratni povratni poziv tijekom ažuriranja iscrtavanja. Omogućuje animiranje prema proteklom vremenu, umjesto pretpostavke o fiksnom broju sličica u sekundi.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const handle = window.requestAnimationFrame((timestamp) => { /* update visual state */ });
window.cancelAnimationFrame(handle);window.requestAnimationFrame(callback) registrira jednokratni povratni poziv koji se izvršava u sklopu ažuriranja iscrtavanja, prije prikaza slike. Vraća brojčani identifikator zahtjeva, a ne rezultat povratnog poziva. Za nastavak treba izričito zatražiti novu sličicu; window.cancelAnimationFrame(handle) uklanja povratni poziv na čekanju.
Argument timestamp vremenska je oznaka visoke razlučivosti u milisekundama, relativna prema vremenskom ishodištu okruženja; nije kalendarski datum ni trajanje sličice. Proteklo vrijeme izračunajte oduzimanjem vremenskih oznaka. Povratni pozivi pozvani u istoj grupi za isti cilj dobivaju istu vremensku oznaku.
Nemojte pretpostavljati 60 sličica u sekundi ni fiksno kašnjenje. Učestalost ovisi o prilikama za iscrtavanje; nevidljivi dokumenti možda neće primati ažuriranja. Povratni poziv neka bude kratak jer dugotrajan rad odgađa iscrtavanje. Promjene položaja temeljene na vremenu sprječavaju da brzina kretanja ovisi o broju sličica.
Ovo je API standarda HTML, a ne značajka određene edicije ECMAScripta. Aktualni preglednički pogoni podržavaju ga za Window; sama prisutnost Nodea 24 u repozitoriju ne dokazuje podršku. Primjer zahtijeva vidljivu stranicu s postojećim document.body. Animira točku. Posljednji povratni poziv postavlja njezin pomak na 100 piksela, ispisuje done: 100px u konzolu i uklanja točku prije nego što je preglednik stigne iscrtati na tom položaju. Predviđeno trajanje kretanja iznosi 1000 ms, no stvarni završetak može nastupiti kasnije.
Primjeri
(() => {
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);
})();Rezultat
done: 100px
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.