モーションパフォーマンスの修正
アニメーションのパフォーマンス問題を修正します。
使用方法
-
/fixing-motion-performanceこの会話内のすべてのUIアニメーション作業に、以下の制約を適用します。 -
/fixing-motion-performance <ファイル>指定されたファイルを以下のすべてのルールに照らしてレビューし、以下を報告します。- 違反箇所(該当行またはスニペットを引用)
- なぜそれが問題か(簡潔な一文)
- 具体的な修正案(コードレベルの提案)
明示的に要求されない限り、アニメーションライブラリの移行は行わないでください。既存のスタック内でルールを適用してください。
適用タイミング
以下の場合にこれらのガイドラインを参照してください。
- UIアニメーションの追加または変更(CSS、WAAPI、Motion、rAF、GSAP)
- カクつくインタラクションやトランジションのリファクタリング
- スクロール連動モーションやスクロールによる表示アニメーションの実装
- レイアウト、フィルター、マスク、グラデーション、CSS変数のアニメーション
- will-change、transform、または計測を使用するコンポーネントのレビュー
レンダリングステップの用語集
- コンポジット: transform、opacity
- ペイント: 色、境界線、グラデーション、マスク、画像、フィルター
- レイアウト: サイズ、位置、フロー、グリッド、フレックス
優先度別ルールカテゴリ
| 優先度 | カテゴリ | 影響度 |
|---|---|---|
| 1 | 絶対に避けるべきパターン | クリティカル |
| 2 | メカニズムの選択 | クリティカル |
| 3 | 計測 | 高 |
| 4 | スクロール | 高 |
| 5 | ペイント | 中高 |
| 6 | レイヤー | 中 |
| 7 | ぼかしとフィルター | 中 |
| 8 | ビュートランジション | 低 |
| 9 | ツール境界 | クリティカル |
クイックリファレンス
1. 絶対に避けるべきパターン(クリティカル)
- 同一フレーム内でレイアウトの読み取りと書き込みを交互に行わない
- 大規模または重要なサーフェス上でレイアウトを連続的にアニメーションさせない
- scrollTop、scrollY、またはスクロールイベントからアニメーションを駆動しない
- 停止条件のない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を部分的に移行したりスタイルを混在させたりしない
レビューガイダンス
- クリティカルルールを最初に適用する(絶対に避けるべきパターン、ツール境界)
- 意図に合致する最も負荷の低いレンダリング作業を選択する
- デフォルト以外の選択を行う場合は、それを正当化する制約(サーフェスサイズ、期間、またはインタラクション要件)を明記する
- レビュー時は、理論よりも実用的な指摘と具体的な代替案を優先する