WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

scroll() — anonyme Scrollfortschritts-Zeitachse

`scroll()` erzeugt für `animation-timeline` eine anonyme Fortschrittsachse durch Auswahl von Scrollcontainer und Achse.

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() erzeugt für animation-timeline eine anonyme Fortschrittsachse durch Auswahl von Scrollcontainer und Achse.

Ein echter Container mit scroll(nearest block) liefert an den Positionen 0/100/200px die Deckkraft 0/0.5/1; das Achsenobjekt ist ScrollTimeline. Eine eigene Achse ohne Überlauf ist inaktiv, die Syntaxunterstützung beträgt true.

Grammatik: scroll( [ <scroller> || <axis> ]? ).

Standardwerte sind nearest und block. root wählt den Dokument-Viewport, self die Hauptbox des Elements; weitere Achsen sind inline, x und y. Der Fortschritt ist scroll offset / (scrollable overflow - scrollport); ohne Überlauf oder bei nicht scrollbarerer self ist die aktuelle Zeit null. Der Ursprung folgt writing-mode, auch bei physischen Achsen, und die Dauer einer endlichen Achse ist 100%.

Beispiele

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)'));

Ergebnis

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

`scroll()` erzeugt für `animation-timeline` eine anonyme Fortschrittsachse durch Auswahl von Scrollcontainer und Achse.

Quellen