Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

animation-fill-mode : les valeurs hors de l’intervalle actif

Choisissez si les valeurs de l’animation s’appliquent pendant son délai, après sa fin ou pendant les deux périodes.

Version : CSS Modules

Syntaxe

animation-fill-mode: both;

animation-fill-mode contrôle l’effet hors de l’intervalle actif ; il ne change pas l’interpolation pendant l’exécution. La valeur initiale none laisse les styles sous-jacents agir avant et après. backwards applique l’image clé de départ pendant un animation-delay positif, forwards conserve la valeur à la fin de la dernière portion jouée, et both combine les deux. Dans une liste séparée par des virgules, chaque valeur correspond à un animation-name ; les listes plus courtes se répètent.

Début et fin ne désignent pas toujours les images clés écrites à 0% et 100%. animation-direction change le côté de départ, et animation-iteration-count peut terminer un cycle inversé ou une fraction de cycle. Avec un nombre d’itérations nul, forwards utilise la valeur qui commencerait la première itération. Le remplissage n’écrit pas une déclaration permanente dans l’élément : retirer l’animation retire aussi son effet de remplissage. Utilisez un style ordinaire pour un état final qui doit subsister indépendamment.

L’exemple utilise une opacité sous-jacente de 0.3, des images clés de 0.2 à 0.8, un délai de 1s et un cycle linéaire de 1s. À 0ms, none/forwards montrent 0.3 et backwards/both montrent 0.2. À 1500ms, les quatre donnent 0.5. À 2500ms, none/backwards reviennent à 0.3 tandis que forwards/both montrent 0.8. Inverser une animation remplie avec both change ses valeurs avant/après en 0.8 et 0.2. Passer animation-name à none rétablit 0.3.

Exemples

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);

Résultat

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

Exécuté dans Chromium 157.0.8103.51. Le test place des animations CSS en pause à des instants précis avant, pendant et après l’intervalle actif, puis lit l’opacité réelle. Il ne mesure pas l’ordonnancement en temps réel et n’affirme pas que le remplissage modifie le style sous-jacent de l’élément.

Sources