Animaciones CSS para HyperFrames
HyperFrames puede buscar animaciones CSS con keyframes a través de su adaptador de tiempo de ejecución css. Úsalo para motivos repetidos simples, movimiento de fondo, brillo, resplandor, máscaras y decoración no secuenciada.
Para coreografía de escenas, GSAP suele ser más claro. Las animaciones CSS funcionan mejor cuando el movimiento pertenece a un solo elemento y tiene una duración fija.
Contrato
- Coloca el elemento animado en el DOM antes de que finalice la inicialización del tiempo de ejecución.
- Asigna a los elementos temporizados un valor
data-startpara que el tiempo de animación local coincida con el clip. - Usa
animation-durationyanimation-iteration-countfinitos porque la alternativa de retardo negativo no puede representar duración ilimitada en entornos sin animaciones CSS respaldadas por WAAPI. - Prefiere
animation-fill-mode: bothpara que los estados buscados se mantengan antes y después del movimiento activo. - Evita JavaScript basado en reloj de pared, estado activado por hover y cambios de clase que dependan de eventos del usuario.
El adaptador descubre elementos con animation-name calculado, busca sus manejadores de Animation del navegador cuando están disponibles, y recurre a pausar con animation-delay negativo.
Patrón 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>
Patrón de Escalonamiento
Usa propiedades 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>
Buenos Usos
- Bucles decorativos con un número conocido de repeticiones.
- Máscaras, brillo, resplandor, grano y capas de paralaje sutiles.
- Entradas simples de un solo elemento donde una línea de tiempo completa en JS sería excesiva.
Evita
- Animaciones CSS infinitas a menos que hayas verificado que el navegador expone manejadores de animación CSS buscables respaldados por WAAPI. Prefiere un número finito de iteraciones que cubra la duración visible.
- Animar propiedades de layout como
top,left,widthoheightcuando las transformaciones funcionan. - Depender de hover, foco, desplazamiento o consultas de medios para desencadenar movimiento crítico para el renderizado.
- Cambiar clases de animación después del inicio a menos que otra línea de tiempo determinista controle ese cambio.
Validación
Después de editar composiciones de animaciones CSS:
npx hyperframes lint
npx hyperframes validate
Créditos y Referencias
- Código fuente del adaptador de HyperFrames:
packages/core/src/runtime/adapters/css.ts. - Documentación de animaciones CSS de MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/animation
animation-fill-modede MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/animation-fill-mode