Animation.cancel()
ウェブアニメーション API の cancel()
は Animation
インターフェイスのメソッドで、このアニメーションによって引き起こされたすべての KeyframeEffect
(en-US)を初期化し、再生を中止します。
メモ: アニメ―ションをキャンセルした時、startTime
(en-US) と currentTime
(en-US) は、 null
に設定されます。
構文
js
Animation.cancel();
引数
なし
返値
なし
例外
このメソッドは、直接は例外を発生しません。しかし、キャンセル時にアニメーションの playState
(en-US) が "idle"
以外の場合、 current finished promise (en-US) は DOMException
の AbortError
で拒否されます。
仕様書
Specification |
---|
Web Animations # dom-animation-cancel |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- ウェブアニメーション API
KeyframeEffect
(en-US)Animation
Animation.playState
(en-US)Animation.finished
(en-US) はこのアニメーションのplayState
が"idle"
でなくなると拒否されるこの操作のプロミスを返します。