Anime.js para HyperFrames
O HyperFrames pode controlar instâncias do Anime.js através de seu adaptador de runtime animejs. A composição é dona dos objetos de animação; o HyperFrames é dono do relógio.
Contrato
- Crie animações ou timelines de forma síncrona durante a inicialização da composição.
- Defina
autoplay: falsepara que o Anime.js não avance com seu próprio relógio. - Registre cada animação ou timeline retornada em
window.__hfAnime. - Use durações finitas e contagens de loop finitas.
- Evite callbacks que mutem o DOM com base no tempo real (wall-clock), estado de rede ou aleatoriedade não seedada.
O adaptador chama instance.seek(timeMs) em cada instância registrada, onde timeMs é o tempo do HyperFrames em milissegundos.
Padrão 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>
Padrão de Timeline
<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>
Builds de Módulo
Se você usar um build de módulo ES, o adaptador não se importa como a instância foi criada. Ele só precisa que o objeto retornado exponha seek(), pause() e, preferencialmente, 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>
Bons Usos
- Pequenos floreios em SVG e DOM onde a sintaxe do Anime.js é compacta.
- Exemplos de Anime.js importados que podem ser tornados orientados a seek.
- Múltiplas micro-animações independentes enviadas para o mesmo registro.
Use GSAP para sequenciamento complexo de cenas, a menos que o usuário peça especificamente pelo Anime.js. GSAP ainda é o caminho principal de autoria do HyperFrames.
Evite
- Deixar
autoplayno padrão do Anime.js. - Depender da descoberta automática
anime.runningem vez dewindow.__hfAnime.push(...)explícito. - Loops infinitos. Calcule uma contagem de repetição finita a partir da duração da composição.
- Construir animações em timers, promises, manipuladores de eventos ou após cargas de assets assíncronas.
Validação
Após editar uma composição que usa Anime.js:
npx hyperframes lint
npx hyperframes validate
Créditos e Referências
- Fonte do adaptador HyperFrames:
packages/core/src/runtime/adapters/animejs.ts. - Documentação do Anime.js para
autoplay,pause()eseek(): https://animejs.com/documentation/