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 |
| 動態模糊——元素上的快門拖影,以及何時不應使用 | references/motion-blur.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 |
| 角色動畫(步行循環、吉祥物、關節木偶、手勢) | 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 內部建構時間軸)。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=<版本>。
另請參閱
hyperframes-core——組合結構、資料屬性、子組合、確定性渲染合約hyperframes-creative——調色盤、字體排印、敘事、節拍規劃(非動畫的創意指導)hyperframes-cli——npx hyperframes lint / check / snapshot / preview / render