CKTIS / CSS
animation-play-state : suspendre puis poursuivre la même animation
Figez la progression de l’animation et reprenez-la sans perdre sa position courante.
Version : CSS Modules
Syntaxe
animation-play-state: paused;animation-play-state accepte running ou paused, avec running comme valeur initiale. La pause arrête l’horloge de l’animation et laisse son effet courant visible. Revenir à running continue depuis cette position au lieu de recommencer. La pause fige aussi un animation-delay inachevé. Avec plusieurs entrées de animation-name, les états séparés par des virgules contrôlent chaque animation ; une liste plus courte se répète.
Une pause n’est ni une annulation, ni le retrait du nom de l’animation, ni une remise à zéro du style sous-jacent. Elle ne suspend pas les transitions indépendantes, les vidéos ou le travail JavaScript. Une animation terminée ne devient pas automatiquement un nouveau cycle simplement parce que running est redéclaré. Un contrôle explicite de lecture/pause par la Web Animations API peut aussi supplanter le contrôle CSS correspondant selon ses propres règles ; définissez clairement le responsable au lieu de mélanger accidentellement deux contrôleurs.
L’exemple démarre une animation CSS en pause, place sa position à 250ms et lit une opacité de 0.25. Deux trames d’animation plus tard, le temps est inchangé. Passer la propriété CSS à running fait avancer le même objet d’animation au-delà de cette position ; revenir à paused fige le nouveau temps pendant deux trames supplémentaires. Une autre animation avec un délai de 1s reste à 400ms dans ce délai lorsqu’elle est en pause, en laissant l’opacité sous-jacente à 0.7. Les vérifications de progression affichées sont des booléens, pas des intervalles fixes de trame inventés.
Exemples
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);Résultat
held=250; opacity=0.25; stable=true resumed=true; same-animation=true; paused-again=true; state=paused delay-held=true; delay-opacity=0.7
Exécuté dans Chromium 157.0.8103.51 avec de véritables rappels de trame d’animation. Le code change l’état de lecture en CSS ; currentTime sert uniquement à fixer les positions de mesure. Il vérifie pause/reprise et délai suspendu, pas l’ordonnancement des onglets en arrière-plan, le redémarrage d’une animation terminée ni les cas de priorité de l’API.