WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

animation-play-state: dieselbe Animation pausieren und fortsetzen

Halte den Animationsfortschritt an und setze ihn fort, ohne die aktuelle Position zu verlieren.

Version: CSS Modules

Syntax

animation-play-state: paused;

animation-play-state akzeptiert running oder paused; running ist der Anfangswert. Pausieren hält die Animationsuhr an und lässt den aktuellen Effekt sichtbar. Die Rückkehr zu running setzt an dieser Position fort, statt neu zu beginnen. Auch eine noch nicht abgeschlossene animation-delay wird angehalten. Bei mehreren animation-name-Einträgen steuern kommagetrennte Wiedergabezustände die einzelnen Animationen; eine kürzere Liste wird wiederholt.

Pausieren ist weder Abbrechen noch Entfernen des Animationsnamens oder Zurücksetzen des zugrunde liegenden Stils. Unabhängige Übergänge, Videos oder JavaScript-Arbeit werden nicht pausiert. Eine beendete Animation wird nicht automatisch zu einem neuen Durchlauf, nur weil running erneut deklariert wird. Explizite Wiedergabe-/Pausensteuerung über die Web Animations API kann die entsprechende CSS-Steuerung nach eigenen Regeln übersteuern. Halte deshalb klar fest, welcher Mechanismus steuert, statt versehentlich beide zu mischen.

Das Beispiel startet eine CSS-Animation pausiert, setzt ihre Position auf 250ms und liest die Deckkraft 0.25. Zwei Animationsframes später ist die Zeit unverändert. Das Umschalten der CSS-Eigenschaft auf running lässt dasselbe Animationsobjekt über diese Position hinaus fortschreiten; das Zurückschalten auf paused hält die neue Zeit über zwei weitere Frames. Eine separate Animation mit 1s Verzögerung bleibt während der Pause bei 400ms innerhalb dieser Verzögerung und lässt die zugrunde liegende Deckkraft 0.7 bestehen. Die ausgegebenen Fortschrittsprüfungen sind boolesche Werte, keine erfundenen festen Frameabstände.

Beispiele

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

Ergebnis

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

Ausgeführt in Chromium 157.0.8103.51 mit tatsächlichen Animationsframe-Callbacks. Der Code ändert den Wiedergabezustand per CSS; currentTime dient nur zum Festlegen der Messpositionen. Geprüft werden Pause/Fortsetzung und eine pausierte Verzögerung, nicht die Planung von Hintergrund-Tabs, ein Neustart beendeter Animationen oder API-Übersteuerungen.

Quellen