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

CKTIS / CSS

steps() : progression discrète et positions de saut explicites

Maintenez la progression sur des paliers et choisissez un saut au début ou à la fin des intervalles.

Version : CSS Modules

Syntaxe

animation-timing-function: steps(4, jump-end);

La fonction d’évolution steps() divise la progression d’entrée en intervalles réguliers et garde la sortie constante dans chaque intervalle. Le premier argument est un entier positif. La position facultative vaut par défaut end, équivalent de jump-end ; start et jump-start choisissent un saut initial. C’est une fonction temporelle, pas une demande de fréquence d’images ni un nombre de répétitions.

jump-none exclut les sauts aux deux limites extérieures et exige au moins deux pas. jump-both inclut un saut à chaque limite extérieure ; ses paliers progressent de 1/(n+1). Pour quatre pas, none progresse par tiers et both par cinquièmes. Le comportement aux limites dépend aussi de la phase d’animation. L’exemple fixe une lecture normale vers l’avant et une seule itération, sans prétendre tester le sens inverse ni la phase précédant l’activité.

L’animation du navigateur, mise en pause, est échantillonnée à 0,249,250,500,999 et 1000 millisecondes sur une durée de 1000ms. La variante end donne 0,0,0.25,0.5,0.75,1 ; start commence à 0.25. Les lignes none et both révèlent leurs hauteurs de palier différentes, et l’échantillon à exactement 250ms est déjà sur le palier suivant. Zéro pas et un seul pas avec none sont rejetés ; deux pas avec none et la position par défaut sont acceptés syntaxiquement.

Exemples

const box = document.createElement('div');
document.body.append(box);
for (const position of ['jump-end','jump-start','jump-none','jump-both']) {
  const animation = box.animate([{opacity:0},{opacity:1}], {
    duration:1000, fill:'both', easing:'steps(4,' + position + ')'
  });
  animation.pause();
  const values = [0,249,250,500,999,1000].map(time => {
    animation.currentTime = time;
    return Number(animation.effect.getComputedTiming().progress.toFixed(6));
  });
  console.log(position + ':', values.join(','));
  animation.cancel();
}
for (const value of ['steps(0)','steps(1,jump-none)','steps(2,jump-none)','steps(4)']) {
  console.log(value + ':', CSS.supports('animation-timing-function',value));
}
box.remove();

Résultat

jump-end: 0,0,0.25,0.5,0.75,1
jump-start: 0.25,0.25,0.5,0.75,1,1
jump-none: 0,0,0.333333,0.666667,1,1
jump-both: 0.2,0.2,0.4,0.6,0.8,1
steps(0): false
steps(1,jump-none): false
steps(2,jump-none): true
steps(4): true

Ces valeurs viennent du modèle temporel Web Animations avec currentTime explicite, pas d’attentes ou de comptages d’images. Les interfaces animées doivent toujours respecter la réduction des mouvements et proposer un état utilisable sans animation.

Sources