Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

steps(): progressão discreta e posições explícitas dos saltos

Mantém o progresso da animação em patamares e escolhe saltos no início ou no fim do intervalo.

Versão: CSS Modules

Sintaxe

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

A função temporal steps() divide o progresso de entrada em intervalos iguais e mantém a saída constante dentro de cada um. O primeiro argumento é um inteiro positivo. A posição opcional é end por predefinição, equivalente a jump-end; start e jump-start escolhem um salto inicial. É uma função temporal, não um pedido de fotogramas por segundo nem um número de repetições.

jump-none exclui saltos nos dois limites exteriores e exige pelo menos dois passos. jump-both inclui um salto em cada limite exterior; os seus patamares crescem em 1/(n+1). Com quatro passos, none avança por terços e both por quintos. O comportamento nos limites depende também da fase da animação. O exemplo fixa a reprodução normal para a frente e uma iteração, sem afirmar que testa a direção inversa ou a fase anterior à ativa.

A animação pausada do navegador é amostrada em 0,249,250,500,999 e 1000 milissegundos de uma duração de 1000ms. A variante end dá 0,0,0.25,0.5,0.75,1; start começa em 0.25. As linhas none e both mostram alturas distintas dos patamares e, exatamente em 250ms, já se atinge o seguinte. Zero passos e um único passo com none são rejeitados; dois passos com none e a posição predefinida têm sintaxe válida.

Exemplos

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

Resultado

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

Os valores vêm do modelo temporal Web Animations com currentTime explícito, não de esperar ou contar fotogramas. Interfaces com muito movimento continuam a precisar de respeitar a redução de movimento e de oferecer um estado utilizável sem animação.

Fontes