CKTIS / JavaScript
requestAnimationFrame — aktualizace před vykreslením
requestAnimationFrame požádá o jednorázové zpětné volání během aktualizace vykreslování. Umožňuje animovat podle uplynulého času, místo abyste předpokládali pevný počet snímků za sekundu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const handle = window.requestAnimationFrame((timestamp) => { /* update visual state */ });
window.cancelAnimationFrame(handle);window.requestAnimationFrame(callback) zaregistruje jednorázové zpětné volání, které se provede v rámci aktualizace vykreslování před zobrazením obrazu. Vrací číselný identifikátor požadavku, nikoli výsledek zpětného volání. Chcete-li pokračovat, musíte výslovně požádat o další snímek; window.cancelAnimationFrame(handle) odstraní čekající zpětné volání.
Argument timestamp je časová značka s vysokým rozlišením v milisekundách, vztažená k počátku měření času daného prostředí; nejde o kalendářní datum ani o dobu trvání snímku. Uplynulý čas vypočítejte odečtením časových značek. Zpětná volání vyvolaná ve stejné dávce pro stejný cíl obdrží stejnou časovou značku.
Nepředpokládejte 60 snímků za sekundu ani pevné zpoždění. Frekvence závisí na příležitostech k vykreslování; neviditelné dokumenty nemusí dostávat žádné aktualizace. Zpětné volání udržujte krátké, protože dlouhá práce zpomaluje vykreslování. Změny polohy založené na čase brání tomu, aby rychlost pohybu závisela na počtu snímků.
Jde o API standardu HTML, nikoli o funkci konkrétní edice ECMAScriptu. Současné prohlížečové enginy toto API pro Window podporují; samotná přítomnost Node 24 v repozitáři podporu nedokládá. Příklad vyžaduje viditelnou stránku s existujícím document.body. Animuje tečku. Při posledním zpětném volání nastaví její posun na 100 pixelů, vypíše do konzole done: 100px a odstraní tečku dříve, než ji prohlížeč stihne v této poloze vykreslit. Zamýšlená doba pohybu je 1000 ms, ale ke skutečnému dokončení může dojít později.
Pří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ýsledek
done: 100px
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.