Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

transition-delay — opóźnienie przejścia

Właściwość transition-delay określa przesunięcie czasowe początku przejścia CSS: wartość dodatnia opóźnia jego start, a ujemna pomija początek, o ile nie wyczerpuje całego czasu trwania przejścia.

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

Składnia

transition-delay: <time>#;

transition-delay przyjmuje czasy w s lub ms. Wartość początkowa to 0s; właściwość nie jest dziedziczona ani animowalna. Sama nie wywołuje zmiany stylu.

Wartość dodatnia opóźnia przejście, zachowując wartość początkową podczas oczekiwania. 0s rozpoczyna je natychmiast. Przy ujemnym opóźnieniu przejście zaczyna się od razu od dalszego punktu przebiegu, ale tylko wtedy, gdy suma czasu trwania i opóźnienia jest dodatnia. Przy transition-duration: 1s opóźnienie -250ms pomija pierwsze 250 ms. Jeśli wartość bezwzględna ujemnego opóźnienia jest równa czasowi trwania lub od niego większa, przejście się nie rozpoczyna.

Lista rozdzielona przecinkami odpowiada kolejności transition-property: brakujące pozycje są powtarzane, nadmiarowe ignorowane. W skrócie transition pierwszy czas oznacza długość, drugi opóźnienie. Nie myl oczekiwania z długością samej zmiany.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła