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

CKTIS / CSS

animation-name: ligar um elemento a fotogramas-chave

Seleciona regras @keyframes com nome e coordena várias animações no mesmo elemento.

Versão: CSS Modules

Sintaxe

animation-name: Fade, lift;

animation-name seleciona a regra @keyframes de cada animação. Os nomes distinguem maiúsculas de minúsculas: Fade e fade são diferentes. Sem uma regra correspondente, não existe animação, mesmo com outras propriedades temporais definidas. A palavra-chave inicial none também significa ausência de animação; um nome existente continua a precisar de tempos adequados, pois um ciclo de duração zero não mostra uma mudança gradual normal. Um nome de fotogramas pode ser um identificador personalizado permitido ou uma cadeia entre aspas; none sem aspas continua a ser a palavra de desativação.

Usa vírgulas para várias animações. A lista de nomes determina o seu número, e listas mais curtas de durações ou outros parâmetros repetem-se para lhe corresponder; as animações funcionam em conjunto em vez de formarem automaticamente uma sequência. Na composição replace predefinida, quando dois efeitos animam a mesma propriedade, o que está depois na lista de nomes tem prioridade enquanto se aplica. Nomear uma animação não a torna herdada pelos elementos filhos. Remover o nome remove o efeito, incluindo qualquer preenchimento.

O exemplo define Fade, lift e dim. O nome incorreto fade produz zero objetos de animação; Fade aos 500ms dá opacidade 0.5. Fade, lift cria duas animações que partilham o único parâmetro de duração 1s, e lift desloca o elemento 50px. Fade, dim também cria dois objetos, mas dim fornece opacidade 0.3 no instante consultado. Alterar animation-name para none deixa zero animações e repõe a opacidade subjacente 0.3.

Exemplos

const style=document.createElement('style');style.textContent='@keyframes Fade{from{opacity:0}to{opacity:1}} @keyframes lift{from{transform:translateX(0)}to{transform:translateX(100px)}} @keyframes dim{from{opacity:0.2}to{opacity:0.4}}';document.head.append(style);
const el=document.createElement('div');el.style.cssText='opacity:0.3;animation-duration:1s;animation-timing-function:linear;animation-fill-mode:both;animation-play-state:paused';document.body.append(el);
const apply=names=>{el.style.animationName=names;const animations=el.getAnimations();for(const animation of animations)animation.currentTime=500;return animations};
const missing=apply('fade').length,matched=apply('Fade');const opacity=getComputedStyle(el).opacity;
const pair=apply('Fade, lift');const movement=new DOMMatrixReadOnly(getComputedStyle(el).transform).m41;
const conflict=apply('Fade, dim');const winner=getComputedStyle(el).opacity;
const none=apply('none').length;
console.log('missing='+missing+'; matched='+matched.length+'; opacity='+opacity);
console.log('names='+pair.map(animation=>animation.animationName).join(',')+'; duration='+pair.map(animation=>animation.effect.getComputedTiming().duration).join(',')+'; movement='+movement);
console.log('conflict='+winner+'; count='+conflict.length+'; none='+none+'; restored='+getComputedStyle(el).opacity);

Resultado

missing=0; matched=1; opacity=0.5
names=Fade,lift; duration=1000,1000; movement=50
conflict=0.3; count=2; none=0; restored=0.3

Executado no Chromium 157.0.8103.51. Objetos CSSAnimation reais e estilos calculados confirmam a correspondência de nomes, a repetição de parâmetros de lista e a substituição predefinida. O exemplo não testa composição aditiva, nomes entre aspas nem o âmbito dos nomes em árvores de sombra.

Fontes