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=<version>。
參閱
hyperframes-core— 構圖結構、資料屬性、子構圖、確定性渲染合約hyperframes-creative— 色板、字體排印、敘事、節拍規劃(非動畫的創意方向)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render