CKTIS / CSS
animation-range-end: impostare il punto finale di associazione
Scegli dove l’animazione selezionata raggiunge la fine del proprio intervallo di associazione, lasciando indipendente l’inizio.
Versione: CSS Modules
Sintassi
animation-range-end: normal | <length-percentage> | <timeline-range-name> <length-percentage>?;animation-range-end specifica la fine dell’intervallo di associazione di un’animazione. normal usa la fine della timeline associata. Una percentuale o lunghezza senza nome si misura dall’inizio della timeline, non a ritroso dalla sua fine né da animation-range-start. Con un intervallo di visibilità denominato, come exit 80%, lo scostamento è relativo a quell’intervallo; il solo nome indica per impostazione predefinita il suo punto 100%. Un valore in secondi non è un estremo valido dell’intervallo.
Per una sola iterazione con durata auto, un punto finale fissato prima concentra l’animazione in una porzione più breve della distanza di scorrimento. Non modifica il fotogramma chiave 100%, non impedisce lo scorrimento della pagina e non rimuove l’elemento. Ciò che rimane visibile dopo l’intervallo dipende da animation-fill-mode. Specifica una fine successiva all’inizio desiderato; punti di associazione invertiti o coincidenti non servono a richiedere un’animazione al contrario.
L’esempio mantiene l’inizio a normal su una distanza scorribile di 800px. Con fine 50%, l’opacità nelle posizioni 0,200,400,800 è 0,0.5,1,1. Impostando invece la fine a 200px si ottiene 0,0.5,1,1 nelle posizioni 0,100,200,400. Ripristinare normal produce 0.5 nella posizione 400. Sono letture reali dello stile con andamento linear e riempimento both; la stessa sequenza di risultati rappresenta intervalli fisici diversi.
La proprietà può contenere un elenco separato da virgole, associato ai nomi delle animazioni. La proprietà abbreviata animation reimposta quelle dell’intervallo, quindi colloca questa dichiarazione dopo di essa. Mantieni un’alternativa statica per i browser che non supportano le animazioni guidate dallo scorrimento. L’esempio riguarda una timeline di avanzamento dello scorrimento; gli intervalli di visibilità denominati sono spiegati separatamente e qui non vengono presentati come geometria verificata.
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.animationRangeEnd='50%';
const percent=await sample([0,200,400,800]);
box.style.animationRangeEnd='200px';const length=await sample([0,100,200,400]);
box.style.animationRangeEnd='normal';const normal=await sample([400]);
console.log('start='+getComputedStyle(box).animationRangeStart+'; end50='+percent+'; end200px='+length+'; normalAt400='+normal+'; seconds='+CSS.supports('animation-range-end','2s'));Risultato
start=normal; end50=0.00,0.50,1.00,1.00; end200px=0.00,0.50,1.00,1.00; normalAt400=0.50; seconds=false
Eseguito in Chromium 157.0.8103.51 dopo due fotogrammi di rendering per ogni variazione dello scorrimento. Le percentuali usano la distanza scorribile, non l’intera altezza del contenuto di 1000px né quella visibile di 200px.