Animation.cancel()
Experimental
これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
Animation
インターフェースにある Web Animations API の cancel()
メソッドは、このアニメーションによって引き起こされたすべての KeyframeEffect
を初期化し、再生を中止します。
アニメ―ションをキャンセルした時、startTime
と currentTime
は、 null
にセットされます。
構文
Animation.cancel();
引数
なし
戻り値
なし
例外
このメソッドは、直接例外をスローしません。 しかし、キャンセル時にアニメーションのplayState
が "idle"
以外の場合、 current finished promise は AbortError
という名前の DOMException
で拒否されます。
仕様
仕様書 | 策定状況 | 備考 |
---|---|---|
Web Animations Animation.cancel() の定義 |
草案 | Editor's draft. |
ブラウザ実装状況
BCD tables only load in the browser
関連情報
- Web Animations API
KeyframeEffect
Animation
Animation.playState
Animation.finished
は、playState
が"idle"
でない場合、 このアクションが拒否する promise を返します。