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

CKTIS / JavaScript

Animation — управление на анимации в браузъра

Animation управлява възпроизвеждането на ефект по времева линия. С него можете да стартирате, поставяте на пауза и преглеждате анимация независимо от дефиницията на ключовите ѝ кадри.

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

Синтаксис

new Animation(effect, timeline)
const animation = element.animate(keyframes, options);

Animation управлява възпроизвеждането; KeyframeEffect описва ключовите кадри и времевите параметри, а DocumentTimeline предоставя времевата линия. Това е Web API, а не част от ECMAScript. Самото наличие на Node.js 24 не потвърждава, че API е достъпно.

new Animation(effect, timeline) не стартира възпроизвеждането автоматично; element.animate() създава анимация и я стартира. Методите play(), pause(), reverse() и cancel() управляват възпроизвеждането. При времева линия на документа currentTime представя милисекунди и може да има стойност null.

ready сигнализира за приключване на чакаща операция по възпроизвеждане или пауза; finished сигнализира за края на възпроизвеждането. Ако извикате cancel() за незавършена анимация, която не е в състояние idle, чакащият ѝ promise finished се отхвърля с грешка AbortError. Обработете отхвърлянето, ако използвате този promise. При новосъздадена анимация в състояние idle promise finished е в изчакване и остава в изчакване, ако извикате cancel(), докато анимацията е в това състояние.

Примерът задава времето, без да стартира възпроизвеждането: линейната интерполация дава непрозрачност 0.5. Проверете дали използваните API са налични в целевия браузър.

Примери

const box = document.createElement('div');
box.textContent = 'Animation';
document.body.append(box);

const effect = new KeyframeEffect(
  box,
  [{ opacity: 0 }, { opacity: 1 }],
  { duration: 1000, easing: 'linear', fill: 'both' }
);
const animation = new Animation(effect, document.timeline);
animation.currentTime = 500;

console.log(animation.currentTime);
console.log(getComputedStyle(box).opacity);

animation.cancel();
box.remove();

Резултат

500
0.5

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

Източници