Anime.js pour HyperFrames
HyperFrames peut parcourir les instances Anime.js via son adaptateur d'exécution animejs. La composition possède les objets d'animation ; HyperFrames possède l'horloge.
Contrat
- Créez des animations ou des timelines de manière synchrone lors de l'initialisation de la composition.
- Définissez
autoplay: falsepour qu'Anime.js n'avance pas avec sa propre horloge. - Enregistrez chaque animation ou timeline retournée sur
window.__hfAnime. - Utilisez des durées finies et des comptes de boucles finis.
- Évitez les callbacks qui mutent le DOM en fonction du temps réel, de l'état réseau ou d'un aléatoire non initialisé.
L'adaptateur parcourt chaque instance enregistrée avec instance.seek(timeMs), où timeMs est le temps HyperFrames en millisecondes.
Patron de base
<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>
Patron 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 modules
Si vous utilisez une build de module ES, l'adaptateur ne se soucie pas de la façon dont l'instance a été créée. Il a seulement besoin que l'objet retourné expose seek(), pause() et de préférence 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 usages
- Petites animations SVG et DOM où la syntaxe Anime.js est concise.
- Exemples Anime.js importés qui peuvent être rendus pilotés par
seek. - Plusieurs micro-animations indépendantes poussées dans le même registre.
Utilisez GSAP pour l'enchaînement de scènes complexes, sauf si l'utilisateur demande spécifiquement Anime.js. GSAP reste la voie principale de création HyperFrames.
À éviter
- Laisser
autoplayà la valeur par défaut d'Anime.js. - Dépendre de la découverte automatique
anime.runningau lieu d'unwindow.__hfAnime.push(...)explicite. - Boucles infinies. Calculez un nombre de répétitions fini à partir de la durée de la composition.
- Construire des animations dans des timers, des promesses, des gestionnaires d'événements ou après des chargements asynchrones d'actifs.
Validation
Après avoir modifié une composition qui utilise Anime.js :
npx hyperframes lint
npx hyperframes validate
Crédits et références
- Source de l'adaptateur HyperFrames :
packages/core/src/runtime/adapters/animejs.ts. - Documentation Anime.js pour
autoplay,pause()etseek(): https://animejs.com/documentation/