API de Animaciones Web para HyperFrames
HyperFrames puede sincronizar animaciones de la API de Animaciones Web a través de su adaptador de tiempo de ejecución waapi. WAAPI es útil cuando se desean fotogramas clave nativos del navegador con temporización creada en JavaScript y sin dependencia de GSAP.
Contrato
- Crea animaciones de forma sincrónica durante la inicialización de la composición.
- Usa
element.animate(...)condurationeiterationsfinitos. - Usa
fill: "both"para que los estados buscados persistan. - Pausa las animaciones después de crearlas o deja que el adaptador las pause en la primera búsqueda.
- Evita callbacks y promesas para el estado crítico del renderizado.
El adaptador llama a document.getAnimations(), establece el currentTime de cada animación al tiempo de HyperFrames en milisegundos, y luego la pausa.
Patrón básico
<div id="orb" class="clip orb" data-start="2" data-duration="3" data-track-index="2"></div>
<script>
const orb = document.getElementById("orb");
const animation = orb.animate(
[
{ transform: "translate3d(-160px, 0, 0) scale(0.8)", opacity: 0 },
{ transform: "translate3d(0, 0, 0) scale(1)", opacity: 1, offset: 0.35 },
{ transform: "translate3d(120px, 0, 0) scale(1.08)", opacity: 1 },
],
{
duration: 3000,
delay: 2000,
easing: "cubic-bezier(0.2, 0, 0, 1)",
fill: "both",
iterations: 1,
},
);
animation.pause();
</script>
Patrón escalonado
document.querySelectorAll(".token").forEach((token, index) => {
const animation = token.animate(
[
{ transform: "translateY(24px)", opacity: 0 },
{ transform: "translateY(0)", opacity: 1 },
],
{
duration: 620,
delay: index * 80,
easing: "cubic-bezier(0.2, 0, 0, 1)",
fill: "both",
iterations: 1,
},
);
animation.pause();
});
Buenos usos
- Movimiento ligero del DOM donde los fotogramas clave CSS son demasiado rígidos y GSAP es innecesario.
- Animaciones generadas a partir de datos estructurados.
- Líneas de tiempo simples que se pueden representar como fotogramas clave, retardos y desplazamientos.
Evita
- Iteraciones infinitas (
iterations) - Depender de
animation.finishedpara mutar el DOM crítico para el renderizado. - Ejecutar relojes separados con
requestAnimationFrame, temporizadores operformance.now(). - Animar propiedades de layout cuando las transformaciones y la opacidad pueden expresar el movimiento.
- Asumir que el tiempo de inicio local del clip es automático. El adaptador WAAPI busca el tiempo de animación a nivel de documento; modela los desplazamientos del clip con
delayo crea la animación en un elemento cuya visibilidad esté controlada por la temporización de HyperFrames.
Validación
Después de editar una composición WAAPI:
npx hyperframes lint
npx hyperframes validate
Créditos y referencias
- Código fuente del adaptador HyperFrames:
packages/core/src/runtime/adapters/waapi.ts. - Guía de la API de Animaciones Web de MDN: https://developer.mozilla.org/docs/Web/API/Web_Animations_API/Using_the_Web_Animations_API
- MDN
Animation.currentTime: https://developer.mozilla.org/en-US/docs/Web/API/Animation/currentTime