CKTIS / CSS
animation-duration: la duración de un ciclo
Define cuánto tarda una animación temporal en completar una iteración, independientemente del retardo y las repeticiones.
Versión: CSS Modules
Sintaxis
animation-duration: 1s, 250ms;animation-duration fija la duración de una iteración, no el tiempo total de todas las repeticiones ni el retardo inicial. Usa un tiempo no negativo con s o ms; un tiempo negativo o un número no nulo sin unidad es inválido. Los valores separados por comas corresponden a las entradas de animation-name; una lista de duraciones más corta se repite hasta cubrir los nombres. En una animación temporal normal, la duración multiplicada por animation-iteration-count da la duración activa, mientras que animation-delay es independiente.
CSS Animations Level 2 define auto como valor inicial. En la línea temporal del documento, auto se comporta como 0s; la presentación del estilo resuelto compatible con reglas anteriores puede mostrar 0s. Cero no significa que la animación no exista: su intervalo activo es instantáneo, aún pueden producirse eventos de inicio y fin, y animation-fill-mode determina cualquier efecto visible anterior o posterior. En una línea temporal controlada por desplazamiento, auto ocupa el intervalo correspondiente teniendo en cuenta los demás ajustes temporales; el borrador actual también trata allí un tiempo explícito como auto. Eso no hace que una animación vinculada al desplazamiento dure un número fijo de segundos reales.
El ejemplo crea animaciones lineales de opacidad pausadas y consulta cada una en 500ms. Un ciclo de 1s da 0.5 y uno de 2s da 0.25. Con relleno both y la dirección normal predeterminada, 0s y auto ya muestran el extremo final 1; sus duraciones calculadas de iteración son cero. El navegador también rechaza -1s y el valor 1 sin unidad. Son lecturas reales de estilo calculado y parámetros temporales, no una cuenta atrás ni una afirmación sobre la frecuencia de fotogramas.
Ejemplos
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
Ejecutado en Chromium 157.0.8103.51 en la línea temporal del documento. El ejemplo verifica la duración temporal y auto, no la temporización por desplazamiento ni la entrega de eventos. La explicación del desplazamiento sigue el borrador actual CSS Animations Level 2; prueba esa función por separado en los navegadores de destino.