CKTIS / CSS
scroll() — anonymous scroll progress timeline
`scroll()` creates an anonymous progress timeline for `animation-timeline` by selecting a scroll container and an axis.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
scroll( [ <scroller> || <axis> ]? )scroll() creates an anonymous progress timeline for animation-timeline by selecting a scroll container and an axis.
A real container using scroll(nearest block) at positions 0/100/200px produces opacity 0/0.5/1; the timeline object is a ScrollTimeline. A self timeline without overflow is inactive, and syntax support is true.
Grammar: scroll( [ <scroller> || <axis> ]? ).
The defaults are nearest and block. root selects the document viewport, self the element’s principal box, and axes also include inline, x, and y. Progress is scroll offset / (scrollable overflow - scrollport); no overflow or a non-scrollable self gives current time null. The origin follows writing-mode even for physical axes, and a finite timeline’s duration is 100%.
Examples
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)'));Result
opacity=0/0.5/1; timeline=ScrollTimeline; inactive=true; supported=true
`scroll()` creates an anonymous progress timeline for `animation-timeline` by selecting a scroll container and an axis.