Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Animation.pause() — pozastavení animace

Animation.pause() pozastaví přehrávání animace, aniž ji zruší. Operace může čekat na dokončení; pomocí animation.ready můžete počkat, až skončí.

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

animation.pause();

animation.pause() nepřijímá žádné argumenty a vrací undefined, nikoli promise. Pozastaví plynutí času animace; play() přehrávání obnoví, zatímco cancel() animaci zruší.

Pozastavení může vyžadovat synchronizaci. Použijte await animation.ready místo await animation.pause(). Samotné zjištění, že playState === 'paused', nedokazuje dokončení operace: pending může být stále true.

Jde o rozhraní Web Animations v prohlížeči, nikoli o funkci ECMAScript. Podporu neodvozujte z verze Node.js; ověřte si cílové prohlížeče.

Příklady

(async () => {
  const box = document.createElement('div');
  box.textContent = 'Pause demo';
  document.body.append(box);

  const animation = box.animate(
    [{ opacity: 0 }, { opacity: 1 }],
    { duration: 1000, fill: 'both' }
  );
  animation.pause();
  await animation.ready;
  animation.currentTime = 500;

  console.log(animation.playState);
  console.log(animation.currentTime);
  console.log(animation.pending);

  animation.cancel();
  box.remove();
})();

Výsledek

paused
500
false

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.

Zdroje