Элемент: метод getAnimations()
Базовая Широко доступная
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с марта 2020 года.
Метод getAnimations() интерфейса Element (указанный в миксине Animatable ) возвращает массив всех объектов Animation, влияющих на этот элемент, или тех, которые запланированы на будущее. Он может также, по желанию, вернуть объекты Animation для дочерних элементов.
Примечание: Этот массив включает CSS-анимации, CSS-переходы и анимации Web Animations.
Синтаксис
getAnimations() getAnimations(options)
Параметры
optionsНеобязательно-
Объект опций, содержащий следующее свойство:
subtree-
Логическое значение, которое, если
true, приведет к тому, что анимации, нацеленные на потомков элемента Element, также будут возвращены. Это включает анимации, нацеленные на любые CSS псевдоэлементы, прикрепленные к Element или одному из его потомков. По умолчаниюfalse.
Возвращаемое значение
Массив Array объектов Animation, каждый из которых представляет анимацию, в данный момент направленную на Element, на котором вызывается этот метод, или на один из его дочерних элементов, если { subtree: true } задан.
Примеры
Следующий фрагмент кода подождет завершения всех анимаций на элементе elem и его потомков перед удалением элемента из документа.
Promise.all(
elem.getAnimations({ subtree: true }).map((animation) => animation.finished),
).then(() => elem.remove());
Спецификации
| Спецификация |
|---|
| Web Animations # dom-animatable-getanimations |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
getAnimations |
84 | 84 | 75 | 70 | 13.1 | 84 | 79 | 60 | 13.4 | 14.0 | 84 |
См. также
- API анимаций Web Animations
- CSS-анимации
- CSS-переходы
-
Document.getAnimations()- Получение всех анимаций в документе Animation
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/getAnimations