Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

animation-range: scegliere una porzione della timeline di scorrimento

Associa gli stessi fotogrammi chiave a un intervallo di scorrimento scelto, invece di aggiungere un ritardo misurato in secondi.

Versione: CSS Modules

Sintassi

animation-range: normal | <start> <end>?; /* comma-separated per animation */

animation-range è la proprietà abbreviata per animation-range-start e animation-range-end. Stabilisce dove un’animazione è associata alla sua timeline, non i limiti di scorrimento dell’elemento. In un’animazione guidata dallo scorrimento, le percentuali senza un intervallo denominato si riferiscono all’intera timeline. Valori come entry o exit indicano invece porzioni denominate di una timeline di visibilità; non sono selettori di contenitori di scorrimento. Più intervalli separati da virgole corrispondono all’elenco animation-name.

Nell’esempio, un’area visibile di 200px contiene 1000px di contenuto, quindi la distanza scorribile è 800px. L’intervallo 25% 75% associa un’unica dissolvenza lineare alle posizioni da 200px a 600px. Le letture a 0,200,400,600,800 danno opacità 0,0,0.5,1,1. Tornare a 400 ripristina 0.5: lo scorrimento guida l’avanzamento in entrambe le direzioni. animation-fill-mode: both conserva i valori agli estremi fuori dall’intervallo; il solo intervallo non richiede questo comportamento.

Omettere la fine ha due significati diversi. Un singolo 25% imposta l’inizio a 25% e ripristina la fine a normal. Un singolo entry usa l’inizio e la fine dell’intervallo entry; le due proprietà estese possono essere serializzate semplicemente come entry, anche se i loro scostamenti predefiniti sono diversi. L’esempio controlla queste proprietà dopo il parsing, ma non misura la geometria di ingresso di una timeline di visibilità. Una coppia in secondi come 2s 4s viene rifiutata.

Scrivi animation-timeline e animation-range dopo la proprietà abbreviata animation, perché questa le reimposta. Offri un’alternativa statica utilizzabile e prova i browser di destinazione: si tratta di animazioni guidate dallo scorrimento, non di una sostituzione portabile di animation-delay sull’orologio del documento. L’esempio misura l’opacità reale dopo il rendering dei fotogrammi, senza risorse di rete né dati degli utenti.

Esempi

const style=document.createElement('style');style.textContent='@keyframes fade{from{opacity:0}to{opacity:1}}';document.head.append(style);
const scroller=document.createElement('div');scroller.style.cssText='height:200px;width:200px;overflow:auto;scroll-behavior:auto';
const space=document.createElement('div');space.style.height='1000px';
const box=document.createElement('div');box.style.cssText='height:20px;width:20px;opacity:.2;animation:fade auto linear both;animation-timeline:scroll(nearest block)';
space.append(box);scroller.append(space);document.body.append(scroller);
const frame=()=>new Promise(resolve=>requestAnimationFrame(()=>requestAnimationFrame(resolve)));
const sample=async positions=>{const values=[];for(const y of positions){scroller.scrollTop=y;await frame();values.push(Number(getComputedStyle(box).opacity).toFixed(2));}return values.join(',')};
box.style.animationRange='25% 75%';
const values=await sample([0,200,400,600,800,400]);
const shorthand=document.createElement('div').style;shorthand.animationRange='entry';const named=shorthand.animationRangeStart+' / '+shorthand.animationRangeEnd;
shorthand.animationRange='25%';const lone=shorthand.animationRangeStart+' / '+shorthand.animationRangeEnd;
console.log('scroll-range='+(scroller.scrollHeight-scroller.clientHeight)+'; opacity='+values+'; entry='+named+'; lone='+lone+'; seconds='+CSS.supports('animation-range','2s 4s'));

Risultato

scroll-range=800; opacity=0.00,0.00,0.50,1.00,1.00,0.50; entry=entry / entry; lone=25% / normal; seconds=false

Eseguito in Chromium 157.0.8103.51. La dissolvenza usa durata auto, un’iterazione e andamento lineare; impostazioni diverse per iterazioni, andamento o riempimento cambiano il risultato visibile.

Fonti