CKTIS / CSS
animation-range-end: den abschließenden Bindungspunkt festlegen
Wähle, wo die ausgewählte Animation das Ende ihres gebundenen Bereichs erreicht, und halte ihren Anfang unabhängig davon.
Version: CSS Modules
Syntax
animation-range-end: normal | <length-percentage> | <timeline-range-name> <length-percentage>?;animation-range-end legt das Ende des Bindungsbereichs einer Animation fest. normal verwendet das Ende der zugehörigen Zeitleiste. Eine reine Prozent- oder Längenangabe misst vom Anfang der Zeitleiste aus, nicht rückwärts von ihrem Ende und nicht ab animation-range-start. Bei einem benannten Sichtbarkeitsbereich wie exit 80% bezieht sich der Versatz auf diesen Bereich; ein Name allein bezeichnet standardmäßig dessen Punkt 100%. Eine Sekundenangabe ist kein gültiger Bereichsendpunkt.
Für eine einzelne Iteration mit Dauer auto drängt ein festgelegter früherer Endpunkt die Animation auf einen kürzeren Teil der Scrollstrecke zusammen. Er verändert weder den Keyframe 100%, noch verhindert er das Scrollen der Seite oder entfernt das Element. Was nach dem Intervall sichtbar bleibt, hängt von animation-fill-mode ab. Lege das Ende nach dem vorgesehenen Anfang fest; umgekehrte oder zusammenfallende Bindungspunkte fordern keine rückwärts laufende Animation an.
Das Beispiel belässt den Anfang auf normal bei einer Scrollstrecke von 800px. Mit Ende 50% beträgt die Deckkraft an den Positionen 0,200,400,800 genau 0,0.5,1,1. Ein Ende von 200px liefert stattdessen 0,0.5,1,1 an den Positionen 0,100,200,400. Nach dem Zurücksetzen auf normal ergibt Position 400 den Wert 0.5. Das sind tatsächliche Stilabfragen mit linearem Easing und Füllung both; dieselbe Ergebnisfolge beschreibt unterschiedliche räumliche Intervalle.
Die Eigenschaft kann eine durch Kommas getrennte Liste enthalten, die den Animationsnamen zugeordnet wird. Die Kurzschreibweise animation setzt die Bereichseigenschaften zurück; platziere diese Deklaration deshalb danach. Halte für Browser ohne scrollgesteuerte Animationen eine statische Alternative bereit. Das Beispiel untersucht eine Scrollfortschritts-Zeitleiste; benannte Sichtbarkeitsbereiche werden separat erläutert und hier nicht als geometrisch geprüft dargestellt.
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.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'));Ergebnis
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
Ausgeführt in Chromium 157.0.8103.51 nach zwei Renderframes je Scrolländerung. Prozentangaben beziehen sich auf die scrollbare Strecke, nicht auf die gesamte Inhaltshöhe von 1000px oder die sichtbare Höhe von 200px.