Animaciones CSS para HyperFrames
HyperFrames puede buscar animaciones CSS keyframes a través de su adaptador de tiempo de ejecución css. Úselo para motivos repetidos simples, movimiento de fondo, brillos, resplandores, 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
- Coloque el elemento animado en el DOM antes de que finalice la inicialización del tiempo de ejecución.
- Asigne a los elementos temporizados un valor
data-startpara que el tiempo de animación local coincida con el clip. - Use
animation-durationyanimation-iteration-countfinitos porque la alternativa de retardo negativo no puede representar duración ilimitada en entornos sin animaciones CSS respaldadas por WAAPI. - Prefiera
animation-fill-mode: bothpara que los estados buscados se mantengan antes y después del movimiento activo. - Evite 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 calculada, busca sus manejadores 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 Escalonado
Use 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áscara, resplandor, brillo, granulado y capas de paralaje sutiles.
- Entradas simples de un solo elemento donde una línea de tiempo completa en JS sería excesiva.
Evitar
- Animaciones CSS infinitas a menos que haya verificado que el navegador expone manejadores de animación CSS buscables respaldados por WAAPI. Prefiera un número finito de iteraciones que cubra la duración visible.
- Animar propiedades de diseño como
top,left,widthoheightcuando las transformaciones funcionan. - Depender de hover, focus, scroll o consultas de medios para activar 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 animación 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 animación 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