Element: getAnimations() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.

The getAnimations() của giao diện Element (specified on the Animatable mixin) trả về an array of all Animation objects affecting this element or which are scheduled to do so in future. It can optionally return Animation objects for descendant elements too.

Note: This array includes CSS Animations, CSS Transitions, and Web Animations.

Cú pháp

js
getAnimations()
getAnimations(options)

Tham số

options Optional

An options object containing the following property:

subtree

Một boolean value which, if true, causes animations that target descendants of Element to be returned as well. This includes animations that target any CSS pseudo-elements attached to Element or one of its descendants. Defaults to false.

Giá trị trả về

An Array of Animation objects, each representing an animation currently targeting the Element on which this method is called, or one of its descendant elements if { subtree: true } is specified.

Ví dụ

Các giá trị sau code snippet will wait for all animations on elem and its descendants to finish before removing the element from the document.

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

Đặc tả kỹ thuật

Specification
Web Animations
# dom-animatable-getanimations

Trình duyệt hỗ trợ

Xem thêm