Element: getAnimations() メソッド

構文

getAnimations()
getAnimations(options)

引数

options 省略可

以下のプロパティを含むオプションオブジェクトです。

subtree

論理値で、true の場合、 Element の子孫をターゲットとしたアニメーションも返すようになります。これは、 Element やその子孫に付けられた CSS 擬似要素をターゲットとするアニメーションを含みます。既定値は false です。

返値

Animation オブジェクトの配列 (Array) で、それぞれが このメソッドが呼び出された Element、または { subtree: true } が指定されている場合は、その子孫の要素の 1 つを現在ターゲットにしているアニメーションです。

例

以下のコードでは、 elem とその子孫のすべてのアニメーションが終了するのを待ってから、文書からその要素を削除します。

Promise.all(
  elem.getAnimations({ subtree: true }).map((animation) => animation.finished),
).then(() => elem.remove());

仕様書

ブラウザーの互換性

関連情報

• ウェブアニメーション API
• CSS アニメーション
• CSS トランジション
• Document.getAnimations() - 文書内のすべてのアニメーションを読み取る
• Animation