修復動畫效能
修復動畫效能問題。
如何使用
-
/fixing-motion-performance將這些限制套用至此對話中所有 UI 動畫工作。 -
/fixing-motion-performance <檔案>根據以下所有規則審查該檔案,並回報:- 違規事項(引用確切的程式碼行或片段)
- 為何重要(一句簡短說明)
- 具體的修正方法(程式碼層級的建議)
除非明確要求,否則不要遷移動畫函式庫。在現有技術堆疊內套用規則。
使用時機
在以下情況參考這些指南:
- 新增或修改 UI 動畫(CSS、WAAPI、Motion、rAF、GSAP)
- 重構卡頓的互動或過渡效果
- 實作滾動相關動畫或滾動觸發顯示效果
- 為佈局、濾鏡、遮罩、漸層或 CSS 變數添加動畫
- 審查使用
will-change、transform或尺寸測量的元件
渲染步驟詞彙表
- 複合 (composite):transform、opacity
- 繪製 (paint):顏色、邊框、漸層、遮罩、圖片、濾鏡
- 佈局 (layout):尺寸、位置、流向、網格、彈性盒
規則類別與優先級
| 優先級 | 類別 | 影響 |
|---|---|---|
| 1 | 永不使用模式 | 嚴重 |
| 2 | 選擇動畫機制 | 嚴重 |
| 3 | 尺寸測量 | 高 |
| 4 | 滾動 | 高 |
| 5 | 繪製 | 中高 |
| 6 | 圖層 | 中 |
| 7 | 模糊與濾鏡 | 中 |
| 8 | 視圖過渡 | 低 |
| 9 | 工具邊界 | 嚴重 |
快速參考
1. 永不使用模式(嚴重)
- 不要在同一幀中交錯執行佈局讀取和寫入
- 不要在大面積或有重要意義的表面上連續對佈局進行動畫
- 不要透過
scrollTop、scrollY或scroll事件驅動動畫 - 禁止使用沒有停止條件的
requestAnimationFrame迴圈 - 不要混合使用多個各自測量或變異佈局的動畫系統
2. 選擇動畫機制(嚴重)
- 預設使用 transform 和 opacity 來製作動畫
- 僅在互動需要時才使用 JavaScript 驅動的動畫
- 僅在小而孤立的表面上才可接受對繪製或佈局進行動畫
- 一次性效果比連續動畫更常可被接受
- 優先選擇降級技術而非完全移除動畫
3. 尺寸測量(高)
- 只測量一次,然後透過 transform 或 opacity 進行動畫
- 在寫入之前,先批次完成所有 DOM 讀取
- 不要在動畫過程中重複讀取佈局
- 對於類似佈局的效果,偏好使用 FLIP 風格的過渡
- 偏好能批次處理測量和寫入的方法
4. 滾動(高)
- 對於滾動相關的動畫,若有 Scroll 或 View Timelines 可用,請優先使用
- 使用 IntersectionObserver 來偵測可見性並暫停動畫
- 不要輪詢滾動位置來驅動動畫
- 當元件離開畫面時,暫停或停止動畫
- 滾動相關動畫不得在大面積表面上觸發連續的佈局或繪製
5. 繪製(中高)
- 僅允許在小而孤立的元素上對會觸發繪製的屬性進行動畫
- 不要在大型容器上對繪製成本高的屬性進行動畫
- 不要對用於 transform、opacity 或位置值的 CSS 變數進行動畫
- 不要對被繼承的 CSS 變數進行動畫
- 將設有動畫的 CSS 變數限制在局部作用域,避免繼承
6. 圖層(中)
- 合成器動畫需要圖層提升,切勿假設它會自動發生
- 暫時且精準地使用
will-change - 避免建立過多或過大的提升圖層
- 當效能至關重要時,使用開發者工具驗證圖層行為
7. 模糊與濾鏡(中)
- 保持模糊動畫的模糊值較小(<=8px)
- 僅在短暫的一次性效果中使用模糊
- 切勿對模糊進行連續動畫
- 切勿在大面積表面上對模糊進行動畫
- 在使用模糊之前,優先考慮 opacity 和 translate
8. 視圖過渡(低)
- 僅將視圖過渡用於導航層級的頁面變更
- 避免在互動密集的 UI 中使用視圖過渡
- 當需要能夠被打斷或取消時,避免使用視圖過渡
- 將尺寸變化視為可能觸發佈局的行為
9. 工具邊界(嚴重)
- 除非明確要求,否則不要遷移或重寫動畫函式庫
- 在現有的動畫系統內套用這些規則
- 切勿在同一個元件內部分遷移 API 或混合不同風格
常見修正範例
/* 佈局抖動:改用 transform 而非 width 來進行動畫 */
/* 修改前 */ .panel { transition: width 0.3s; }
/* 修改後 */ .panel { transition: transform 0.3s; }
/* 滾動相關動畫:使用 scroll-timeline 而非 JavaScript */
/* 修改前 */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* 修改後 */ .reveal { animation: fade-in linear; animation-timeline: view(); }
// 尺寸測量:先批次讀取再寫入 (FLIP)
// 修改前 — 佈局抖動
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// 修改後 — 只測量一次,透過 transform 進行動畫
const first = el.getBoundingClientRect();
el.classList.add('moved');
const last = el.getBoundingClientRect();
el.style.transform = `translateX(${first.left - last.left}px)`;
requestAnimationFrame(() => { el.style.transition = 'transform 0.3s'; el.style.transform = ''; });
審查指南
- 優先執行嚴重等級的規則(永不使用模式、工具邊界)
- 選擇能達成意圖且渲染成本最低的方式
- 對於任何非預設的選擇,請說明其合理使用的限制條件(表面大小、持續時間或互動需求)
- 審查時,偏好提供可操作的建議和具體的替代方案,而非空泛的理論
關聯
- 領域: [[設計與創造力]]
- 類別: [[3D 與動畫]]
- 導航: [[技能總覽]],[[首頁]]