Element: getAnimations() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年7月以降、すべてのブラウザーで利用可能です。
getAnimations() は Element インターフェイスのメソッドで（Animatable ミックスインで指定されており）、この要素に影響を与える、あるいは将来的に影響を与える予定のすべての Animation オブジェクトの配列を返します。オプションとして、子孫要素の Animation オブジェクトも返すことができます。
メモ: この配列には CSS アニメーション、CSS トランジション、ウェブアニメーションが含まれます。
構文
js
getAnimations()
getAnimations(options)
引数
options省略可-
以下のプロパティを含むオプションオブジェクトです。
返値
Animation オブジェクトの配列 (Array) で、それぞれが
このメソッドが呼び出された Element、または { subtree: true } が指定されている場合は、その子孫の要素の 1 つを現在ターゲットにしているアニメーションです。
例
以下のコードでは、 elem とその子孫のすべてのアニメーションが終了するのを待ってから、文書からその要素を削除します。
js
Promise.all(
elem.getAnimations({ subtree: true }).map((animation) => animation.finished),
).then(() => elem.remove());
仕様書
| 仕様書 |
|---|
| Web Animations # dom-animatable-getanimations |
ブラウザーの互換性
関連情報
- ウェブアニメーション API
- CSS アニメーション
- CSS トランジション
Document.getAnimations()- 文書内のすべてのアニメーションを読み取るAnimation