CKTIS / CSS
animation-timeline: kies wat de animatie aanstuurt
Houd documenttijd, scrollvoortgang en zichtbaarheid van het element uit elkaar bij het kiezen van een animatietijdlijn.
Versie: CSS Modules
Syntax
animation-timeline: auto | none | <dashed-ident> | scroll() | view();animation-timeline kiest de voortgangsbron voor elke CSS-animatie. auto gebruikt de documenttijdlijn, none koppelt geen tijdlijn en een identificatie met streepjes zoals --track verwijst naar een benoemde scroll- of zichtbaarheidstijdlijn binnen het bereik. scroll() volgt het scrollen van de gekozen container en as; view() volgt hoe een element door het zichtbare scrollgebied beweegt. Een keyframenaam definieert geen tijdlijn met dezelfde naam. Meerdere door komma’s gescheiden waarden horen bij de lijst animation-name.
Een ontbrekende benoemde tijdlijn valt niet stilzwijgend terug op de documentklok. Een scrolltijdlijn heeft ook een geldige scrollbron nodig met scrollbare overloop op de gekozen as. none is niet hetzelfde als animation-play-state: paused: geen tijdlijn kiezen verschilt van het bewaren en pauzeren van een bestaande afspeelpositie. Bij een scrollgestuurde animatie kunnen duur auto en een eindig aantal iteraties het effect over het koppelingsbereik verdelen.
Het voorbeeld vergelijkt een anonieme tijdlijn scroll(nearest block) met --track, gedefinieerd op dezelfde scrollcontainer. Bij positie 400 binnen een bereik van 800px tonen beide een dekking van 0.5. Omschakelen naar none en een ontbrekende tijdlijn --missing geeft met opvulling none de onderliggende dekking 0.2. Een afzonderlijke gepauzeerde animatie op de documentklok, gemeten op 500ms van een duur van één seconde, geeft 0.5. Er komt geen aanmelding, netwerkverzoek of externe klok aan te pas.
De laatste controle laat zien dat een latere verkorte eigenschap animation de gekozen scrolltijdlijn terugzet op auto. Plaats tijdlijn- en bereiksdeclaraties na die verkorte eigenschap om ze te behouden. Test het werkelijke gedrag in de beoogde browsers en bied statische inhoud wanneer een tijdlijn niet beschikbaar is. Het voorbeeld controleert benoemde en anonieme scrolltijdlijnen plus een controle met de documentklok; het claimt niet de geometrie van view() te testen.
Voorbeelden
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);Resultaat
halfwayAnonymousNamed=0.50,0.50; inactiveNoneMissing=0.20,0.20; clockAt500ms=0.50; reset=scroll() / auto
Uitgevoerd in Chromium 157.0.8103.51. De browser serialiseert scroll(nearest block) als scroll(); de weggelaten argumenten zijn standaardwaarden, geen verloren configuratie.