HyperFrames 的 Anime.js 適配器
HyperFrames 可以透過其 animejs 運行時適配器來控制 Anime.js 實例。組合擁有動畫物件,而 HyperFrames 擁有時鐘。
合約
- 在組合初始化期間同步建立動畫或時間軸。
- 設定
autoplay: false,以防止 Anime.js 使用自己的時鐘。 - 將每個回傳的動畫或時間軸註冊到
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 修飾。
- 可以改造成 seek 驅動的導入式 Anime.js 範例。
- 推入同一個註冊表的多個獨立微型動畫。
除非使用者特別要求使用 Anime.js,否則對於複雜場景序列請使用 GSAP。GSAP 仍是 HyperFrames 的主要創作路徑。
避免
- 保留
autoplay為 Anime.js 的預設值。 - 依賴
anime.running自動發現,而非明確的window.__hfAnime.push(...)。 - 無限循環。請根據組合持續時間計算一個有限的重複次數。
- 在計時器、Promise、事件處理器或非同步資源載入後建立動畫。
驗證
編輯使用 Anime.js 的組合後:
npx hyperframes lint
npx hyperframes validate
鳴謝與參考
- HyperFrames 適配器程式碼:
packages/core/src/runtime/adapters/animejs.ts。 - 關於
autoplay、pause()和seek()的 Anime.js 文件:https://animejs.com/documentation/