Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

transition-delay — scostamento dell’inizio della transizione

La proprietà transition-delay imposta lo scostamento temporale dell’inizio di una transizione CSS: i valori positivi introducono un’attesa, mentre quelli negativi saltano la parte iniziale se resta ancora una parte della transizione da eseguire.

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

Sintassi

transition-delay: <time>#;

transition-delay accetta tempi in s o ms. Il valore iniziale è 0s; la proprietà non è ereditata né animabile. Da sola non provoca un cambiamento di stile.

I valori positivi ritardano la transizione, mantenendo il valore iniziale durante l’attesa. Con 0s la transizione inizia subito. Con un ritardo negativo, la transizione inizia subito da un punto più avanzato, ma solo se la somma della durata e del ritardo è positiva. Con transition-duration: 1s, un ritardo di -250ms salta i primi 250 ms. Se il valore assoluto del ritardo negativo è pari o superiore alla durata, la transizione non inizia.

Le voci separate da virgole corrispondono all’ordine di transition-property: quelle mancanti vengono ripetute, quelle in eccesso ignorate. Nella forma abbreviata transition, il primo tempo indica la durata e il secondo il ritardo. Non confondere il tempo di attesa con la durata del cambiamento stesso.

Esempi

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

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti