Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

steps(): skokowy przebieg i jawne miejsca skoków

Zatrzymuj postęp animacji na kolejnych poziomach i wybierz skok na początku lub końcu przedziału.

Wersja: CSS Modules

Składnia

animation-timing-function: steps(4, jump-end);

Funkcja przebiegu steps() dzieli postęp wejściowy na równe przedziały i utrzymuje stałe wyjście wewnątrz każdego z nich. Pierwszy argument jest dodatnią liczbą całkowitą; opcjonalna pozycja ma domyślną wartość end, równoważną jump-end. Aliasy start i jump-start wybierają początkowy skok. To funkcja przebiegu w czasie, a nie żądanie określonej liczby klatek na sekundę ani liczby powtórzeń animacji.

Pozycja jump-none wyklucza skoki na obu zewnętrznych granicach i wymaga co najmniej dwóch kroków. jump-both obejmuje skok na każdej zewnętrznej granicy, a wewnętrzne poziomy rosną o 1/(n+1). Dla n równego cztery wariant none zwiększa wynik o jedną trzecią, a both — o jedną piątą. Zachowanie na końcach i granicach zależy też od fazy animacji; przykład ustala zwykły kierunek do przodu i jedną iterację, bez deklarowania sprawdzenia kierunku odwrotnego czy próbkowania przed fazą aktywną.

Wstrzymana animacja przeglądarki jest próbkowana w chwilach 0,249,250,500,999 i 1000 milisekund przy czasie trwania 1000ms. Wariant end daje 0,0,0.25,0.5,0.75,1; wariant start zaczyna od 0.25. Wiersze none i both pokazują odmienne wysokości poziomów, a próbka dokładnie w 250ms trafia już na następny poziom. Zero kroków i jeden krok z pozycją none są odrzucane; dwa kroki z none oraz pozycja domyślna mają poprawną składnię.

Przykłady

const box = document.createElement('div');
document.body.append(box);
for (const position of ['jump-end','jump-start','jump-none','jump-both']) {
  const animation = box.animate([{opacity:0},{opacity:1}], {
    duration:1000, fill:'both', easing:'steps(4,' + position + ')'
  });
  animation.pause();
  const values = [0,249,250,500,999,1000].map(time => {
    animation.currentTime = time;
    return Number(animation.effect.getComputedTiming().progress.toFixed(6));
  });
  console.log(position + ':', values.join(','));
  animation.cancel();
}
for (const value of ['steps(0)','steps(1,jump-none)','steps(2,jump-none)','steps(4)']) {
  console.log(value + ':', CSS.supports('animation-timing-function',value));
}
box.remove();

Wynik

jump-end: 0,0,0.25,0.5,0.75,1
jump-start: 0.25,0.25,0.5,0.75,1,1
jump-none: 0,0,0.333333,0.666667,1,1
jump-both: 0.2,0.2,0.4,0.6,0.8,1
steps(0): false
steps(1,jump-none): false
steps(2,jump-none): true
steps(4): true

Wartości pochodzą z modelu czasu Web Animations z jawnie ustawionym currentTime, a nie z czekania lub liczenia klatek. Interfejsy z intensywnym ruchem nadal wymagają obsługi preferencji ograniczenia ruchu i użytecznego stanu bez animacji.

Źródła