用于 HyperFrames 的 Anime.js
HyperFrames 可以通过其 animejs 运行时适配器来 seek Anime.js 实例。合成过程拥有动画对象;HyperFrames 拥有时钟。
约定
- 在合成初始化期间同步创建动画或时间线。
- 设置
autoplay: false,以便 Anime.js 不在其自己的时钟上推进。 - 将每个返回的动画或时间线注册到
window.__hfAnime上。 - 使用有限的持续时间和循环次数。
- 避免基于挂钟时间、网络状态或未播种随机数来突变 DOM 的回调。
适配器通过 instance.seek(timeMs) 来 seek 每个注册的实例,其中 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>
良好用途
- 小型 SVG 和 DOM 装饰,其中 Anime.js 语法简洁。
- 导入的 Anime.js 示例,可以使其变为基于 seek 驱动。
- 多个独立的微动画推入同一个注册表中。
对于复杂的场景序列,除非用户特别要求使用 Anime.js,否则请使用 GSAP。GSAP 仍然是 HyperFrames 主要的创作路径。
避免
- 将
autoply保留为 Anime.js 的默认值。 - 依赖
anime.running自动发现而不是显式的window.__hfAnime.push(...)。 - 无限循环。从合成持续时间计算出有限的重复次数。
- 在定时器、Promise、事件处理器或异步资源加载后构建动画。
验证
编辑使用 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/