CKTIS / CSS
animation-timeline: die Quelle des Animationsfortschritts wählen
Unterscheide Dokumentzeit, Scrollfortschritt und Sichtbarkeit des Elements bei der Auswahl einer Animationszeitleiste.
Version: CSS Modules
Syntax
animation-timeline: auto | none | <dashed-ident> | scroll() | view();animation-timeline wählt die Fortschrittsquelle jeder CSS-Animation. auto verwendet die Dokumentzeitleiste, none weist keine Zeitleiste zu, und ein Bezeichner mit Bindestrichen wie --track verweist auf eine benannte Scroll- oder Sichtbarkeits-Zeitleiste im Gültigkeitsbereich. scroll() folgt dem Scrollen im gewählten Container und entlang der gewählten Achse; view() folgt dem Durchlaufen des sichtbaren Scrollbereichs durch ein Element. Ein Keyframe-Name definiert keine gleichnamige Zeitleiste. Mehrere durch Kommas getrennte Werte entsprechen der Liste animation-name.
Eine fehlende benannte Zeitleiste führt nicht stillschweigend zur Dokumentuhr zurück. Eine Scroll-Zeitleiste benötigt außerdem eine gültige Scrollquelle mit scrollbar überlaufendem Inhalt auf der gewählten Achse. none ist nicht dasselbe wie animation-play-state: paused: Keine Zeitleiste zuzuordnen unterscheidet sich davon, eine vorhandene Abspielposition zu erhalten und zu pausieren. Bei einer scrollgesteuerten Animation können Dauer auto und eine endliche Iterationszahl den Effekt über seinen Bindungsbereich verteilen.
Das Beispiel vergleicht eine anonyme Zeitleiste scroll(nearest block) mit --track, die auf demselben Scrollcontainer definiert ist. An Position 400 innerhalb einer Strecke von 800px zeigen beide die Deckkraft 0.5. Der Wechsel zu none beziehungsweise einer fehlenden Zeitleiste --missing ergibt bei Füllung none die zugrunde liegende Deckkraft 0.2. Eine separate pausierte Animation auf der Dokumentuhr, abgefragt bei 500ms einer einsekündigen Dauer, ergibt 0.5. Es werden weder Anmeldung noch Netzwerkanfrage oder externe Uhr benötigt.
Die letzte Prüfung zeigt, dass eine spätere Kurzschreibweise animation die ausgewählte Scroll-Zeitleiste auf auto zurücksetzt. Platziere Zeitleisten- und Bereichsdeklarationen nach dieser Kurzschreibweise, um sie zu erhalten. Prüfe das tatsächliche Verhalten in den Zielbrowsern und biete statische Inhalte, wenn eine Zeitleiste nicht verfügbar ist. Das Beispiel überprüft benannte und anonyme Scroll-Zeitleisten sowie eine Kontrolle mit Dokumentuhr; es behauptet nicht, die Geometrie von view() zu prüfen.
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(',')};
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);Ergebnis
halfwayAnonymousNamed=0.50,0.50; inactiveNoneMissing=0.20,0.20; clockAt500ms=0.50; reset=scroll() / auto
Ausgeführt in Chromium 157.0.8103.51. Der Browser serialisiert scroll(nearest block) als scroll(); die weggelassenen Argumente sind Standardwerte, keine verlorene Konfiguration.