CKTIS / JavaScript
requestAnimationFrame — aktualizácie pred vykreslením
requestAnimationFrame požiada o jednorazové spätné volanie počas aktualizácie vykresľovania. Umožňuje animovať podľa uplynutého času namiesto predpokladu pevného počtu snímok za sekundu.
Verzia: 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) zaregistruje jednorazové spätné volanie, ktoré sa vykoná v rámci aktualizácie vykresľovania pred zobrazením obrazu. Vráti číselný identifikátor požiadavky, nie výsledok spätného volania. Ak chcete pokračovať, musíte výslovne požiadať o ďalšiu snímku; window.cancelAnimationFrame(handle) odstráni čakajúce spätné volanie.
Argument timestamp je časová značka s vysokým rozlíšením v milisekundách, vztiahnutá na začiatok merania času daného prostredia; nejde o kalendárny dátum ani o trvanie snímky. Uplynutý čas vypočítajte odčítaním časových značiek. Spätné volania vyvolané v rovnakej dávke pre rovnaký cieľ dostanú rovnakú časovú značku.
Nepredpokladajte 60 snímok za sekundu ani pevné oneskorenie. Frekvencia závisí od možností vykresľovania; neviditeľné dokumenty nemusia dostávať žiadne aktualizácie. Spätné volanie udržujte krátke, pretože dlhá práca spomaľuje vykresľovanie. Zmeny polohy založené na čase bránia tomu, aby rýchlosť pohybu závisela od počtu snímok.
Ide o API štandardu HTML, nie o funkciu konkrétnej edície ECMAScriptu. Súčasné prehliadačové enginy toto API pre Window podporujú; samotná prítomnosť Node 24 v repozitári podporu nepotvrdzuje. Príklad vyžaduje viditeľnú stránku s existujúcim document.body. Animuje bodku. Pri poslednom spätnom volaní nastaví jej posun na 100 pixelov, vypíše do konzoly done: 100px a odstráni bodku skôr, než ju prehliadač stihne v tejto polohe vykresliť. Zamýšľané trvanie pohybu je 1000 ms, ale skutočné dokončenie môže nastať neskôr.
Príklady
(() => {
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);
})();Výsledok
done: 100px
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.