Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

transition-delay — desfase de inicio de la transición

La propiedad transition-delay establece el desfase temporal del inicio de una transición CSS: los valores positivos introducen una espera y los negativos omiten el comienzo si aún queda parte de la transición por ejecutar.

Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxis

transition-delay: <time>#;

transition-delay acepta tiempos en s o ms. Su valor inicial es 0s; no se hereda ni es animable. Por sí sola, no provoca ningún cambio de estilo.

Los valores positivos retrasan la transición y mantienen el valor inicial durante la espera. Con 0s, empieza inmediatamente. Con un retraso negativo, la transición empieza de inmediato desde un punto más avanzado, pero solo si la suma de la duración y el retraso es positiva. Con transition-duration: 1s, un retraso de -250ms omite los primeros 250 ms. Si el valor absoluto del retraso negativo es igual o superior a la duración, la transición no se inicia.

Las entradas separadas por comas corresponden al orden de transition-property: las entradas que faltan se repiten y las sobrantes se ignoran. En la forma abreviada transition, el primer tiempo indica la duración y el segundo, el retraso. No confundas el tiempo de espera con la duración del cambio en sí.

Ejemplos

<!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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes