CKTIS / JavaScript
requestAnimationFrame — актуализации преди изобразяването
requestAnimationFrame заявява еднократна функция за обратно извикване по време на актуализация на изобразяването. Позволява анимиране според изминалото време, вместо да се предполага фиксиран брой кадри в секунда.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const handle = window.requestAnimationFrame((timestamp) => { /* update visual state */ });
window.cancelAnimationFrame(handle);window.requestAnimationFrame(callback) регистрира функция за обратно извикване, която се изпълнява еднократно като част от актуализация на изобразяването, преди да бъде представено изображението. Връща числов идентификатор на заявката, а не резултата от функцията. За да продължите, изрично заявете следващ кадър; window.cancelAnimationFrame(handle) премахва чакаща функция за обратно извикване.
Аргументът timestamp е времеви маркер с висока разделителна способност в милисекунди, спрямо началото на отчитането на времето в средата; той не е календарна дата или продължителност на кадър. Изчислявайте изминалото време чрез изваждане на времеви маркери. Функциите за обратно извикване, задействани в една и съща група за една и съща цел, получават един и същ времеви маркер.
Не приемайте, че има 60 кадъра в секунда или фиксирано забавяне. Честотата зависи от възможностите за изобразяване; невидимите документи може да не получават актуализации. Поддържайте функцията за обратно извикване кратка, защото продължителната работа забавя изобразяването. Промените на позицията, основани на времето, не позволяват скоростта на движение да зависи от броя кадри.
Това е API от стандарта HTML, а не функция на конкретно издание на ECMAScript. Актуалните браузърни енджини го поддържат за Window; наличието на Node 24 в хранилище не доказва поддръжка. Примерът изисква видима страница със съществуващ document.body. Той анимира точка. При последното изпълнение на функцията за обратно извикване кодът задава отместването на точката на 100 пиксела, извежда done: 100px в конзолата и премахва точката, преди браузърът да успее да я изобрази на тази позиция. Предвидената продължителност на движението е 1000 ms, но действителното завършване може да настъпи по-късно.
Примери
(() => {
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);
})();Резултат
done: 100px
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.