CKTIS / CSS
transition-delay — desfasamento do início da transição
A propriedade transition-delay define o desfasamento temporal do início de uma transição CSS: os valores positivos introduzem uma espera e os negativos saltam a parte inicial se ainda restar parte da transição.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
transition-delay: <time>#;transition-delay aceita tempos em s ou ms. O valor inicial é 0s; a propriedade não é herdada nem é animável. Por si só, não provoca uma alteração de estilo.
Os valores positivos atrasam a transição e mantêm o valor inicial durante a espera. Com 0s, começa imediatamente. Com um atraso negativo, a transição começa de imediato num ponto mais avançado, mas apenas se a soma da duração com o atraso for positiva. Com transition-duration: 1s, um atraso de -250ms salta os primeiros 250 ms. Se o valor absoluto do atraso negativo for igual ou superior à duração, a transição não se inicia.
As entradas separadas por vírgulas correspondem à ordem de transition-property: as entradas em falta são repetidas e as excedentárias são ignoradas. Na forma abreviada transition, o primeiro tempo indica a duração e o segundo, o atraso. Não confundas o tempo de espera com a duração da própria alteração.
Exemplos
<!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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.