HyperFrames 动画
所有运动知识汇聚于一项技能:规则(原子级配方)、蓝图(多阶段场景模板)、转场(场景间过渡)、技巧(更广泛的运动设计模式)以及适配器(各运行时的 API)。
关于编排契约(数据属性、子编排、确定性),请参阅 hyperframes-core。
默认:组合原子规则
从 rules-index.md 中选取 2–4 条规则,用一条暂停的 GSAP 时间线将它们粘合在一起,即可完成。这比从蓝图开始更快,且生成的代码更少。
何时加载蓝图
- 场景与已有的预设计多阶段模板(品牌揭示、社交证明等)匹配,且复用其阶段管线能显著节省创作时间。
- 你需要针对复杂的 4–5 阶段编排运行可执行的基准代码。
蓝图位于 blueprints-index.md 中。每个条目指向 blueprints/<id>.md(配方)。不要无目的地读取它;仅在确定需要场景级编排时加载。
路由指南
| 目标 | 读取 |
|---|---|
| 按触发条件/标签选择原子运动模式 | rules-index.md |
| 读取某条规则的完整 HTML/CSS/GSAP 配方 | rules/<name>.md |
| 选择多阶段场景模板 | blueprints-index.md |
| 读取某个蓝图的完整配方 | blueprints/<id>.md |
| 编写场景转场(CSS 驱动,在两个片段之间) | transitions/overview.md、transitions/catalog.md |
| 查找更广泛的运动设计技巧 | techniques.md |
| 分析现有编排的动画映射 | scripts/animation-map.mjs |
| GSAP API — 时间线/补间/位置参数 | adapters/gsap.md |
| GSAP — 即用效果配方 | rules/gsap-effects.md |
| GSAP — 变换/性能 | adapters/gsap-transforms-and-perf.md |
| GSAP — 缓动/交错 | adapters/gsap-easing-and-stagger.md |
| GSAP — 时间线/标签 | adapters/gsap-timeline-and-labels.md |
Lottie/dotLottie(After Effects 导出,window.__hfLottie) | adapters/lottie.md |
Three.js/WebGL(3D 场景,AnimationMixer,hf-seek) | adapters/three.md |
Anime.js(window.__hfAnime) | adapters/animejs.md |
CSS 关键帧(animation-delay/play-state/fill-mode) | adapters/css-animations.md |
Web 动画 API(element.animate(),currentTime 寻踪) | adapters/waapi.md |
TypeGPU/WebGPU(navigator.gpu,WGSL,计算管线) | adapters/typegpu.md |
HTML 作为纹理 + WebGL/GLSL 后期效果(通过 drawElementImage 捕获动态 DOM) | adapters/html-in-canvas-patterns.md |
命名文本动画效果(通过外部 animate-text 技能提供 24 个 ID) | adapters/animate-text.md |
运行时选择
- GSAP 是 95% 运动工作的默认选项 — 涵盖时间线编排、变换、缓动和交错。本技能中的所有原子规则均基于 GSAP。
- Lottie 用于拥有自有预制时间线的资产(通常是 After Effects 导出)。
- Three.js 用于 3D 场景、摄像机运动、着色器驱动的视觉效果。
- Anime.js 用于轻量级补间,当 GSAP 过于臃肿时使用。
- CSS 用于简单的重复图案、装饰、闪烁效果 — 无 JavaScript 动画开销。
- WAAPI 用于无需 GSAP 依赖的原生浏览器关键帧。
- TypeGPU/WebGPU 用于 GPU 渲染画布(粒子、液态玻璃、自定义着色器)。
多个运行时可以在一个编排中共存。每个运行时将其实例注册到对应全局变量,以便 HyperFrames 一次性寻踪所有实例。
关键约束
前置条件:hyperframes-core → 不可协商规则(单一暂停时间线,data-duration 控制时长,禁止 Math.random/Date.now/performance.now,禁止 repeat: -1,禁止在后期场景片段上使用 gsap.set,禁止动画 display/visibility,禁止在 async/setTimeout/Promise 内部构建时间线)。此处不再赘述。
在核心契约基础上的动画创作补充:
- 预计算布局常量 — 绝不要在补间时从
getBoundingClientRect()推导位置。补间时的 DOM 测量会因为渲染器并行采样而导致不同步;请在编排设置时一次性计算坐标并复用。 - 空间运动仅使用 GSAP 变换别名(
x、y、scale、rotation)。核心的允许列表也包含opacity/color/backgroundColor/borderRadius用于非空间属性的补间 — 但绝不可使用width/height/top/left进行布局更改。
脚本
node skills/hyperframes-animation/scripts/animation-map.mjs <composition-dir> \
--out <composition-dir>/.hyperframes/anim-map
读取注册在 window.__timelines 上的每个 GSAP 时间线,枚举补间,采样包围盒,计算标志,输出 animation-map.json。用于在创作后审查编排(死区、交错一致性、生命周期警告)。
参见
hyperframes-core— 编排结构、数据属性、子编排、确定性渲染契约hyperframes-creative— 调色板、排版、旁白、节拍规划(非动画创意方向)hyperframes-cli—npx hyperframes lint / validate / inspect / preview / render