Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

animation-range-start: scegliere dove inizia l’avanzamento guidato dallo scorrimento

Sposta il punto iniziale di associazione senza trasformare una percentuale in un ritardo temporale.

Versione: CSS Modules

Sintassi

animation-range-start: normal | <length-percentage> | <timeline-range-name> <length-percentage>?;

animation-range-start definisce l’inizio dell’intervallo di associazione. normal seleziona l’inizio della timeline associata. Una percentuale senza intervallo denominato si riferisce all’intera timeline; una lunghezza fornisce una distanza dal suo inizio. Con un intervallo di visibilità denominato, lo scostamento si misura al suo interno e, se omesso, seleziona il punto 0%. È un aspetto distinto dalla posizione dell’elemento e dai selettori dei fotogrammi chiave stessi.

Con un’iterazione e durata auto, cambiare l’inizio mantenendo fissa la fine modifica la distanza su cui avanza l’animazione. Prima di quell’intervallo, animation-fill-mode determina se il fotogramma iniziale rimane visibile. Scorrere all’indietro può riproporre stati precedenti: l’inizio non è un evento che scatta una sola volta. Usa animation-direction per la direzione di riproduzione anziché affidarti a un intervallo di associazione invertito.

L’esempio usa 800px di distanza scorribile, fine normal e fotogrammi chiave lineari di opacità. Un inizio di 25% colloca la partenza a 200px. Le posizioni 0,200,500,800,500 danno opacità 0,0,0.5,1,0.5. Cambiare l’inizio a 400px dà 0,0.5,1 nelle posizioni 400,600,800. Ripristinare normal dà 0.5 a 400. Il riempimento both conserva il valore iniziale prima dell’intervallo; si tratta di risultati misurati, non di percentuali simulate.

Imposta l’intervallo dopo la proprietà abbreviata animation, che lo reimposta, e abbina la proprietà a una animation-timeline appropriata. Un elenco separato da virgole corrisponde ad animation-name. Il supporto delle timeline guidate dallo scorrimento varia, quindi fornisci un’alternativa statica utile. Il test rifiuta un valore in secondi e non pretende di misurare la geometria degli intervalli di visibilità denominati.

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.animationRangeStart='25%';
const percent=await sample([0,200,500,800,500]);
box.style.animationRangeStart='400px';const length=await sample([400,600,800]);
box.style.animationRangeStart='normal';const normal=await sample([400]);
console.log('end='+getComputedStyle(box).animationRangeEnd+'; start25='+percent+'; start400px='+length+'; normalAt400='+normal+'; seconds='+CSS.supports('animation-range-start','2s'));

Risultato

end=normal; start25=0.00,0.00,0.50,1.00,0.50; start400px=0.00,0.50,1.00; normalAt400=0.50; seconds=false

Eseguito in Chromium 157.0.8103.51. Il test attende i fotogrammi renderizzati dopo lo scorrimento; non installa un listener di scorrimento e non modifica la pagina dell’utente della lezione.

Fonti