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

CKTIS / CSS

transition-timing-function — ritmo da transição CSS

A propriedade transition-timing-function determina como o progresso do tempo decorrido corresponde ao progresso da alteração do valor durante uma transição CSS. Permite obter movimento uniforme, aceleração, desaceleração ou saltos sem alterar a duração declarada.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

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

transition-timing-function associa o progresso temporal de uma transição ao progresso da interpolação da propriedade que está a mudar. Não define a duração nem o atraso: essas funções cabem a transition-duration e transition-delay. Por si só, não inicia uma transição; tem de mudar o valor de uma propriedade abrangida pela transição.

O valor inicial é ease. A propriedade não é herdada nem é animável. A sintaxe <easing-function># significa uma ou mais funções, separadas por vírgulas. As funções correspondem às posições em transition-property; uma lista mais curta é repetida e os elementos excedentes não são utilizados.

linear proporciona um progresso uniforme, ease-in começa lentamente, ease-out abranda perto do fim e ease-in-out suaviza o início e o fim. cubic-bezier() define uma curva personalizada, enquanto steps() produz saltos. Não confundas a palavra-chave linear com a função linear(): esta última permite definir um progresso personalizado linear por segmentos.

O exemplo compara linear e ease-in com o mesmo deslocamento e uma duração de 2s. O script seleciona automaticamente a caixa de seleção Move both squares, apresenta na consola as posições dos dois quadrados aos 1000ms e aos 2000ms e, em seguida, termina ambas as transições. A caixa fica selecionada. Desmarca-a para veres os quadrados regressar à posição inicial e espera que o movimento termine antes de voltares a selecioná-la: inverter uma transição em curso pode encurtar o tempo de regresso.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Linear and ease-in transitions</title>
  <style>
    .track { width: 240px; background: #eee; }
    .box {
      width: 40px;
      height: 40px;
      background: #2457c5;
      transform: translateX(0px);
      transition-property: transform;
      transition-duration: 2s;
      transition-timing-function: linear;
    }
    .eased { transition-timing-function: ease-in; }
    #move:checked ~ .track .box { transform: translateX(200px); }
  </style>
</head>
<body>
  <input id="move" type="checkbox">
  <label for="move">Move both squares</label>
  <p>Linear</p>
  <div class="track" aria-hidden="true"><div class="box"></div></div>
  <p>Ease-in</p>
  <div class="track" aria-hidden="true"><div class="box eased"></div></div>
  <script>
    const move = document.getElementById('move');
    const boxes = [...document.querySelectorAll('.box')];
    const styles = boxes.map(box => getComputedStyle(box));
    function offsets() {
      return styles.map(style => Math.round(new DOMMatrixReadOnly(style.transform).m41));
    }
    console.log(`Timing functions: ${styles.map(style => style.transitionTimingFunction).join(', ')}`);
    console.log(`Before checking: ${offsets().join('px, ')}px`);
    move.checked = true;
    const motions = boxes.map(box => box.getAnimations()[0]);
    for (const motion of motions) motion.pause();
    for (const time of [1000, 2000]) {
      for (const motion of motions) motion.currentTime = time;
      console.log(`At ${time}ms: ${offsets().join('px, ')}px`);
    }
    for (const motion of motions) motion.finish();
  </script>
</body>
</html>

Resultado

Timing functions: linear, ease-in
Before checking: 0px, 0px
At 1000ms: 100px, 63px
At 2000ms: 200px, 200px

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes