CKTIS / CSS
animation: configurar toda a animação numa declaração
Combine um nome de fotogramas-chave com os tempos, sem esquecer os valores omitidos e as reposições.
Versão: CSS Modules
Sintaxe
animation: travel 1s linear 500ms 2 alternate both paused;A propriedade abreviada animation descreve uma ou mais animações separadas por vírgulas. Cada entrada fornece um nome e definições de duração, progressão, atraso, repetições, direção, preenchimento e reprodução. Defina os @keyframes referidos em separado. O primeiro tempo é a duração e o segundo o atraso; uma duração negativa é inválida, mas um atraso negativo é permitido. Uma palavra-chave ambígua é atribuída primeiro a outra definição aplicável antes de ser considerada um nome. Nomes distintos evitam surpresas.
As subpropriedades omitidas regressam aos valores iniciais, em vez de preservarem declarações anteriores. No caso temporal habitual, omitir a duração significa zero segundos, sem uma progressão visível gradual. Propriedades individuais posteriores podem substituir a abreviatura. Os controlos mais recentes de linha temporal e intervalo exigem verificações próprias de compatibilidade; coloque as definições explícitas depois da abreviatura para evitar reposições. A animação não é herdada e as preferências de movimento reduzido continuam a exigir uma alternativa adequada.
O exemplo define um movimento linear de um segundo, atraso de 500ms, duas iterações alternadas, preenchimento nos dois extremos e estado em pausa. Os tempos locais explícitos 0,1000,2000,2500ms produzem pares opacidade/translação 0.20/0, 0.50/50, 0.50/50 e 0.20/0. O atraso e a segunda iteração invertida explicam o ponto intermédio repetido e o regresso final. Substituir a declaração apenas pelo nome repõe em 0s uma duração anterior de cinco segundos e devolve atraso, direção, preenchimento e reprodução aos valores iniciais.
Exemplos
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
O navegador avalia fotogramas-chave CSS reais. Definir currentTime na CSSAnimation torna a amostragem determinística; não se mede espera real, taxa de fotogramas nem comportamento de uma linha temporal de deslocamento.