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