CKTIS / CSS
animation-play-state: mettere in pausa e proseguire la stessa animazione
Ferma l’avanzamento dell’animazione e riprendilo senza perdere la posizione corrente.
Versione: CSS Modules
Sintassi
animation-play-state: paused;animation-play-state accetta running o paused, con running come valore iniziale. La pausa ferma l’orologio dell’animazione e mantiene visibile l’effetto corrente. Tornare a running prosegue da quella posizione invece di ricominciare. La pausa blocca anche un animation-delay non ancora concluso. Con più voci di animation-name, gli stati separati da virgole controllano le singole animazioni; un elenco più corto si ripete.
La pausa non è un annullamento, la rimozione del nome dell’animazione o un ripristino dello stile sottostante. Non sospende transizioni indipendenti, video o lavoro JavaScript. Un’animazione terminata non diventa automaticamente un nuovo ciclo solo perché running viene dichiarato di nuovo. Il controllo esplicito di riproduzione/pausa tramite Web Animations API può inoltre prevalere sul controllo CSS corrispondente secondo regole separate; chiarisci quale meccanismo controlla l’animazione invece di mescolarne accidentalmente due.
L’esempio avvia un’animazione CSS in pausa, ne imposta la posizione a 250ms e legge opacità 0.25. Dopo due fotogrammi di animazione il tempo è invariato. Passare la proprietà CSS a running fa avanzare lo stesso oggetto di animazione oltre quella posizione; tornare a paused mantiene il nuovo tempo per altri due fotogrammi. Un’animazione distinta con ritardo di 1s resta a 400ms di quel ritardo mentre è in pausa, lasciando l’opacità sottostante a 0.7. Le verifiche di avanzamento stampate sono booleani, non intervalli fissi di fotogramma inventati.
Esempi
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);Risultato
held=250; opacity=0.25; stable=true resumed=true; same-animation=true; paused-again=true; state=paused delay-held=true; delay-opacity=0.7
Eseguito in Chromium 157.0.8103.51 con callback reali dei fotogrammi di animazione. Il codice cambia lo stato tramite CSS; currentTime serve solo a stabilire le posizioni di misura. Verifica pausa/ripresa e ritardo sospeso, non la pianificazione delle schede in background, il riavvio di animazioni terminate o i casi di prevalenza dell’API.