修復動畫效能
選擇性閱讀規則
從以下文件開始:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
然後僅載入與使用者實際任務相符的繼承文件、腳本、資產或範例。
修復動畫效能問題。
使用方式
-
/fixing-motion-performance將這些約束套用至本次對話中的任何 UI 動畫工作。 -
/fixing-motion-performance <file>根據以下所有規則審查該檔案,並回報:- 違規(引用確切的程式碼行或片段)
- 為何重要(一句簡短說明)
- 具體修復方式(程式碼層級建議)
除非明確要求,否則請勿遷移動畫函式庫。請在現有技術堆疊內套用規則。
使用時機
在下列情況參考這些指南:
- 新增或更改 UI 動畫(CSS、WAAPI、Motion、rAF、GSAP)
- 重構卡頓的互動或轉場
- 實作卷軸驅動動畫或捲動時顯示效果
- 對版面、濾鏡、遮罩、漸層或 CSS 變數進行動畫
- 審查使用了
will-change、transform或尺寸測量的元件
渲染步驟詞彙表
- composite:
transform、opacity - paint:顏色、邊框、漸層、遮罩、圖片、濾鏡
- layout:尺寸、位置、流向、網格、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或位置使用 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 = ''; });
審查指引
- 首先強制執行關鍵規則(絕不模式、工具邊界)
- 選擇最符合意圖且成本最低的渲染工作
- 對於任何非預設的選擇,說明證明其合理性的限制條件(表面大小、持續時間或互動需求)
- 審查時,偏好可操作的備註和具體替代方案,而非理論
限制
- 僅當任務明顯符合上述範圍時才使用此技能。
- 請勿將此輸出視為環境特定驗證、測試或專家審查的替代品。
- 如果缺少必要的輸入、權限、安全邊界或成功標準,請停止並要求釐清。