¿Qué hace Anime.js para HyperFrames?
HyperFrames puede buscar instancias de Anime.js a través de su adaptador de tiempo de ejecución animejs. La composición posee los objetos de animación; HyperFrames posee el reloj.
Contrato
- Crea animaciones o líneas de tiempo de forma síncrona durante la inicialización de la composición.
- Establece
autoplay: falsepara que Anime.js no avance por su propio reloj. - Registra cada animación o línea de tiempo devuelta en
window.__hfAnime. - Usa duraciones finitas y recuentos de bucle finitos.
- Evita callbacks que muten el DOM basados en la hora del reloj de pared, el estado de la red o aleatoriedad sin semilla.
El adaptador busca cada instancia registrada con instance.seek(timeMs), donde timeMs es el tiempo de HyperFrames en milisegundos.
Patrón Básico
<script src="https://cdn.jsdelivr.net/npm/[email protected]/lib/anime.iife.min.js"></script>
<script>
const anim = anime({
targets: ".mark",
translateX: 280,
rotate: "1turn",
opacity: [0, 1],
duration: 1200,
easing: "easeOutExpo",
autoplay: false,
});
window.__hfAnime = window.__hfAnime || [];
window.__hfAnime.push(anim);
</script>
Patrón de Línea de Tiempo
<script>
const tl = anime.timeline({
autoplay: false,
easing: "easeOutCubic",
});
tl.add({
targets: ".title",
translateY: [40, 0],
opacity: [0, 1],
duration: 650,
}).add(
{
targets: ".accent",
scaleX: [0, 1],
duration: 450,
},
250,
);
window.__hfAnime = window.__hfAnime || [];
window.__hfAnime.push(tl);
</script>
Construcciones con Módulos
Si usas una construcción de módulo ES, al adaptador no le importa cómo se creó la instancia. Solo necesita que el objeto devuelto exponga seek(), pause(), y preferiblemente play():
<script type="module">
import { animate } from "https://cdn.jsdelivr.net/npm/animejs/+esm";
const anim = animate(".chip", {
x: "18rem",
duration: 900,
autoplay: false,
});
window.__hfAnime = window.__hfAnime || [];
window.__hfAnime.push(anim);
</script>
Buenos Usos
- Pequeñas florituras SVG y DOM donde la sintaxis de Anime.js es compacta.
- Ejemplos importados de Anime.js que pueden hacerse buscables.
- Múltiples micro-animaciones independientes insertadas en el mismo registro.
Usa GSAP para secuencias de escenas complejas a menos que el usuario solicite específicamente Anime.js. GSAP sigue siendo la ruta principal de creación de HyperFrames.
Evitar
- Dejar
autoplayen el valor predeterminado de Anime.js. - Depender del autodescubrimiento
anime.runningen lugar dewindow.__hfAnime.push(...)explícito. - Bucles infinitos. Calcula un recuento de repeticiones finito a partir de la duración de la composición.
- Construir animaciones en temporizadores, promesas, manejadores de eventos o después de cargas de assets asíncronas.
Validación
Después de editar una composición que usa Anime.js:
npx hyperframes lint
npx hyperframes validate
Créditos y Referencias
- Código fuente del adaptador de HyperFrames:
packages/core/src/runtime/adapters/animejs.ts. - Documentación de Anime.js para
autoplay,pause()yseek(): https://animejs.com/documentation/