База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Animation.play(): стартиране и възобновяване на анимации

Animation.play() стартира или възобновява съществуваща анимация. Не създава друга анимация и не връща promise.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

animation.play()

animation.play() не приема аргументи и връща undefined. За анимация, която използва времевата линия на документа (document.timeline), както в примера, при положителна ефективна скорост на възпроизвеждане play() запазва текущата позиция, ако текущото време е неотрицателно и е преди края на ефекта. Ако при тази скорост текущото време е достигнало или преминало края на ефекта, play() връща анимацията в началото, дори когато е на пауза.

След извикване на updatePlaybackRate() ефективната скорост на възпроизвеждане, която play() използва, може да се различава от стойността на playbackRate: ако промяната на скоростта още не е приложена, play() използва новата стойност. Затова при времевата линия на документа все още неприложена отрицателна стойност може да накара play() да премести текущото време от нула до края на ефект с крайна продължителност, дори когато playbackRate все още показва положителна стойност.

Стартирането на възпроизвеждането може да изчака асинхронна задача. animation.ready сигнализира готовност, а animation.finished — завършване. Самото извикване на play() не чака нито едното.

Това е уеб API, а не функция на ECMAScript. Проверете поддръжката в целевия браузър; Node 24 не я доказва. Примерът показва възобновяване от позиция в рамките на времевия диапазон на ефекта, а не случай, в който отрицателната скорост още не е приложена. Той използва ефект без целеви елемент и не изчертава нищо.

Примери

const effect = new KeyframeEffect(null, [], { duration: 1000 });
const animation = new Animation(effect, document.timeline);

animation.currentTime = 400;
const result = animation.play();
console.log(result === undefined, animation.currentTime);

animation.finish();
console.log(animation.playState, animation.currentTime);

Резултат

true 400
finished 1000

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници