Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła