Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

animation-range-start: wybierz początek postępu sterowanego przewijaniem

Przesuń punkt rozpoczęcia zakresu, nie zamieniając procentu w opóźnienie czasowe.

Wersja: CSS Modules

Składnia

animation-range-start: normal | <length-percentage> | <timeline-range-name> <length-percentage>?;

animation-range-start wyznacza początek zakresu przypięcia. normal wybiera początek powiązanej osi. Procent bez nazwanego zakresu odnosi się do całej osi, a długość podaje odległość od jej początku. Przy nazwanym zakresie widoczności przesunięcie jest liczone wewnątrz niego; pominięcie przesunięcia wybiera punkt 0%. To osobna kwestia od położenia elementu i selektorów samych klatek animacji.

Przy jednej iteracji i czasie auto zmiana początku przy stałym końcu zmienia odległość, na której przebiega animacja. Przed tym odcinkiem animation-fill-mode określa, czy początkowa klatka pozostaje widoczna. Przewijanie wstecz może przywracać wcześniejsze stany: początek nie jest jednorazowym wyzwalaczem zdarzenia. Do kierunku odtwarzania używaj animation-direction zamiast odwróconego przedziału przypięcia.

Przykład używa 800px przewijanej odległości, końca normal i liniowych klatek opacity. Początek 25% wypada przy 200px. Pozycje 0,200,500,800,500 dają przezroczystość 0,0,0.5,1,0.5. Zmiana początku na 400px daje 0,0.5,1 przy pozycjach 400,600,800. Przywrócenie normal daje 0.5 w pozycji 400. Wypełnienie both utrzymuje wartość początkową przed zakresem; wyniki są zmierzone, a nie zasymulowane z procentów.

Ustaw zakres po skrócie animation, który go resetuje, i powiąż właściwość z odpowiednim animation-timeline. Lista oddzielona przecinkami odpowiada animation-name. Obsługa osi przewijania jest różna w przeglądarkach, więc zapewnij użyteczny statyczny wygląd zastępczy. Test odrzuca wartość w sekundach i nie udaje pomiaru geometrii nazwanych zakresów widoczności.

Przykłady

const style=document.createElement('style');style.textContent='@keyframes fade{from{opacity:0}to{opacity:1}}';document.head.append(style);
const scroller=document.createElement('div');scroller.style.cssText='height:200px;width:200px;overflow:auto;scroll-behavior:auto';
const space=document.createElement('div');space.style.height='1000px';
const box=document.createElement('div');box.style.cssText='height:20px;width:20px;opacity:.2;animation:fade auto linear both;animation-timeline:scroll(nearest block)';
space.append(box);scroller.append(space);document.body.append(scroller);
const frame=()=>new Promise(resolve=>requestAnimationFrame(()=>requestAnimationFrame(resolve)));
const sample=async positions=>{const values=[];for(const y of positions){scroller.scrollTop=y;await frame();values.push(Number(getComputedStyle(box).opacity).toFixed(2));}return values.join(',')};
box.style.animationRangeStart='25%';
const percent=await sample([0,200,500,800,500]);
box.style.animationRangeStart='400px';const length=await sample([400,600,800]);
box.style.animationRangeStart='normal';const normal=await sample([400]);
console.log('end='+getComputedStyle(box).animationRangeEnd+'; start25='+percent+'; start400px='+length+'; normalAt400='+normal+'; seconds='+CSS.supports('animation-range-start','2s'));

Wynik

end=normal; start25=0.00,0.00,0.50,1.00,0.50; start400px=0.00,0.50,1.00; normalAt400=0.50; seconds=false

Wykonano w Chromium 157.0.8103.51. Test czeka na wyrenderowane klatki po przewinięciu; nie instaluje nasłuchu przewijania ani nie zmienia strony użytkownika lekcji.

Źródła