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

CKTIS / CSS

transition-delay — desfasamento do início da transição

A propriedade transition-delay define o desfasamento temporal do início de uma transição CSS: os valores positivos introduzem uma espera e os negativos saltam a parte inicial se ainda restar parte da transição.

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

Sintaxe

transition-delay: <time>#;

transition-delay aceita tempos em s ou ms. O valor inicial é 0s; a propriedade não é herdada nem é animável. Por si só, não provoca uma alteração de estilo.

Os valores positivos atrasam a transição e mantêm o valor inicial durante a espera. Com 0s, começa imediatamente. Com um atraso negativo, a transição começa de imediato num ponto mais avançado, mas apenas se a soma da duração com o atraso for positiva. Com transition-duration: 1s, um atraso de -250ms salta os primeiros 250 ms. Se o valor absoluto do atraso negativo for igual ou superior à duração, a transição não se inicia.

As entradas separadas por vírgulas correspondem à ordem de transition-property: as entradas em falta são repetidas e as excedentárias são ignoradas. Na forma abreviada transition, o primeiro tempo indica a duração e o segundo, o atraso. Não confundas o tempo de espera com a duração da própria alteração.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Transition start delay</title>
  <style>
    .box {
      width: 60px;
      height: 60px;
      margin-block-start: 12px;
      background: navy;
      transform: translateX(0px);
      transition-property: transform;
      transition-duration: 1s;
      transition-timing-function: linear;
      transition-delay: 500ms;
    }
    #move:checked ~ .box { transform: translateX(120px); }
  </style>
</head>
<body>
  <input id="move" type="checkbox">
  <label for="move">Move the square</label>
  <div class="box" aria-hidden="true"></div>
  <script>
    const move = document.getElementById('move');
    const box = document.querySelector('.box');
    const style = getComputedStyle(box);
    console.log(`Computed delay: ${style.transitionDelay}`);
    // Commit the starting transform before changing the checked state.
    const horizontalOffset = () => Math.round(new DOMMatrixReadOnly(style.transform).m41);
    console.log(`Before checking: ${horizontalOffset()}px`);
    move.checked = true;
    const [motion] = box.getAnimations();
    motion.pause();
    for (const time of [250, 1000, 1500]) {
      motion.currentTime = time;
      console.log(`At ${time}ms: ${horizontalOffset()}px`);
    }
    // Finish the demonstration and leave the checkbox usable.
    motion.finish();
  </script>
</body>
</html>

Resultado

Computed delay: 0.5s
Before checking: 0px
At 250ms: 0px
At 1000ms: 60px
At 1500ms: 120px

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