Animation

Baseline 2022

Newly available

Since September 2022, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Экспериментальная возможность: Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.

Animation это интерфейс Web Animations API, представляет из себя одиночный проигрыватель анимации и обеспечивает управление воспроизведением и временную шкалу для узла анимации или источника.

Конструктор

Animation() (en-US): Создаёт новый экземпляр объекта Animation.

Свойства

Animation.currentTime (en-US): Текущее значение времени анимации в миллисекундах, независимо от того работает анимация или приостановлена. Если анимация не имеет timeline (en-US), неактивна или ещё не воспроизведена, то это значение равно нулю.
Animation.effect (en-US): Возвращает и задаёт AnimationEffectReadOnly (en-US) связанный с этой анимацией. Обычно это объект KeyframeEffect (en-US).
Animation.finished (en-US) Только для чтения: Возвращает промис, сигнализирующий о завершении анимации.
Animation.id (en-US): Возвращает и задаёт String(строку), используемую для идентификации анимации.
Animation.playState (en-US) Только для чтения: Возвращает перечисляемое значение, описывающее состояние воспроизведения анимации.
Animation.playbackRate (en-US): Возвращает или задаёт скорость воспроизведения анимации.
Animation.ready (en-US) Только для чтения: Возвращает промис, сигнализирующий о начале проигрывания анимации.
Animation.startTime: Возвращает или задаёт начало выполнения анимации.
Animation.timeline (en-US): Возвращает или задаёт timeline (en-US), связанную с этой анимации.

Обработчики событий

Animation.oncancel (en-US): Возвращает и задаёт обработчик событий для отмены события.
Animation.onfinish (en-US): Возвращает и задаёт обработчик событий для завершения события.

Методы

Animation.cancel(): Очищает все keyframeEffects (en-US) вызванные этой анимацией и прекращает его выполнение.
animation.commitStyles() (en-US): Фиксирует конечное состояние стиля анимации к анимируемому элементу, даже после того, как эта анимация была удалена. Это приведёт к тому, что конечное состояние стиля будет записано в анимируемый элемент в виде свойств внутри атрибута стиля.
Animation.finish() (en-US): Ищет конец анимации, в зависимости от того, играет ли анимация или инвертирует.
Animation.pause() (en-US): Приостанавливает запущенную анимацию.
animation.persist() (en-US): Анимация сохраняется в явном виде, когда в противном случае она была бы удалена из-за поведения браузера, которое предполагает автоматическое удаление анимаций заполнения.
Animation.play() (en-US): Запускает или продолжает выполнение анимации или начинает анимацию снова, если она ранее завершилась.
Animation.reverse() (en-US): Меняет направление воспроизведения, останавливаясь в начале анимации. Если анимация закончена или не запущена, то будет проигрываться с конца к началу.
Animation.updatePlaybackRate() (en-US): Задаёт скорость анимации после синхронизации её положения воспроизведения.

Спецификации

Specification
Web Animations # the-animation-interface

Совместимость с браузерами

BCD tables only load in the browser