CKTIS / CSS
animation-duration: długość jednego cyklu
Określ czas jednej iteracji animacji sterowanej czasem, niezależnie od opóźnienia i liczby powtórzeń.
Wersja: CSS Modules
Składnia
animation-duration: 1s, 250ms;animation-duration ustala długość jednej iteracji, a nie łączny czas wszystkich powtórzeń ani początkowego opóźnienia. Użyj nieujemnego czasu z s lub ms; czas ujemny i niezerowa liczba bez jednostki są nieprawidłowe. Wartości oddzielone przecinkami odpowiadają pozycjom animation-name; krótsza lista czasów jest powtarzana, aby pokryć nazwy. Dla zwykłej animacji sterowanej czasem iloczyn długości cyklu i animation-iteration-count daje aktywny czas trwania, a animation-delay jest osobne.
CSS Animations Level 2 definiuje auto jako wartość początkową. Na osi czasu dokumentu auto zachowuje się jak 0s; raportowanie stylu zgodne ze starszymi zasadami może pokazać 0s. Zero nie oznacza braku animacji: jej aktywny przedział jest chwilowy, zdarzenia początku i końca nadal mogą wystąpić, a animation-fill-mode decyduje o widocznym efekcie przed i po nim. Na osi sterowanej przewijaniem auto wypełnia odpowiedni zakres osi z uwzględnieniem innych ustawień czasu; obecny projekt traktuje tam jawny czas jak auto. Nie oznacza to odtwarzania animacji przewijania przez stałą liczbę sekund zegarowych.
Przykład tworzy wstrzymane liniowe animacje przezroczystości i odczytuje każdą w chwili 500ms. Cykl 1s daje 0.5, a cykl 2s daje 0.25. Przy wypełnieniu both i domyślnym kierunku do przodu wartości 0s i auto pokazują już punkt końcowy 1; ich obliczone czasy iteracji wynoszą zero. Przeglądarka odrzuca też -1s i samą wartość 1. Są to rzeczywiste odczyty stylu i parametrów czasu, a nie odliczanie ani deklaracja liczby klatek na sekundę.
Przykłady
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'));Wynik
opacity=0.5,0.25,1,1 duration=1000,2000,0,0 negative=false; unitless=false; auto=true
Wykonano w Chromium 157.0.8103.51 na osi czasu dokumentu. Przykład sprawdza czasowe animacje i auto, nie sterowanie przewijaniem ani dostarczanie zdarzeń. Opis przewijania wynika z aktualnego projektu CSS Animations Level 2; tę funkcję sprawdź osobno w docelowych przeglądarkach.