Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

scroll() — anonimowa oś postępu przewijania

`scroll()` tworzy anonimową oś postępu dla `animation-timeline`, wybierając kontener przewijania oraz jego oś.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

scroll( [ <scroller> || <axis> ]? )

scroll() tworzy anonimową oś postępu dla animation-timeline, wybierając kontener przewijania oraz jego oś.

Prawdziwy kontener z scroll(nearest block) przy pozycjach 0/100/200px daje krycie 0/0.5/1; obiekt osi to ScrollTimeline. Wariant własny bez przepełnienia jest nieaktywny, a obsługa składni wynosi true.

Składnia: scroll( [ <scroller> || <axis> ]? ).

Domyślne argumenty to nearest i block. root wybiera obszar dokumentu, self główne pudełko elementu, a osie to także inline, x i y. Postęp odpowiada scroll offset / (scrollable overflow - scrollport); brak przepełnienia lub nieprzewijalne self daje czas null. Początek zależy od writing-mode, nawet dla osi fizycznych, a czas trwania skończonej osi wynosi 100%.

Przykłady

const style=document.createElement('style');style.textContent='@keyframes reveal{from{opacity:0}to{opacity:1}}.scroller{width:100px;height:100px;overflow:auto}.track{height:300px}.subject{animation:reveal linear both;animation-timeline:scroll(nearest block)}.inactive{animation:reveal linear both;animation-timeline:scroll(self block)}';document.head.append(style);
const scroller=document.createElement('div');scroller.className='scroller';const track=document.createElement('div');track.className='track';const subject=document.createElement('div');subject.className='subject';track.append(subject);scroller.append(track);document.body.append(scroller);
const inactive=document.createElement('div');inactive.className='inactive';document.body.append(inactive);
const settle=()=>new Promise(resolve=>requestAnimationFrame(()=>requestAnimationFrame(resolve)));
await settle();const animation=subject.getAnimations()[0];const inactiveAnimation=inactive.getAnimations()[0];
const sample=async top=>{scroller.scrollTop=top;await settle();return getComputedStyle(subject).opacity};
const top=await sample(0),middle=await sample(100),end=await sample(200);
console.log('opacity='+top+'/'+middle+'/'+end+'; timeline='+animation.timeline.constructor.name+'; inactive='+(inactiveAnimation.currentTime===null)+'; supported='+CSS.supports('animation-timeline','scroll(nearest block)'));

Wynik

opacity=0/0.5/1; timeline=ScrollTimeline; inactive=true; supported=true

`scroll()` tworzy anonimową oś postępu dla `animation-timeline`, wybierając kontener przewijania oraz jego oś.

Źródła