CKTIS / JavaScript
Animation.cancel(): zrušení animace
Animation.cancel() přeruší animaci a odstraní její účinek na prvek, místo aby ji zastavila na aktuálním snímku.
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.cancel();animation.cancel() je metoda Web Animations, nikoli samotného ECMAScriptu. Nepřijímá žádné argumenty a vrací undefined. Nastaví playState na idle a currentTime i startTime na null.
Odstraní účinek animace, a to i při fill: 'both'; snímek neuloží do stylů. Na rozdíl od pause() nezachová aktuální pozici; na rozdíl od finish() nepřejde na konec. Objekt lze znovu spustit pomocí play().
Pokud animace není ve stavu idle, metoda nahradí dosavadní promise finished novou a zařadí událost cancel do fronty. Dosavadní promise je odmítnuta s chybou AbortError, jen pokud dosud nebyla vyřízena. Pokud už byla splněna, zůstane splněná. Ošetření odmítnutí přidejte před zrušením. Příklad vyžaduje prohlížeč; Node 24 nepotvrzuje podporu tohoto API.
Pří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ýsledek
idle true true AbortError
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.