Anime.js for HyperFrames
HyperFrames は、animejs ランタイムアダプターを介して Anime.js インスタンスをシークできます。コンポジションがアニメーションオブジェクトを所有し、HyperFrames がクロックを管理します。
契約
- コンポジションの初期化中に、アニメーションまたはタイムラインを同期的に作成します。
- Anime.js が独自のクロックで進行しないよう、
autoplay: falseを設定します。 - 返されたすべてのアニメーションまたはタイムラインを
window.__hfAnimeに登録します。 - 有限の持続時間とループ回数を使用します。
- 壁時計時間、ネットワーク状態、またはシードされていない乱数に基づいて DOM を変更するコールバックを避けます。
アダプターは、登録された各インスタンスに対して instance.seek(timeMs) を呼び出します。ここで timeMs は HyperFrames の時間(ミリ秒)です。
基本パターン
<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>
タイムラインパターン
<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>
モジュールビルド
ES モジュールビルドを使用する場合、アダプターはインスタンスがどのように作成されたかを気にしません。必要なのは、返されたオブジェクトが seek()、pause()、およびできれば 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>
適切な使用例
- Anime.js の構文がコンパクトな小さな SVG および DOM の装飾。
- シーク駆動にできるインポート済みの Anime.js サンプル。
- 同じレジストリにプッシュされる複数の独立したマイクロアニメーション。
複雑なシーンシーケンスには、ユーザーが特に Anime.js を要求しない限り、GSAP を使用してください。GSAP は依然として主要な HyperFrames オーサリングパスです。
避けるべきこと
autoplayを Anime.js のデフォルトのままにすること。- 明示的な
window.__hfAnime.push(...)ではなく、anime.runningの自動検出に依存すること。 - 無限ループ。コンポジションの時間から有限の繰り返し回数を計算してください。
- タイマー、プロミス、イベントハンドラー、または非同期アセット読み込み後のアニメーション構築。
検証
Anime.js を使用するコンポジションを編集した後:
npx hyperframes lint
npx hyperframes validate
クレジットと参考情報
- HyperFrames アダプターのソース:
packages/core/src/runtime/adapters/animejs.ts。 - Anime.js ドキュメント(
autoplay、pause()、seek()について): https://animejs.com/documentation/