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

CKTIS / JavaScript

Animation.cancel(): preklic animacije

Animation.cancel() prekine animacijo in odstrani njen učinek na elementu, namesto da bi jo ustavila na trenutni sličici.

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

animation.cancel();

animation.cancel() je metoda Web Animations, ne samega ECMAScripta. Ne sprejema argumentov in vrne undefined. Nastavi playState na idle, currentTime in startTime pa na null.

Odstrani učinek animacije, tudi pri fill: 'both'; sličice ne shrani v sloge. Za razliko od pause() ne ohrani trenutnega položaja; za razliko od finish() ne skoči na konec. Objekt lahko znova zaženete z play().

Če animacija ni v stanju idle, metoda nadomesti obstoječo obljubo finished z novo in v čakalno vrsto doda dogodek cancel. Prejšnjo obljubo zavrne z napako AbortError le, če je še v teku. Če je bila že izpolnjena, ostane izpolnjena. Obravnavo zavrnitve dodajte pred preklicem. Primer zahteva brskalnik; Node 24 ne potrjuje podpore za ta API.

Primeri

(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();
})();

Rezultat

idle
true
true
AbortError

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

Viri