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

CKTIS / CSS

animation-duration: a duração de um ciclo

Define quanto tempo uma animação temporal demora numa iteração, independentemente do atraso e das repetições.

Versão: CSS Modules

Sintaxe

animation-duration: 1s, 250ms;

animation-duration define a duração de uma iteração, não o tempo total de todas as repetições nem o atraso inicial. Usa um tempo não negativo com s ou ms; um tempo negativo ou um número não nulo sem unidade é inválido. Os valores separados por vírgulas correspondem às entradas de animation-name; uma lista de durações mais curta repete-se até abranger os nomes. Numa animação temporal normal, a duração multiplicada por animation-iteration-count dá a duração ativa, enquanto animation-delay é separado.

CSS Animations Level 2 define auto como valor inicial. Na linha temporal do documento, auto comporta-se como 0s; a apresentação do estilo resolvido compatível com regras anteriores pode mostrar 0s. Zero não significa ausência de animação: o seu intervalo ativo é instantâneo, os eventos de início e fim ainda podem ocorrer, e animation-fill-mode determina qualquer efeito visível anterior ou posterior. Numa linha temporal controlada pelo deslocamento, auto preenche o intervalo relevante considerando os restantes parâmetros temporais; o rascunho atual também trata aí um tempo explícito como auto. Isso não faz uma animação ligada ao deslocamento durar um número fixo de segundos reais.

O exemplo cria animações lineares de opacidade em pausa e consulta cada uma aos 500ms. Um ciclo de 1s dá 0.5 e um ciclo de 2s dá 0.25. Com preenchimento both e a direção normal predefinida, 0s e auto já expõem o valor final 1; as suas durações de iteração calculadas são zero. O navegador também rejeita -1s e o valor 1 sem unidade. São leituras reais de estilo calculado e parâmetros temporais, não uma contagem decrescente nem uma afirmação sobre a taxa de fotogramas.

Exemplos

const style=document.createElement('style');
style.textContent='@keyframes duration-demo{from{opacity:0}to{opacity:1}}';document.head.append(style);
const make=duration=>{const el=document.createElement('div');el.style.cssText='opacity:0.3;animation-name:duration-demo;animation-timing-function:linear;animation-fill-mode:both;animation-play-state:paused';el.style.animationDuration=duration;document.body.append(el);const animation=el.getAnimations()[0];animation.currentTime=500;return {el,animation}};
const rows=['1s','2s','0s','auto'].map(make);
console.log('opacity='+rows.map(({el})=>getComputedStyle(el).opacity).join(','));
console.log('duration='+rows.map(({animation})=>animation.effect.getComputedTiming().duration).join(','));
console.log('negative='+CSS.supports('animation-duration','-1s')+'; unitless='+CSS.supports('animation-duration','1')+'; auto='+CSS.supports('animation-duration','auto'));

Resultado

opacity=0.5,0.25,1,1
duration=1000,2000,0,0
negative=false; unitless=false; auto=true

Executado no Chromium 157.0.8103.51 na linha temporal do documento. O exemplo verifica a duração temporal e auto, não a temporização por deslocamento nem a entrega de eventos. A explicação do deslocamento segue o rascunho atual CSS Animations Level 2; testa essa função separadamente nos navegadores de destino.

Fontes