CKTIS / CSS
animation-timeline: scegliere cosa guida l’animazione
Distingui tempo del documento, avanzamento dello scorrimento e visibilità dell’elemento quando scegli la timeline di un’animazione.
Versione: CSS Modules
Sintassi
animation-timeline: auto | none | <dashed-ident> | scroll() | view();animation-timeline seleziona la sorgente di avanzamento di ogni animazione CSS. auto usa la timeline del documento, none non associa alcuna timeline e un identificatore con trattini come --track fa riferimento a una timeline denominata di scorrimento o visibilità nell’ambito disponibile. scroll() segue lo scorrimento nel contenitore e lungo l’asse selezionati; view() segue il passaggio di un elemento nell’area visibile di scorrimento. Il nome dei fotogrammi chiave non definisce una timeline con lo stesso nome. Più valori separati da virgole corrispondono all’elenco animation-name.
Una timeline denominata mancante non provoca un ritorno silenzioso all’orologio del documento. Una timeline di scorrimento richiede anche una sorgente valida con contenuto eccedente scorribile sull’asse scelto. none non equivale ad animation-play-state: paused: non selezionare alcuna timeline è diverso dal mantenere e mettere in pausa una posizione di riproduzione esistente. In un’animazione guidata dallo scorrimento, durata auto e un numero finito di iterazioni possono distribuire l’effetto sul suo intervallo di associazione.
L’esempio confronta una timeline anonima scroll(nearest block) con --track, definita sullo stesso contenitore di scorrimento. Alla posizione 400 di un intervallo di 800px, entrambe mostrano opacità 0.5. Passare a none e a una timeline --missing inesistente dà l’opacità sottostante 0.2 con riempimento none. Un’animazione separata, in pausa sull’orologio del documento e campionata a 500ms di una durata di un secondo, dà 0.5. Non sono coinvolti accessi, richieste di rete o orologi esterni.
Il controllo finale mostra che una successiva proprietà abbreviata animation reimposta la timeline di scorrimento scelta ad auto. Colloca le dichiarazioni di timeline e intervallo dopo questa abbreviazione per conservarle. Verifica il comportamento reale nei browser di destinazione e fornisci contenuto statico quando una timeline non è disponibile. L’esempio verifica timeline di scorrimento denominate e anonime, oltre a un controllo con l’orologio del documento; non pretende di provare la geometria di view().
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(',')};
scroller.style.scrollTimeline='--track block';box.style.animationFillMode='none';
const named=box.cloneNode();named.style.animationTimeline='--track';space.append(named);
scroller.scrollTop=400;await frame();const halfway=[box,named].map(e=>Number(getComputedStyle(e).opacity).toFixed(2)).join(',');
box.style.animationTimeline='none';named.style.animationTimeline='--missing';await frame();const inactive=[box,named].map(e=>Number(getComputedStyle(e).opacity).toFixed(2)).join(',');
box.style.animation='fade 1s linear both paused';getComputedStyle(box).opacity;const time=box.getAnimations()[0];time.currentTime=500;const clock=Number(getComputedStyle(box).opacity).toFixed(2);
box.style.animationTimeline='scroll(nearest block)';const before=box.style.animationTimeline;box.style.animation='fade 2s linear';const after=getComputedStyle(box).animationTimeline;
console.log('halfwayAnonymousNamed='+halfway+'; inactiveNoneMissing='+inactive+'; clockAt500ms='+clock+'; reset='+before+' / '+after);Risultato
halfwayAnonymousNamed=0.50,0.50; inactiveNoneMissing=0.20,0.20; clockAt500ms=0.50; reset=scroll() / auto
Eseguito in Chromium 157.0.8103.51. Il browser serializza scroll(nearest block) come scroll(); gli argomenti omessi sono quelli predefiniti, non una configurazione persa.