KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

animation-fill-mode: het effect vóór en na de actieve fase

Kies of een animatie vóór de start, na afloop of in beide perioden stijlwaarden levert.

Versie: CSS Modules

Syntax

animation-fill-mode: both;

animation-fill-mode bepaalt het effect buiten de actieve fase, niet de interpolatie tijdens de animatie. De standaardwaarde none laat daar de onderliggende stijl zien. backwards past tijdens een positieve vertraging de beginwaarde toe; forwards behoudt na afloop de waarde aan het einde van het laatst afgespeelde deel. both combineert deze twee gedragingen. Een lijst met komma’s volgt animation-name; een kortere lijst wordt herhaald.

De begin- en eindwaarden zijn niet altijd simpelweg de keyframes bij 0% en 100%. animation-direction en een gebroken animation-iteration-count kunnen bepalen welk uiteinde of tussentijdstip zichtbaar blijft. Bij nul iteraties gebruikt forwards de waarde aan het begin van de eerste iteratie. Fill schrijft geen blijvende inline-stijl: als je de animatie verwijdert, verdwijnt ook het aangehouden effect. Een eindtoestand die zonder de animatie moet blijven bestaan, hoort daarom in de gewone stijl van de toepassing.

Het voorbeeld gebruikt een onderliggende opacity van 0.3, keyframes van 0.2 naar 0.8, een vertraging van 1s en een cyclus van 1s. Op 0ms tonen none en forwards 0.3, terwijl backwards en both 0.2 tonen. Op 1500ms tonen alle vier 0.5. Op 2500ms tonen none en backwards weer 0.3, en forwards en both 0.8. Met reverse en both zijn de waarden vóór en na de actieve fase respectievelijk 0.8 en 0.2. animation-name op none zetten herstelt de onderliggende waarde 0.3.

Voorbeelden

const style=document.createElement('style');
style.textContent='@keyframes fill-demo{from{opacity:0.2}to{opacity:0.8}}';document.head.append(style);
const make=(fill,direction='normal')=>{const el=document.createElement('div');el.style.cssText='opacity:0.3;animation-name:fill-demo;animation-duration:1s;animation-delay:1s;animation-timing-function:linear;animation-play-state:paused';el.style.animationFillMode=fill;el.style.animationDirection=direction;document.body.append(el);return {el,animation:el.getAnimations()[0]}};
const modes=['none','forwards','backwards','both'],rows=modes.map(mode=>make(mode));
const read=(row,time)=>{row.animation.currentTime=time;return Number(getComputedStyle(row.el).opacity).toFixed(1)};
for(const time of [0,1500,2500])console.log(time+'ms='+rows.map(row=>read(row,time)).join(','));
const reverse=make('both','reverse');console.log('reverse='+[0,2500].map(time=>read(reverse,time)).join(','));
rows[3].el.style.animationName='none';console.log('removed='+getComputedStyle(rows[3].el).opacity);

Resultaat

0ms=0.3,0.3,0.2,0.2
1500ms=0.5,0.5,0.5,0.5
2500ms=0.3,0.8,0.3,0.8
reverse=0.8,0.2
removed=0.3

Uitgevoerd in Chromium 157.0.8103.51. De test verplaatst de tijd van gepauzeerde animaties naar momenten vóór, tijdens en na de actieve fase en leest de berekende stijl. Hij leunt niet op de verstreken wandkloktijd en verandert de onderliggende stijl niet.

Bronnen