Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje