Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

requestAnimationFrame — posodobitve pred izrisom

requestAnimationFrame zahteva enkratni povratni klic med posodobitvijo izrisa. Omogoča animiranje glede na pretečeni čas, ne da bi predpostavljali stalno število sličic na sekundo.

Različica: 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 enkratni povratni klic, ki se izvede kot del posodobitve izrisa, preden se slika prikaže. Vrne številčni ročaj zahteve, ne rezultata povratnega klica. Za nadaljevanje je treba izrecno zahtevati novo sličico; window.cancelAnimationFrame(handle) odstrani čakajoči povratni klic.

Argument timestamp je časovni žig visoke ločljivosti v milisekundah, relativno glede na časovno izhodišče okolja; ni koledarski datum ali trajanje sličice. Pretečeni čas izračunajte z odštevanjem časovnih žigov. Povratni klici, izvedeni v istem sklopu za isti cilj, prejmejo isti časovni žig.

Ne predpostavljajte 60 sličic na sekundo ali stalnega zamika. Pogostost je odvisna od priložnosti za izris; nevidni dokumenti morda ne bodo prejeli nobenih posodobitev. Povratni klic naj bo kratek, saj dolgotrajno delo upočasni izris. Spremembe položaja na podlagi časa preprečijo, da bi bila hitrost gibanja odvisna od števila sličic.

To je API standarda HTML, ne funkcija določene izdaje ECMAScripta. Trenutni brskalniški pogoni ga podpirajo za Window; prisotnost Node 24 v repozitoriju še ne dokazuje podpore. Primer zahteva vidno stran z obstoječim document.body. Animira piko. Zadnji povratni klic nastavi njen odmik na 100 pikslov, v konzolo izpiše done: 100px in piko odstrani, preden jo brskalnik lahko izriše na tem mestu. Predvideno trajanje premika je 1000 ms, dejanski zaključek pa lahko nastopi pozneje.

Primeri

(() => {
  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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri