Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

animation-range: wybierz fragment osi przewijania

Przypnij te same klatki animacji do wybranego odcinka przewijania, zamiast dodawać opóźnienie w sekundach.

Wersja: CSS Modules

Składnia

animation-range: normal | <start> <end>?; /* comma-separated per animation */

animation-range to skrócony zapis animation-range-start i animation-range-end. Określa miejsce przypięcia animacji na jej osi, nie granice przewijania elementu. W animacji sterowanej przewijaniem procenty bez nazwanego zakresu odnoszą się do całej osi. Wartości entry i exit oznaczają natomiast nazwane fragmenty osi widoczności elementu; nie wybierają kontenera przewijania. Wiele zakresów oddzielonych przecinkami odpowiada liście animation-name.

W przykładzie obszar widoku o wysokości 200px zawiera 1000px treści, więc przewijana odległość wynosi 800px. Zakres 25% 75% przypina pojedyncze liniowe przejście przezroczystości do pozycji od 200px do 600px. Odczyty przy 0,200,400,600,800 dają opacity równe 0,0,0.5,1,1. Powrót do 400 przywraca 0.5: przewijanie steruje postępem w obu kierunkach. animation-fill-mode: both zachowuje wartości końcowe poza tym odcinkiem; sam zakres nie zapewnia takiego zachowania.

Pominięcie końca ma dwa różne znaczenia. Samo 25% ustawia początek na 25% i przywraca koniec normal. Samo entry używa początku i końca zakresu entry; oba długie zapisy mogą serializować się jako entry, mimo różnych domyślnych przesunięć. Przykład sprawdza te odczytane właściwości, ale nie mierzy geometrii wejścia na osi widoczności. Para sekund taka jak 2s 4s jest odrzucana.

Zapisuj animation-timeline i animation-range po skrócie animation, który je resetuje. Zapewnij użyteczny wygląd statyczny i sprawdź docelowe przeglądarki: to mechanizm animacji przewijania, a nie uniwersalny zamiennik animation-delay dla zegara dokumentu. Przykład mierzy rzeczywistą przezroczystość po klatkach renderowania, bez zasobów sieciowych i danych użytkownika.

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.animationRange='25% 75%';
const values=await sample([0,200,400,600,800,400]);
const shorthand=document.createElement('div').style;shorthand.animationRange='entry';const named=shorthand.animationRangeStart+' / '+shorthand.animationRangeEnd;
shorthand.animationRange='25%';const lone=shorthand.animationRangeStart+' / '+shorthand.animationRangeEnd;
console.log('scroll-range='+(scroller.scrollHeight-scroller.clientHeight)+'; opacity='+values+'; entry='+named+'; lone='+lone+'; seconds='+CSS.supports('animation-range','2s 4s'));

Wynik

scroll-range=800; opacity=0.00,0.00,0.50,1.00,1.00,0.50; entry=entry / entry; lone=25% / normal; seconds=false

Wykonano w Chromium 157.0.8103.51. Animacja używa czasu auto, jednej iteracji i funkcji linear; inne ustawienia iteracji, tempa lub wypełnienia zmieniają widoczny efekt.

Źródła