モーションパフォーマンスの修正
アニメーションパフォーマンスの問題を修正します。
使い方
-
/fixing-motion-performanceこの会話内のUIアニメーション作業に、以下の制約を適用します。 -
/fixing-motion-performance <ファイル>ファイルを以下のすべてのルールに照らしてレビューし、以下を報告します:- 違反(該当する行またはスニペットを正確に引用)
- なぜ問題か(簡潔な一文)
- 具体的な修正(コードレベルの提案)
明示的に依頼されない限り、アニメーションライブラリを移行しないでください。ルールは既存のスタック内で適用してください。
使用すべき場面
以下の場合にこのガイドラインを参照してください:
- UIアニメーションの追加または変更(CSS、WAAPI、Motion、rAF、GSAP)
- カクつくインタラクションやトランジションのリファクタリング
- スクロール連動モーションやスクロールによる表示アニメーションの実装
- レイアウト、フィルター、マスク、グラデーション、CSS変数のアニメーション
will-change、transform、または測定を使用するコンポーネントのレビュー
レンダリング手順の用語集
- コンポジット: 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 TimelinesまたはView Timelinesを優先する
- 可視性と一時停止にはIntersectionObserverを使用する
- アニメーションのためにスクロール位置をポーリングしない
- 画面外ではアニメーションを一時停止または停止する
- スクロール連動モーションは、大規模なサーフェスで継続的なレイアウトやペイントをトリガーしてはならない
5. ペイント(中〜高)
- ペイントをトリガーするアニメーションは、小さくて孤立した要素でのみ許可される
- 大きなコンテナ上でペイント負荷の高いプロパティをアニメーションさせない
- transform、opacity、positionのためにCSS変数をアニメーションさせない
- 継承されたCSS変数をアニメーションさせない
- アニメーションするCSS変数はローカルにスコープし、継承を避ける
6. レイヤー(中)
- コンポジッタモーションにはレイヤープロモーションが必要であり、自動的に行われると想定しない
- will-changeは一時的かつ限定的に使用する
- 多数または大規模なプロモートされたレイヤーを避ける
- パフォーマンスが重要な場合は、ツールを使用してレイヤーの動作を検証する
7. ぼかしとフィルター(中)
- ぼかしアニメーションは小さく(<=8px)保つ
- ぼかしは短く、一度きりの効果にのみ使用する
- ぼかしを継続的にアニメーションさせない
- 大きなサーフェスでぼかしをアニメーションさせない
- ぼかしよりもopacityとtranslateを優先する
8. ビュートランジション(低)
- ビュートランジションはナビゲーションレベルの変更にのみ使用する
- インタラクションの多いUIにはビュートランジションを避ける
- 中断やキャンセルが必要な場合はビュートランジションを避ける
- サイズ変更はレイアウトをトリガーする可能性があるものとして扱う
9. ツールの境界(重大)
- 明示的に依頼されない限り、アニメーションライブラリを移行または書き換えない
- これらのルールを既存のアニメーションシステム内で適用する
- APIを部分的に移行したり、同じコンポーネント内でスタイルを混在させたりしない
一般的な修正
/* レイアウトスラッシング:widthの代わりにtransformをアニメーションさせる */
/* 修正前 */ .panel { transition: width 0.3s; }
/* 修正後 */ .panel { transition: transform 0.3s; }
/* スクロール連動:JSの代わりにscroll-timelineを使用 */
/* 修正前 */ 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 = ''; });
レビューガイダンス
- 最初に重大なルール(絶対禁止パターン、ツールの境界)を適用する
- 意図に最も合致する、最もレンダリング負荷の少ない方法を選択する
- デフォルト以外の選択をする場合は、それを正当化する制約(サーフェスサイズ、期間、またはインタラクション要件)を明記する
- レビュー時は、理論よりも実用的な指摘と具体的な代替案を優先する