KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

animation-range: kies een deel van de scrolltijdlijn

Koppel dezelfde keyframes aan een gekozen scrollinterval in plaats van een vertraging in seconden toe te voegen.

Versie: CSS Modules

Syntax

animation-range: normal | <start> <end>?; /* comma-separated per animation */

animation-range is de verkorte eigenschap voor animation-range-start en animation-range-end. Ze bepaalt waar een animatie aan haar tijdlijn is gekoppeld, niet de scrollgrenzen van het element. Bij een scrollgestuurde animatie verwijzen percentages zonder benoemd bereik naar de hele tijdlijn. Waarden als entry of exit verwijzen juist naar benoemde delen van een zichtbaarheidstijdlijn; het zijn geen selectors voor scrollcontainers. Meerdere door komma’s gescheiden bereiken horen bij de lijst animation-name.

In het voorbeeld bevat een zichtbaar gebied van 200px inhoud van 1000px hoog, zodat de scrollbare afstand 800px is. Het bereik 25% 75% koppelt één lineaire vervaging aan de posities van 200px tot 600px. Metingen bij 0,200,400,600,800 geven de dekking 0,0,0.5,1,1. Terugscrollen naar 400 herstelt 0.5: scrollen stuurt de voortgang in beide richtingen. animation-fill-mode: both bewaart buiten het interval de eindpuntwaarden; het bereik alleen vraagt niet om dat gedrag.

Het einde weglaten heeft twee verschillende betekenissen. Alleen 25% zet het begin op 25% en herstelt het einde naar normal. Alleen entry gebruikt het begin en einde van het bereik entry; de twee afzonderlijke eigenschappen kunnen eenvoudig als entry worden geserialiseerd, hoewel hun standaardverschuivingen verschillen. Het voorbeeld controleert deze geparste eigenschappen, maar meet niet de geometrie van het binnenkomen op een zichtbaarheidstijdlijn. Een paar seconden zoals 2s 4s wordt afgewezen.

Schrijf animation-timeline en animation-range na de verkorte eigenschap animation, want die zet ze terug. Bied een bruikbaar statisch alternatief en test de beoogde browsers: dit betreft scrollgestuurde animaties, geen overdraagbare vervanging van animation-delay op de documentklok. Het voorbeeld meet de werkelijke dekking na het renderen van frames, zonder netwerkbronnen of gebruikersgegevens.

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(',')};
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'));

Resultaat

scroll-range=800; opacity=0.00,0.00,0.50,1.00,1.00,0.50; entry=entry / entry; lone=25% / normal; seconds=false

Uitgevoerd in Chromium 157.0.8103.51. De vervaging gebruikt duur auto, één iteratie en lineaire easing; andere instellingen voor iteraties, easing of opvulling veranderen het zichtbare resultaat.

Bronnen