--- title: Animation slug: Web/API/Animation translation_of: Web/API/Animation --- <div>{{ APIRef("Web Animations") }}{{SeeCompatTable}}</div> <p><code><strong>Animation</strong></code> это интерфейс <a href="https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API">Web Animations API</a>, представляет из себя одиночный проигрыватель анимации и обеспечивает управление воспроизведением и временную шкалу для узла анимации или источника.</p> <h2 id="Конструктор">Конструктор</h2> <dl> <dt>{{domxref("Animation.Animation()", "Animation()")}}</dt> <dd>Создаёт новый экземпляр объекта <code>Animation.</code></dd> </dl> <h2 id="Свойства">Свойства</h2> <dl> <dt>{{domxref("Animation.currentTime")}}</dt> <dd>Текущее значение времени анимации в миллисекундах, независимо от того работает анимация или приостановлена. Если анимация не имеет {{domxref("AnimationTimeline", "timeline")}}, неактивна или ещё не воспроизведена, то это значение равно нулю.</dd> </dl> <dl> <dt>{{domxref("Animation.effect")}}</dt> <dd>Возвращает и задаёт {{domxref ("AnimationEffectReadOnly")}} связанный с этой анимацией. Обычно это объект {{domxref ("KeyframeEffect")}}.</dd> <dt>{{domxref("Animation.finished")}} {{readOnlyInline}}</dt> <dd>Возвращает промис, сигнализирующий о завершении анимации.</dd> </dl> <dl> <dt>{{domxref("Animation.id")}}</dt> <dd>Возвращает и задаёт String(строку), используемую для идентификации анимации.</dd> <dt>{{domxref("Animation.playState")}} {{readOnlyInline}}</dt> <dd>Возвращает перечисляемое значение, описывающее состояние воспроизведения анимации.</dd> </dl> <dl> <dt>{{domxref("Animation.playbackRate")}}</dt> <dd>Возвращает или задаёт скорость воспроизведения анимации.</dd> </dl> <dl> <dt>{{domxref("Animation.ready")}} {{readOnlyInline}}</dt> <dd>Возвращает промис, сигнализирующий о начале проигрывания анимации.</dd> </dl> <dl> <dt>{{domxref("Animation.startTime")}}</dt> <dd>Возвращает или задаёт начало выполнения анимации.</dd> </dl> <dl> <dt>{{domxref("Animation.timeline")}}</dt> <dd>Возвращает или задаёт {{domxref("AnimationTimeline", "timeline")}}, связанную с этой анимации.</dd> </dl> <h3 id="Обработчики_событий">Обработчики событий</h3> <dl> <dt>{{domxref("Animation.oncancel")}}</dt> <dd>Возвращает и задаёт обработчик событий для отмены события.</dd> <dt>{{domxref("Animation.onfinish")}}</dt> <dd>Возвращает и задаёт обработчик событий для завершения события.</dd> </dl> <h2 id="Методы">Методы</h2> <dl> <dt>{{domxref("Animation.cancel()")}}</dt> <dd>Очищает все {{domxref("KeyframeEffect", "keyframeEffects")}} вызванные этой анимацией и прекращает его выполнение.</dd> <dt>{{domxref("animation.commitStyles()")}}</dt> <dd>Фиксирует конечное состояние стиля анимации к анимируемому элементу, даже после того, как эта анимация была удалена. Это приведёт к тому, что конечное состояние стиля будет записано в анимируемый элемент в виде свойств внутри атрибута стиля.</dd> </dl> <dl> <dt>{{domxref("Animation.finish()")}}</dt> <dd>Ищет конец анимации, в зависимости от того, играет ли анимация или инвертирует.</dd> </dl> <dl> <dt>{{domxref("Animation.pause()")}}</dt> <dd>Приостанавливает запущенную анимацию.</dd> <dt>{{domxref("animation.persist()")}}</dt> <dd>Анимация сохраняется в явном виде, когда в противном случае она была бы удалена из-за поведения браузера, которое предполагает автоматическое удаление анимаций заполнения.</dd> </dl> <dl> <dt>{{domxref("Animation.play()")}}</dt> <dd>Запускает или продолжает выполнение анимации или начинает анимацию снова, если она ранее завершилась.</dd> </dl> <dl> <dt>{{domxref("Animation.reverse()")}}</dt> <dd>Меняет направление воспроизведения, останавливаясь в начале анимации. Если анимация закончена или не запущена, то будет проигрываться с конца к началу.</dd> <dt>{{domxref("Animation.updatePlaybackRate()")}}</dt> <dd>Задаёт скорость анимации после синхронизации её положения воспроизведения.</dd> </dl> <h2 id="Спецификации">Спецификации</h2> {{Specifications}} <h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> <p>{{Compat}}</p>