Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

animation-timeline: wybierz, co steruje animacją

Rozróżniaj czas dokumentu, postęp przewijania i widoczność elementu podczas wyboru osi animacji.

Wersja: CSS Modules

Składnia

animation-timeline: auto | none | <dashed-ident> | scroll() | view();

animation-timeline wybiera źródło postępu każdej animacji CSS. auto korzysta z osi czasu dokumentu, none nie przypisuje żadnej osi, a identyfikator z myślnikami, np. --track, odwołuje się do dostępnej nazwanej osi przewijania lub widoczności. scroll() śledzi przewijanie wybranego kontenera w określonej osi, a view() przechodzenie elementu przez obszar przewijania. Nazwa klatek nie tworzy osi o tej samej nazwie. Wartości oddzielone przecinkami odpowiadają liście animation-name.

Brak nazwanej osi nie powoduje cichego przełączenia na zegar dokumentu. Oś przewijania wymaga też prawidłowego źródła z nadmiarem treści możliwym do przewinięcia w wybranym kierunku. none to nie animation-play-state: paused: brak powiązanej osi różni się od zachowania i wstrzymania pozycji odtwarzania. Przy animacji przewijania czas auto i skończona liczba iteracji pozwalają rozłożyć efekt na zakres przypięcia.

Przykład porównuje anonimową oś scroll(nearest block) z --track zdefiniowaną na tym samym kontenerze. Przy pozycji 400 z zakresu 800px obie dają opacity 0.5. Zmiana na none i nieistniejącą --missing daje bazową przezroczystość 0.2 przy wypełnieniu none. Osobna wstrzymana animacja na zegarze dokumentu, odczytana w 500ms jednosekundowego czasu, daje 0.5. Test nie wymaga logowania, żądania sieciowego ani zewnętrznego zegara.

Ostatnia kontrola pokazuje, że późniejszy skrót animation resetuje wybraną oś przewijania do auto. Umieszczaj deklaracje osi i zakresu po tym skrócie, aby je zachować. Sprawdź rzeczywiste zachowanie w docelowych przeglądarkach i zapewnij statyczną treść przy braku osi. Przykład weryfikuje nazwaną i anonimową oś przewijania oraz kontrolę z zegarem dokumentu; nie udaje badania geometrii view().

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(',')};
scroller.style.scrollTimeline='--track block';box.style.animationFillMode='none';
const named=box.cloneNode();named.style.animationTimeline='--track';space.append(named);
scroller.scrollTop=400;await frame();const halfway=[box,named].map(e=>Number(getComputedStyle(e).opacity).toFixed(2)).join(',');
box.style.animationTimeline='none';named.style.animationTimeline='--missing';await frame();const inactive=[box,named].map(e=>Number(getComputedStyle(e).opacity).toFixed(2)).join(',');
box.style.animation='fade 1s linear both paused';getComputedStyle(box).opacity;const time=box.getAnimations()[0];time.currentTime=500;const clock=Number(getComputedStyle(box).opacity).toFixed(2);
box.style.animationTimeline='scroll(nearest block)';const before=box.style.animationTimeline;box.style.animation='fade 2s linear';const after=getComputedStyle(box).animationTimeline;
console.log('halfwayAnonymousNamed='+halfway+'; inactiveNoneMissing='+inactive+'; clockAt500ms='+clock+'; reset='+before+' / '+after);

Wynik

halfwayAnonymousNamed=0.50,0.50; inactiveNoneMissing=0.20,0.20; clockAt500ms=0.50; reset=scroll() / auto

Wykonano w Chromium 157.0.8103.51. Przeglądarka serializuje scroll(nearest block) jako scroll(); pominięte argumenty są domyślne, a nie utracone.

Źródła