Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

animation-play-state: pauza i kontynuacja tej samej animacji

Zatrzymaj postęp animacji i wznów go bez utraty bieżącej pozycji.

Wersja: CSS Modules

Składnia

animation-play-state: paused;

animation-play-state przyjmuje running lub paused; wartością początkową jest running. Pauza zatrzymuje zegar animacji i pozostawia jej bieżący efekt widoczny. Powrót do running kontynuuje z tej pozycji zamiast zaczynać od nowa. Pauza zatrzymuje też niezakończone animation-delay. Przy kilku pozycjach animation-name stany rozdzielone przecinkami sterują poszczególnymi animacjami; krótsza lista jest powtarzana.

Pauza nie jest anulowaniem, usunięciem nazwy animacji ani resetem zwykłego stylu. Nie wstrzymuje niezależnych przejść, filmów czy pracy JavaScript. Zakończona animacja nie staje się automatycznie nowym cyklem tylko dlatego, że ponownie zadeklarujesz running. Jawne sterowanie odtwarzaniem i pauzą przez Web Animations API może też nadpisać odpowiadające mu sterowanie CSS według osobnych zasad; ustal odpowiedzialność, zamiast przypadkowo mieszać dwa mechanizmy sterujące.

Przykład tworzy animację CSS w stanie pauzy, ustawia pozycję na 250ms i odczytuje przezroczystość 0.25. Dwie klatki animacji później czas pozostaje bez zmian. Przełączenie właściwości CSS na running przesuwa ten sam obiekt animacji dalej; ponowna zmiana na paused zachowuje nowy czas przez dwie kolejne klatki. Osobna animacja z opóźnieniem 1s pozostaje w pauzie na 400ms tego opóźnienia, zachowując zwykłą przezroczystość 0.7. Wypisywane testy przesunięcia są wartościami logicznymi, a nie wymyślonymi stałymi odstępami między klatkami.

Przykłady

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);

Wynik

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

Wykonano w Chromium 157.0.8103.51 z rzeczywistymi wywołaniami klatek animacji. Kod zmienia stan odtwarzania przez CSS; currentTime służy tylko do ustawienia punktów pomiaru. Sprawdza pauzę, wznowienie i zatrzymane opóźnienie, nie harmonogram kart w tle, restart zakończonej animacji ani nadpisywanie przez API.

Źródła