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

CKTIS / CSS

animation-timing-function: dar forma à progressão entre fotogramas-chave

Altere a interpolação dos valores sem mudar a duração da animação nem iniciar uma nova.

Versão: CSS Modules

Sintaxe

animation-timing-function: <easing-function>#;

animation-timing-function converte a progressão entre fotogramas-chave em progressão de interpolação. O valor predefinido ease não é linear: linear mantém uma taxa de interpolação constante, enquanto ease, cubic-bezier() e steps() a alteram. linear() pode descrever uma curva linear por troços. Estas funções não selecionam a propriedade animada, não criam fotogramas-chave nem alteram animation-duration. Uma lista separada por vírgulas corresponde a animation-name; o sentido e as iterações continuam a ser definições separadas.

Uma função de progressão declarada dentro de um fotograma-chave controla o intervalo desse fotograma até ao seguinte para a propriedade animada em causa. Pode substituir nesse intervalo a função do elemento. Uma declaração no fotograma final 100% não tem um intervalo seguinte para controlar. Em cubic-bezier(), as coordenadas X dos pontos de controlo têm de estar entre 0 e 1; as coordenadas Y podem sair desse intervalo. Uma curva steps() cria deliberadamente saltos discretos em vez de um percurso suave.

O exemplo pausa animações CSS reais e define o seu currentTime para obter leituras reproduzíveis. Num movimento de 0 a 100px durante um segundo, 250ms dá 25.00px com linear, mas 40.85px com ease. steps(4,end) dá 0.00px em 240ms e 25.00px em 260ms. São posições de transformação medidas; alterar a curva não mudou a duração de um segundo.

Uma segunda animação coloca steps(2,end) em 0% e linear em 50%, substituindo ease-in do elemento. As leituras em 125,250,750ms são 0.00,25.00,75.00px. A declaração step-start em 100% não acrescenta um intervalo novo. O exemplo também rejeita uma curva de Bézier com X=2. Posições estáticas medidas com precisão não avaliam a fluidez dos fotogramas nem a acessibilidade do movimento; respeite as preferências de movimento reduzido numa interface real.

Exemplos

const style=document.createElement('style');style.textContent='@keyframes move{from{transform:translateX(0)}to{transform:translateX(100px)}} @keyframes segments{0%{transform:translateX(0);animation-timing-function:steps(2,end)}50%{transform:translateX(50px);animation-timing-function:linear}100%{transform:translateX(100px);animation-timing-function:step-start}}';document.head.append(style);
const sample=(name,easing,ms)=>{const box=document.createElement('div');box.style.animation=name+' 1s '+easing+' both paused';document.body.append(box);getComputedStyle(box).transform;box.getAnimations()[0].currentTime=ms;const x=new DOMMatrix(getComputedStyle(box).transform).m41;box.remove();return x.toFixed(2)};
const linear=sample('move','linear',250),ease=sample('move','ease',250),steps=sample('move','steps(4,end)',240),stepsAfter=sample('move','steps(4,end)',260);
const segments=[125,250,750].map(t=>sample('segments','ease-in',t)).join(',');
console.log('linear250='+linear+'; ease250='+ease+'; steps240and260='+steps+','+stepsAfter+'; segment125250750='+segments+'; badBezier='+CSS.supports('animation-timing-function','cubic-bezier(2,0,1,1)'));

Resultado

linear250=25.00; ease250=40.85; steps240and260=0.00,25.00; segment125250750=0.00,25.00,75.00; badBezier=false

Executado no Chromium 157.0.8103.51. A Web Animations API é usada apenas para pausar a animação CSS e definir o seu tempo; a função de progressão é definida em CSS, não substituída por um cálculo JavaScript.

Fontes