Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

animation-delay: esperar antes do início ou começar a meio

Use tempos positivos e negativos, distinguindo atraso, duração e comportamento de preenchimento.

Versão: CSS Modules

Sintaxe

animation-delay: 500ms, -250ms;

Na sintaxe temporal estabelecida, animation-delay aceita uma lista de tempos separados por vírgulas, associados aos nomes das animações. O valor inicial é 0s. Um tempo positivo adia o intervalo ativo; um tempo negativo começa como se esse tempo já tivesse passado. Não altera a velocidade nem introduz uma pausa entre iterações. Um desvio negativo superior a uma duração ativa finita pode colocar imediatamente a animação depois da fase ativa.

O atraso não define, por si só, o que é visível fora do intervalo ativo. É animation-fill-mode que o decide: sem preenchimento aplicam-se os estilos normais; o preenchimento para trás usa o primeiro fotograma-chave relevante e o preenchimento para a frente mantém o último estado relevante. A direção influencia qual é o primeiro fotograma. Pausar uma animação também pausa o relógio do atraso. Estas regras descrevem o exemplo baseado no tempo do documento, não um comportamento garantido para todas as linhas temporais de deslocamento.

Para uma alteração de opacidade de 0.2 para 0.8 num segundo, sobre uma base de 0.4, um atraso de 500ms amostrado em 0,500,750,1500ms dá 0.40,0.20,0.35,0.40 sem preenchimento. O preenchimento nos dois extremos dá 0.20,0.20,0.35,0.80. Um atraso de -250ms amostrado em 0,250,750ms dá 0.35,0.50,0.80; -2s já está no valor final conservado 0.80.

O rascunho atual de Level 2 expande a propriedade para uma abreviatura de início/fim com animation-delay-start e animation-delay-end. É diferente de dois atrasos separados por vírgula para duas animações. O Chromium 157 rejeita ambas as novas propriedades individuais e o par separado por espaço na verificação. O comportamento funcional acima usa, por isso, o atraso único estabelecido por animação; não pressupõe suporte da sintaxe do rascunho.

Exemplos

const style=document.createElement('style');style.textContent='@keyframes fade{from{opacity:.2}to{opacity:.8}}';document.head.append(style);
const sample=(delay,fill,times)=>{const box=document.createElement('div');box.style.cssText='opacity:.4;animation:fade 1s linear 1 normal paused';box.style.animationDelay=delay;box.style.animationFillMode=fill;document.body.append(box);const animation=box.getAnimations()[0];return times.map(time=>{animation.currentTime=time;return Number(getComputedStyle(box).opacity).toFixed(2)}).join(',')};
console.log('positive-none='+sample('500ms','none',[0,500,750,1500]));
console.log('positive-both='+sample('500ms','both',[0,500,750,1500]));
console.log('negative='+sample('-250ms','both',[0,250,750]));
console.log('after-active='+sample('-2s','both',[0])+'; draft-pair='+CSS.supports('animation-delay','1s 2s')+'; start-property='+CSS.supports('animation-delay-start','1s')+'; end-property='+CSS.supports('animation-delay-end','2s'));

Resultado

positive-none=0.40,0.20,0.35,0.40
positive-both=0.20,0.20,0.35,0.80
negative=0.35,0.50,0.80
after-active=0.80; draft-pair=false; start-property=false; end-property=false

Os fotogramas-chave CSS são amostrados com valores currentTime explícitos, sem esperar em tempo real. As verificações adicionais dizem respeito apenas à análise da sintaxe do rascunho; não demonstram um atraso final implementado.

Fontes