Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori