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

CKTIS / JavaScript

Animation.cancel(): zrušenie animácie

Animation.cancel() preruší animáciu a odstráni jej účinok na prvok, namiesto toho, aby ju zastavila na aktuálnom snímku.

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

animation.cancel();

animation.cancel() je metóda Web Animations, nie samotného ECMAScriptu. Neprijíma žiadne argumenty a vracia undefined. Nastaví playState na idle a currentTime aj startTime na null.

Odstráni účinok animácie, aj pri fill: 'both'; snímku neuloží do štýlov. Na rozdiel od pause() nezachová aktuálnu pozíciu; na rozdiel od finish() neprejde na koniec. Objekt možno znova spustiť pomocou play().

Ak animácia nie je v stave idle, metóda nahradí doterajší promise finished novým a zaradí udalosť cancel do frontu. Doterajší promise odmietne s chybou AbortError iba vtedy, ak ešte nebol vybavený. Ak už bol splnený, zostane splnený. Ošetrenie odmietnutia pridajte pred zrušením. Príklad vyžaduje prehliadač; Node 24 nepotvrdzuje podporu tohto API.

Príklady

(async () => {
  const box = document.createElement('div');
  document.body.append(box);
  const animation = box.animate(
    [{ opacity: 0 }, { opacity: 1 }],
    { duration: 1000, fill: 'both' }
  );
  const outcome = animation.finished.catch(error => error.name);
  animation.cancel();
  console.log(animation.playState);
  console.log(animation.currentTime === null);
  console.log(animation.startTime === null);
  console.log(await outcome);
  box.remove();
})();

Výsledok

idle
true
true
AbortError

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje