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

CKTIS / CSS

animation-play-state: пауза и продължаване на същата анимация

Задръжте напредъка и продължете без загуба на текущата позиция.

Версия: CSS Modules

Синтаксис

animation-play-state: paused;

animation-play-state приема running или paused; началната стойност е running. Паузата спира часовника на анимацията и запазва текущия ѝ ефект видим. Връщането към running продължава от тази позиция, вместо да започне отначало. Паузата замразява и незавършено animation-delay. При няколко елемента на animation-name състоянията със запетаи управляват отделни анимации; по-краткият списък се повтаря.

Паузата не е отмяна, премахване на името на анимацията или нулиране на основния стил. Не спира несвързани преходи, видеа или работа на JavaScript. Завършена анимация не става нов цикъл само защото отново е декларирано running. Изрично управление на изпълнението и паузата през Web Animations API също може да надделее над съответния CSS контрол според отделни правила; определете отговорността ясно, вместо случайно да смесвате два управляващи механизма.

Примерът започва CSS анимация в пауза, задава позиция 250ms и отчита непрозрачност 0.25. След два анимационни кадъра времето е непроменено. Превключването на CSS свойството на running придвижва същия обект напред; връщането към paused задържа новото време през още два кадъра. Отделна анимация със закъснение 1s в пауза остава на 400ms от закъснението и запазва основната непрозрачност 0.7. Отпечатаните проверки за напредък са логически стойности, а не измислени фиксирани интервали между кадри.

Примери

const style=document.createElement('style');style.textContent='@keyframes play-demo{from{opacity:0}to{opacity:1}}';document.head.append(style);
const frame=()=>new Promise(resolve=>requestAnimationFrame(resolve));
const el=document.createElement('div');el.style.cssText='opacity:0.7;animation-name:play-demo;animation-duration:1s;animation-timing-function:linear;animation-fill-mode:both;animation-play-state:paused';document.body.append(el);
const animation=el.getAnimations()[0];await animation.ready;animation.currentTime=250;const held=animation.currentTime,opacity=getComputedStyle(el).opacity;
await frame();await frame();const stable=animation.currentTime===held;
el.style.animationPlayState='running';getComputedStyle(el).animationPlayState;await animation.ready;await frame();await frame();
const advanced=animation.currentTime>held,same=el.getAnimations()[0]===animation;
el.style.animationPlayState='paused';getComputedStyle(el).animationPlayState;await animation.ready;const stopped=animation.currentTime;await frame();await frame();
const delayed=document.createElement('div');delayed.style.cssText='opacity:0.7;animation:play-demo 1s linear 1s paused';document.body.append(delayed);
const waiting=delayed.getAnimations()[0];await waiting.ready;waiting.currentTime=400;await frame();await frame();
console.log('held='+held+'; opacity='+opacity+'; stable='+stable);
console.log('resumed='+advanced+'; same-animation='+same+'; paused-again='+(animation.currentTime===stopped)+'; state='+animation.playState);
console.log('delay-held='+(waiting.currentTime===400)+'; delay-opacity='+getComputedStyle(delayed).opacity);

Резултат

held=250; opacity=0.25; stable=true
resumed=true; same-animation=true; paused-again=true; state=paused
delay-held=true; delay-opacity=0.7

Изпълнено в Chromium 157.0.8103.51 с реални извиквания за анимационни кадри. Кодът променя състоянието през CSS; currentTime служи само за задаване на измерваните позиции. Проверява пауза, продължаване и паузирано закъснение, не планиране на фонови раздели, рестарт на завършена анимация или предимство на API.

Източници