修復動畫效能
修復動畫效能問題。
使用方法
-
/fixing-motion-performance將這些約束套用到對話中所有 UI 動畫工作。 -
/fixing-motion-performance <file>依據以下所有規則審查該檔案,並回報:- 違規(引用確切行數或程式碼片段)
- 為什麼重要(一句簡短說明)
- 具體修正(程式碼層級的建議)
除非明確要求,否則請勿遷移動畫庫。應在現有技術棧內套用規則。
使用時機
在以下情境參考這些指南:
- 新增或修改 UI 動畫(CSS, WAAPI, Motion, rAF, GSAP)
- 重構卡頓的互動或轉場
- 實作滾輪驅動動畫或滾動顯現效果
- 對版面、濾鏡、遮罩、漸層或 CSS 變數進行動畫
- 審查使用了 will-change、變形或尺寸測量的元件
渲染步驟說明
- 合成:transform, opacity
- 繪製:color, borders, gradients, masks, images, filters
- 版面:size, position, flow, grid, flex
規則類別(依優先級)
| 優先級 | 類別 | 影響程度 |
|---|---|---|
| 1 | 永不模式 | 嚴重 |
| 2 | 選擇機制 | 嚴重 |
| 3 | 測量 | 高 |
| 4 | 滾輪 | 高 |
| 5 | 繪製 | 中高 |
| 6 | 圖層 | 中 |
| 7 | 模糊與濾鏡 | 中 |
| 8 | 視圖轉換 | 低 |
| 9 | 工具界限 | 嚴重 |
快速參考
1. 永不模式(嚴重)
- 禁止在同一個影格中交錯讀取與寫入版面屬性
- 禁止在大型或有重要意義的表面上連續對版面屬性進行動畫
- 禁止透過 scrollTop、scrollY 或 scroll 事件驅動動畫
- 禁止使用沒有停止條件的 requestAnimationFrame 迴圈
- 禁止混用多個各自測量或修改版面的動畫系統
2. 選擇機制(嚴重)
- 預設使用 transform 和 opacity 進行動畫
- 僅在互動需要時才使用 JS 驅動的動畫
- 僅在小型、孤立的元素上允許繪製或版面動畫
- 一次性效果比連續動畫更容易被接受
- 優先選擇降級技術,而非完全移除動畫
3. 測量(高)
- 測量一次,然後透過 transform 或 opacity 進行動畫
- 在寫入之前批量完成所有 DOM 讀取
- 動畫過程中不要重複讀取版面屬性
- 偏好使用 FLIP 風格的轉換來實現類似版面的效果
- 偏好能批量測量與寫入的方法
4. 滾輪(高)
- 當支援時,優先使用 Scroll 或 View Timelines 實現滾輪驅動動畫
- 使用 IntersectionObserver 判斷可見性與暫停
- 不要輪詢滾動位置來驅動動畫
- 當元素離開畫面時暫停或停止動畫
- 滾輪驅動動畫不得在大型表面上觸發連續版面或繪製
5. 繪製(中高)
- 僅允許在小型、孤立的元素上觸發繪製的動畫
- 不要在大型容器上對繪製密集型屬性進行動畫
- 不要對 transform、opacity 或 position 的 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 而非 JS */
/* 修改前 */ 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 = ''; });
審查指引
- 優先執行關鍵規則(永不模式、工具界限)
- 選擇最符合意圖且渲染開銷最低的方式
- 對於任何非預設的選擇,說明使其合理的約束條件(表面大小、時長或互動需求)
- 審查時,偏好提供可操作的備註與具體替代方案,而非理論
限制
- 僅在任務明確符合上述範圍時使用此技能。
- 請勿將輸出視為環境特定驗證、測試或專家審查的替代方案。
- 若缺少所需的輸入、權限、安全邊界或成功標準,請停下並請求釐清。