CKTIS / CSS
animation: configurar toda una animación con una declaración
Combina el nombre de los fotogramas clave con sus tiempos sin pasar por alto valores omitidos y reinicios.
Versión: CSS Modules
Sintaxis
animation: travel 1s linear 500ms 2 alternate both paused;La propiedad abreviada animation describe una o varias animaciones separadas por comas. Cada entrada aporta un nombre y ajustes de duración, progresión, retraso, repeticiones, dirección, relleno y reproducción. Define por separado los @keyframes referenciados. El primer tiempo es la duración y el segundo el retraso; una duración negativa no es válida, pero un retraso negativo sí. Una palabra clave ambigua se asigna primero a otro ajuste aplicable antes de interpretarse como nombre. Los nombres distintivos evitan sorpresas.
Las subpropiedades omitidas recuperan sus valores iniciales, en vez de conservar declaraciones anteriores. En el caso temporal habitual, omitir la duración significa cero segundos, por lo que no hay un recorrido visible gradual. Las propiedades individuales posteriores pueden sobrescribir la abreviatura. Los controles más nuevos de línea temporal y rango requieren comprobaciones propias de compatibilidad; escríbelos después de la abreviatura para evitar reinicios. La animación no se hereda y las preferencias de movimiento reducido siguen necesitando una alternativa adecuada.
El ejemplo define un movimiento lineal de un segundo, un retraso de 500ms, dos iteraciones alternas, relleno en ambos extremos y estado pausado. Los tiempos locales explícitos 0,1000,2000,2500ms producen los pares opacidad/traslación 0.20/0, 0.50/50, 0.50/50 y 0.20/0. El retraso y la segunda iteración invertida explican el punto medio repetido y el regreso final. Sustituir la declaración por el nombre a solas restablece a 0s una duración previa de cinco segundos, y también devuelve el retraso, la dirección, el relleno y el estado de reproducción a sus valores iniciales.
Ejemplos
const style=document.createElement('style');
style.textContent='@keyframes travel{from{opacity:.2;transform:translateX(0px)}to{opacity:.8;transform:translateX(100px)}}';document.head.append(style);
const box=document.createElement('div');box.style.animation='travel 1s linear 500ms 2 alternate both paused';document.body.append(box);
const animation=box.getAnimations()[0];
const samples=[0,1000,2000,2500].map(time=>{animation.currentTime=time;const s=getComputedStyle(box);return Number(s.opacity).toFixed(2)+','+new DOMMatrix(s.transform).m41});
const s=getComputedStyle(box);console.log('settings='+[s.animationName,s.animationDuration,s.animationDelay,s.animationIterationCount,s.animationDirection,s.animationPlayState].join('|'));
console.log('samples='+samples.join(' / '));
box.style.animationDuration='5s';box.style.animation='travel';
const reset=getComputedStyle(box);console.log('reset='+[reset.animationDuration,reset.animationDelay,reset.animationDirection,reset.animationFillMode,reset.animationPlayState].join('|'));Resultado
settings=travel|1s|0.5s|2|alternate|paused samples=0.20,0 / 0.50,50 / 0.50,50 / 0.20,0 reset=0s|0s|normal|none|running
El navegador evalúa fotogramas clave CSS reales. Fijar currentTime en la CSSAnimation permite muestrear de forma determinista; no se afirma haber medido esperas, frecuencia de fotogramas ni líneas temporales de desplazamiento.