Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

scroll() — linha temporal anónima de progresso da deslocação

`scroll()` cria para `animation-timeline` uma linha temporal anónima escolhendo um contentor de deslocação e um eixo.

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

Sintaxe

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

scroll() cria para animation-timeline uma linha temporal anónima escolhendo um contentor de deslocação e um eixo.

Um contentor real com scroll(nearest block) nas posições 0/100/200px produz opacidade 0/0.5/1; o objeto é ScrollTimeline. Uma linha própria sem extravasamento fica inativa e a sintaxe é suportada true.

Gramática: scroll( [ <scroller> || <axis> ]? ).

Os valores predefinidos são nearest e block. root escolhe a área do documento, self a caixa principal do elemento; os eixos incluem inline, x e y. O progresso é scroll offset / (scrollable overflow - scrollport); sem extravasamento ou com self não deslocável, o tempo é null. A origem segue writing-mode, mesmo nos eixos físicos, e a duração finita é 100%.

Exemplos

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

Resultado

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

`scroll()` cria para `animation-timeline` uma linha temporal anónima escolhendo um contentor de deslocação e um eixo.

Fontes