Animações CSS para HyperFrames
O HyperFrames pode buscar animações CSS keyframe por meio de seu adaptador de runtime css. Use isso para motivos repetidos simples, movimento de fundo, shimmer, brilho, máscaras e decoração não sequenciada.
Para coreografia de cena, o GSAP geralmente é mais claro. As animações CSS funcionam melhor quando o movimento pertence a um único elemento e tem uma duração fixa.
Contrato
- Coloque o elemento animado no DOM antes da inicialização do runtime terminar.
- Dê aos elementos temporizados um valor
data-startpara que o tempo da animação local corresponda ao clipe. - Use
animation-durationeanimation-iteration-countfinitos porque a alternativa de delay negativo não pode representar duração ilimitada em ambientes sem animações CSS com suporte a WAAPI. - Prefira
animation-fill-mode: bothpara que os estados buscados sejam mantidos antes e depois do movimento ativo. - Evite JavaScript baseado em relógio de parede, estado acionado por hover e alternâncias de classe que dependem de eventos do usuário.
O adaptador descobre elementos com animation-name computada, busca seus handles Animation do navegador quando disponíveis e recorre à pausa com animation-delay negativo.
Padrão Básico
<div
id="pulse-ring"
class="clip pulse-ring"
data-start="0"
data-duration="4"
data-track-index="2"
></div>
<style>
.pulse-ring {
width: 280px;
height: 280px;
border: 4px solid rgba(255, 255, 255, 0.7);
border-radius: 50%;
animation-name: pulse-ring;
animation-duration: 1200ms;
animation-timing-function: cubic-bezier(0.2, 0, 0, 1);
animation-iteration-count: 3;
animation-fill-mode: both;
}
@keyframes pulse-ring {
from {
opacity: 0;
transform: scale(0.82);
}
35% {
opacity: 1;
}
to {
opacity: 0;
transform: scale(1.18);
}
}
</style>
Padrão Stagger (Escalonamento)
Use propriedades personalizadas CSS para evitar duplicar keyframes:
<div class="clip dots" data-start="1" data-duration="3" data-track-index="3">
<span style="--i: 0"></span>
<span style="--i: 1"></span>
<span style="--i: 2"></span>
</div>
<style>
.dots span {
display: inline-block;
width: 18px;
height: 18px;
margin-right: 10px;
border-radius: 50%;
background: currentColor;
animation: dot-pop 900ms ease-out both;
animation-delay: calc(var(--i) * 120ms);
}
@keyframes dot-pop {
from {
opacity: 0;
transform: translateY(18px) scale(0.75);
}
to {
opacity: 1;
transform: translateY(0) scale(1);
}
}
</style>
Bons Usos
- Loops decorativos com um número conhecido de repetições.
- Máscara, brilho, shimmer, granulação e camadas de paralaxe sutis.
- Entradas simples de um único elemento onde uma timeline JavaScript completa seria excessiva.
Evite
- Animações CSS infinitas a menos que você tenha verificado que o navegador expõe handles de animação CSS buscáveis com suporte a WAAPI. Prefira um número finito de iterações cobrindo a duração visível.
- Animar propriedades de layout como
top,left,widthouheightquando transformações funcionam. - Depender de hover, foco, rolagem ou media queries para acionar movimento crítico para renderização.
- Alterar classes de animação após a inicialização, a menos que outra timeline determinística controle essa mudança.
Validação
Após editar composições de animação CSS:
npx hyperframes lint
npx hyperframes validate
Créditos e Referências
- Código fonte do adaptador HyperFrames:
packages/core/src/runtime/adapters/css.ts. - Documentação de animação CSS do MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_animations
- MDN
animation-fill-mode: https://developer.mozilla.org/en-US/docs/Web/CSS/animation-fill-mode