WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

transition-delay — Startversatz eines Übergangs

Die Eigenschaft transition-delay legt den zeitlichen Startversatz eines CSS-Übergangs fest: Positive Werte bewirken eine Wartezeit, negative überspringen den Anfang, sofern danach noch ein Teil des Übergangs übrig bleibt.

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

Syntax

transition-delay: <time>#;

transition-delay akzeptiert Zeitangaben in s oder ms. Der Anfangswert ist 0s; die Eigenschaft wird weder vererbt noch ist sie animierbar. Sie löst selbst keine Stiländerung aus.

Positive Werte verzögern den Übergang; während der Wartezeit bleibt der Ausgangswert erhalten. Bei 0s beginnt er sofort. Bei einer negativen Verzögerung beginnt der Übergang sofort an einem späteren Punkt seines Verlaufs, aber nur, wenn die Summe aus Dauer und Verzögerung positiv ist. Bei transition-duration: 1s überspringt eine Verzögerung von -250ms die ersten 250 ms. Ist der Betrag der negativen Verzögerung gleich der Dauer oder größer, startet kein Übergang.

Durch Kommas getrennte Einträge entsprechen der Reihenfolge von transition-property: Fehlende Einträge werden wiederholt, überzählige ignoriert. In der Kurzschreibweise transition steht die erste Zeitangabe für die Dauer, die zweite für die Verzögerung. Verwechsle die Wartezeit nicht mit der Dauer der Änderung selbst.

Beispiele

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

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen