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

CKTIS / CSS

@keyframes — fotogramas de uma animação CSS

A regra @keyframes nomeia valores de propriedades em posições escolhidas no progresso de uma animação CSS.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

@keyframes <keyframes-name> {
  <qualified-rule-list>
}

@keyframes <name> { <keyframe-block-list> } contém blocos selecionados por from, to ou percentagens. from equivale a 0% e to a 100%. As declarações indicam valores nesse ponto; o navegador interpola segundo o tipo de animação e a função temporal. animation-name liga a definição a um elemento.

Omitir 0% ou 100% não cancela a animação: o valor subjacente fornece a extremidade em falta. Pontos repetidos combinam declarações pela cascata dentro da regra. Várias regras @keyframes com o mesmo nome não se fundem; vale a última aplicável. !important num fotograma é ignorado.

Nem todos os pares interpolam numericamente; propriedades discretas mudam de estado. Uma função temporal num fotograma controla o segmento iniciado nele. O exemplo pausa a meio com atraso negativo e confirma pela Web Animations API nome, estado e opacidade calculada 0.6.

Exemplos

const style = document.createElement('style');
style.textContent = `@keyframes fade { from { opacity: 0.2; } 50% { opacity: 0.6; } to { opacity: 1; } }
.probe { animation: fade 1000ms linear -500ms both paused; }`;
document.head.append(style);
const probe = document.createElement('div');
probe.className = 'probe';
probe.textContent = 'CKTIS';
document.body.append(probe);
await new Promise(requestAnimationFrame);
const animation = probe.getAnimations()[0];
console.log('name=' + animation.animationName + '; play=' + animation.playState + '; opacity=' + getComputedStyle(probe).opacity);

Resultado

name=fade; play=paused; opacity=0.6

A regra @keyframes nomeia valores de propriedades em posições escolhidas no progresso de uma animação CSS.

Fontes