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

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.

Fontes