Anime.js für HyperFrames
HyperFrames kann Anime.js-Instanzen über seinen animejs-Laufzeitadapter seeken. Die Komposition besitzt die Animationsobjekte; HyperFrames besitzt die Uhr.
Vertrag
- Erstellen Sie Animationen oder Timelines synchron während der Kompositionsinitialisierung.
- Setzen Sie
autoplay: false, damit Anime.js nicht mit seiner eigenen Uhr voranschreitet. - Registrieren Sie jede zurückgegebene Animation oder Timeline auf
window.__hfAnime. - Verwenden Sie endliche Dauern und Wiederholungszahlen.
- Vermeiden Sie Callbacks, die das DOM basierend auf Echtzeit, Netzwerkstatus oder ungesäter Zufälligkeit verändern.
Der Adapter sucht jede registrierte Instanz mit instance.seek(timeMs), wobei timeMs die HyperFrames-Zeit in Millisekunden ist.
Grundlegendes Muster
<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>
Timeline-Muster
<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>
Modul-Builds
Wenn Sie einen ES-Modul-Build verwenden, ist es dem Adapter egal, wie die Instanz erstellt wurde. Er benötigt lediglich, dass das zurückgegebene Objekt seek(), pause() und vorzugsweise play() bereitstellt:
<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>
Gute Anwendungsfälle
- Kleine SVG- und DOM-Verschönerungen, bei denen Anime.js-Syntax kompakt ist.
- Importierte Anime.js-Beispiele, die seek-gesteuert gemacht werden können.
- Mehrere unabhängige Mikroanimationen, die in dasselbe Register geschoben werden.
Verwenden Sie GSAP für komplexe Szenensequenzen, es sei denn, der Benutzer fragt ausdrücklich nach Anime.js. GSAP ist weiterhin der primäre HyperFrames-Autorenpfad.
Vermeiden
autoplayauf dem Anime.js-Standardwert zu belassen.- Sich auf automatische Erkennung von
anime.runningzu verlassen, anstatt explizitwindow.__hfAnime.push(...)zu verwenden. - Endlosschleifen. Berechnen Sie eine endliche Wiederholungsanzahl aus der Kompositionsdauer.
- Animationen in Timern, Promises, Ereignisbehandlern oder nach asynchronen Asset-Ladevorgängen zu erstellen.
Validierung
Nach dem Bearbeiten einer Komposition, die Anime.js verwendet:
npx hyperframes lint
npx hyperframes validate
Danksagungen und Referenzen
- HyperFrames-Adapterquelle:
packages/core/src/runtime/adapters/animejs.ts. - Anime.js-Dokumentation für
autoplay,pause()undseek(): https://animejs.com/documentation/