Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

transition-delay — décalage de début de transition

La propriété transition-delay définit le décalage temporel du début d’une transition CSS : une valeur positive crée une attente, tandis qu’une valeur négative fait sauter le début s’il reste une partie de la transition à jouer.

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

Syntaxe

transition-delay: <time>#;

transition-delay accepte des durées en s ou en ms. Sa valeur initiale est 0s ; elle n’est ni héritée ni animable. Elle ne déclenche pas elle-même de changement de style.

Les valeurs positives retardent la transition et conservent la valeur de départ pendant l’attente. Avec 0s, elle commence immédiatement. Avec un délai négatif, la transition commence immédiatement à un point plus avancé, mais seulement si la somme de la durée et du délai est positive. Avec transition-duration: 1s, un délai de -250ms fait sauter les 250 premières millisecondes. Si la valeur absolue du délai négatif est supérieure ou égale à la durée, aucune transition ne démarre.

Les valeurs séparées par des virgules correspondent à l’ordre de transition-property : les valeurs manquantes sont répétées et les valeurs en trop sont ignorées. Dans la forme abrégée transition, la première durée indique la durée de transition et la seconde, le délai. Ne confondez pas le temps d’attente avec la durée du changement lui-même.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources