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 |
具名文字動畫效果(透過外部 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 內部無時間軸建構)。GSAP 的 autoAlpha 和在明確時間軸邊界的零持續時間可見性設定仍被核心允許。僅在非片段元素或片段內的包裝器上使用這些例外;框架擁有 .clip 的生命週期。不要在此處重述完整的合約。
在核心合約基礎上新增的動畫創作要求:
- 預先計算的佈局常數 — 永遠不要在補間時從
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 / check / snapshot / preview / render