HyperFrames 动画
所有动效知识汇集于一个技能:规则(原子配方)、蓝图(多阶段场景模板)、过渡(场景到场景)、技术(更广泛的动效设计模式)和适配器(各运行时API)。
关于构成契约(数据属性、子构成、确定性),请参见 hyperframes-core。
默认:组合原子规则
从 rules-index.md 中选择2-4条规则,用一条暂停的GSAP时间线将它们粘合在一起,完成。这比从蓝图开始更快,产生的代码也更少。
加载蓝图的情形
- 当场景与现有的预设计多阶段模板匹配时(品牌展示、社交证明、演示页面滚动聚光灯等),复用其阶段管线可节省实际的创作时间
- 当您想要一个可运行的、包含4-5个阶段复杂编排的真实代码时
蓝图位于 blueprints-index.md。每个条目指向 blueprints/<id>.md(配方)和 examples/<id>.html(可运行示例)。不要投机性地读取;只有在您已决定需要场景级编排时才加载。
路由
| 想要… | 读取 |
|---|---|
| 按触发器/标签选取一个原子运动模式 | rules-index.md |
| 读取一条规则的完整HTML / CSS / GSAP配方 | rules/<name>.md |
| 选取一个多阶段场景模板 | blueprints-index.md |
| 读取一个蓝图的完整配方 | blueprints/<id>.md + examples/<id>.html |
| 编写场景过渡(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