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 Animations 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 |
已命名的文字动画效果(24个ID,通过外部 animate-text 技能) | 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。用于在编写后审核编排(死区、交错一致性、生命周期警告)。
animation-map.mjs 首先从当前项目解析辅助包,然后可以引导捆绑的 HyperFrames 包版本。仅当在捆绑的 CLI/技能安装之外运行该技能,并且需要显式固定该引导版本时,才设置 HYPERFRAMES_SKILL_PKG_VERSION=<version>。
参见
hyperframes-core— 组合结构、数据属性、子组合、确定性渲染契约hyperframes-creative— 调色板、排版、叙述、节拍规划(非动画创意指导)hyperframes-cli—npx hyperframes lint / validate / inspect / preview / render