元素:getAnimations() 方法

Element 接口的 getAnimations() 方法(在 Animatable 混合中指定)返回一个数组,其中包含影响此元素或将在将来影响此元素的所有 Animation 对象。它可以选择性地为后代元素也返回 Animation 对象。

注意: 此数组包括 CSS 动画CSS 过渡Web 动画

语法

js
getAnimations()
getAnimations(options)

参数

options 可选

包含以下属性的选项对象

subtree

一个布尔值,如果为 true,则也会返回目标为 Element 后代的动画。这包括针对附加到 Element 或其后代之一的任何 CSS 伪元素 的动画。默认值为 false

返回值

一个 Array,其中包含 Animation 对象,每个对象都代表当前针对调用此方法的 Element 或其后代元素之一的动画(如果指定了 { subtree: true })。

示例

以下代码片段将在 elem 及其后代的所有动画完成后再将该元素从文档中移除。

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

规范

规范
Web 动画
# dom-animatable-getanimations

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅