CKTIS / CSS
animation-range: einen Abschnitt der Scroll-Zeitleiste wählen
Ordne dieselben Keyframes einem ausgewählten Scrollabschnitt zu, statt eine Verzögerung in Sekunden hinzuzufügen.
Version: CSS Modules
Syntax
animation-range: normal | <start> <end>?; /* comma-separated per animation */animation-range ist die Kurzschreibweise für animation-range-start und animation-range-end. Sie legt fest, wo eine Animation an ihre Zeitleiste gebunden ist, nicht die Scrollgrenzen des Elements. Bei einer scrollgesteuerten Animation beziehen sich Prozentangaben ohne benannten Bereich auf die gesamte Zeitleiste. Werte wie entry oder exit bezeichnen dagegen benannte Abschnitte einer Sichtbarkeits-Zeitleiste; sie sind keine Selektoren für Scrollcontainer. Mehrere durch Kommas getrennte Bereiche entsprechen der Liste animation-name.
Im Beispiel enthält ein 200px hoher sichtbarer Bereich Inhalte mit 1000px Höhe; die scrollbare Strecke beträgt also 800px. Der Bereich 25% 75% bindet eine einzelne lineare Überblendung an die Positionen 200px bis 600px. Messungen bei 0,200,400,600,800 ergeben die Deckkraft 0,0,0.5,1,1. Zurückscrollen auf 400 stellt 0.5 wieder her: Scrollen steuert den Fortschritt in beide Richtungen. animation-fill-mode: both erhält außerhalb dieses Intervalls die Endpunktwerte; der Bereich allein fordert dieses Verhalten nicht an.
Das Weglassen des Endes hat zwei unterschiedliche Bedeutungen. Ein einzelnes 25% setzt den Anfang auf 25% und das Ende auf normal zurück. Ein einzelnes entry verwendet Anfang und Ende des Bereichs entry; beide Einzelwerte können einfach als entry serialisiert werden, obwohl ihre Standardversätze unterschiedlich sind. Das Beispiel prüft diese geparsten Einzelwerte, misst aber nicht die Eintrittsgeometrie einer Sichtbarkeits-Zeitleiste. Ein Sekundenpaar wie 2s 4s wird abgelehnt.
Schreibe animation-timeline und animation-range nach der Kurzschreibweise animation, weil diese sie zurücksetzt. Biete eine brauchbare statische Alternative und teste die Zielbrowser: Hier geht es um scrollgesteuerte Animationen, nicht um einen portablen Ersatz für animation-delay auf einer Dokumentzeitleiste. Das Beispiel misst die tatsächliche Deckkraft nach dem Rendern von Frames, ohne Netzwerkressourcen oder Nutzerdaten.
Beispiele
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'));Ergebnis
scroll-range=800; opacity=0.00,0.00,0.50,1.00,1.00,0.50; entry=entry / entry; lone=25% / normal; seconds=false
Ausgeführt in Chromium 157.0.8103.51. Die Überblendung nutzt Dauer auto, eine Iteration und lineares Easing; andere Iterations-, Easing- oder Fülleinstellungen verändern das sichtbare Ergebnis.