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 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。在創作完成後用它來稽核編排(死區、交錯一致性、生命週期警告)。
另請參閱
hyperframes-core— 組合結構、資料屬性、子組合、確定性渲染契約hyperframes-creative— 調色盤、字體排印、敘事、節拍規劃(非動畫創意方向)hyperframes-cli—npx hyperframes lint / validate / inspect / preview / render