WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

animation-duration: die Länge eines Durchlaufs

Lege fest, wie lange eine zeitgesteuerte Animation für eine Iteration braucht, unabhängig von Verzögerung und Wiederholungszahl.

Version: CSS Modules

Syntax

animation-duration: 1s, 250ms;

animation-duration legt die Dauer einer Iteration fest, nicht die Gesamtzeit einschließlich aller Wiederholungen oder der Anfangsverzögerung. Verwende eine nichtnegative Zeit mit s oder ms; eine negative Zeit oder eine einheitenlose Zahl ungleich null ist ungültig. Durch Kommas getrennte Werte entsprechen den Einträgen von animation-name; eine kürzere Dauerliste wird wiederholt, bis alle Namen abgedeckt sind. Bei einer gewöhnlichen zeitgesteuerten Animation ergibt die Dauer multipliziert mit animation-iteration-count die aktive Dauer; animation-delay bleibt getrennt.

CSS Animations Level 2 definiert auto als Anfangswert. Auf der Dokumentzeitleiste verhält sich auto wie 0s; die aus Kompatibilitätsgründen aufgelöste Stilausgabe kann 0s anzeigen. Null bedeutet nicht, dass keine Animation existiert: Ihr aktives Intervall ist augenblicklich, Start- und Endereignisse können trotzdem auftreten, und animation-fill-mode bestimmt sichtbare Effekte davor oder danach. Auf einer scrollgesteuerten Zeitleiste füllt auto dagegen den relevanten Zeitleistenbereich unter Berücksichtigung der übrigen Zeiteinstellungen; der aktuelle Entwurf behandelt dort auch eine explizite Zeit wie auto. Eine Scrollanimation dauert dadurch nicht eine feste Zahl von Echtzeitsekunden.

Das Beispiel erstellt pausierte lineare Deckkraftanimationen und liest jede bei 500ms aus. Ein 1s-Durchlauf ergibt 0.5, ein 2s-Durchlauf 0.25. Mit both-Füllung und der voreingestellten Vorwärtsrichtung zeigen 0s und auto bereits den Endwert 1; ihre berechneten Iterationsdauern sind null. Der Browser verwirft außerdem -1s und den bloßen Wert 1. Dies sind echte Abfragen berechneter Stile und Zeitparameter, kein Countdown und keine Aussage zur Bildrate.

Beispiele

const style=document.createElement('style');
style.textContent='@keyframes duration-demo{from{opacity:0}to{opacity:1}}';document.head.append(style);
const make=duration=>{const el=document.createElement('div');el.style.cssText='opacity:0.3;animation-name:duration-demo;animation-timing-function:linear;animation-fill-mode:both;animation-play-state:paused';el.style.animationDuration=duration;document.body.append(el);const animation=el.getAnimations()[0];animation.currentTime=500;return {el,animation}};
const rows=['1s','2s','0s','auto'].map(make);
console.log('opacity='+rows.map(({el})=>getComputedStyle(el).opacity).join(','));
console.log('duration='+rows.map(({animation})=>animation.effect.getComputedTiming().duration).join(','));
console.log('negative='+CSS.supports('animation-duration','-1s')+'; unitless='+CSS.supports('animation-duration','1')+'; auto='+CSS.supports('animation-duration','auto'));

Ergebnis

opacity=0.5,0.25,1,1
duration=1000,2000,0,0
negative=false; unitless=false; auto=true

Ausgeführt in Chromium 157.0.8103.51 auf der Dokumentzeitleiste. Das Beispiel prüft zeitbasierte Dauer und auto, nicht scrollgesteuertes Timing oder die Zustellung von Ereignissen. Die Erklärung zum Scrollen folgt dem aktuellen Entwurf CSS Animations Level 2; prüfe diese Funktion gesondert in den Zielbrowsern.

Quellen