Animation
=========

Baseline 2022
-------------

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

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

**`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 with JavaScript enabled. Enable JavaScript to view data.