外掛安裝: 在執行設定或更新命令之前,若此技能位於 HyperFrames 外掛內部,請遵循外掛執行規則。獨立安裝則保留下方的更新說明。
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 而未設定有限根 data-duration,沒有在頁面載入時對後續場景片段執行 gsap.set,沒有 display 或原始 visibility 補間,並且僅在時間軸完全建立後才註冊,包括當建置在非同步回呼(例如 document.fonts.ready)內執行時)。核心仍允許在明確的時間軸邊界使用 GSAP autoAlpha 和零持續時間的可見性設定。僅在非片段元素或片段內的包裝器上使用這些例外;框架擁有 .clip 生命週期。請勿在此重申完整合約。
在核心合約基礎上的動畫創作附加規則:
- 預先計算的版面常數 — 永遠不要在補間時透過
getBoundingClientRect()推導位置。補間時的 DOM 測量會因渲染器並行取樣而導致不同步;在構圖設定時計算一次座標並重複使用。 - 空間運動僅使用 GSAP 變換別名(
x、y、scale、rotation)。核心的白名單也允許對非空間屬性補間使用opacity/color/backgroundColor/borderRadius— 但絕不能使用width/height/top/left進行版面變更。
腳本
node <SKILL_DIR>/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