Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

scroll() — chronologie anonyme de progression du défilement

`scroll()` crée pour `animation-timeline` une chronologie anonyme en choisissant un conteneur de défilement et un axe.

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

Syntaxe

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

scroll() crée pour animation-timeline une chronologie anonyme en choisissant un conteneur de défilement et un axe.

Un conteneur réel utilisant scroll(nearest block) aux positions 0/100/200px donne l’opacité 0/0.5/1 ; l’objet est un ScrollTimeline. Une chronologie propre sans débordement est inactive, et la syntaxe est prise en charge true.

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

Les valeurs par défaut sont nearest et block. root choisit la fenêtre du document, self la boîte principale de l’élément ; les axes incluent aussi inline, x et y. La progression suit scroll offset / (scrollable overflow - scrollport) ; sans débordement ou avec self non défilable, le temps vaut null. L’origine suit writing-mode, même pour les axes physiques, et la durée d’une chronologie finie vaut 100%.

Exemples

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

Résultat

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

`scroll()` crée pour `animation-timeline` une chronologie anonyme en choisissant un conteneur de défilement et un axe.

Sources