Motion UI は何をしますか?
プロダクトUIのモーションとジェスチャーのための研究に基づいたプレイブック。19のパターンファイルには、ルール、アンチパターン、良い/悪い参考例、アクセシビリティ、トークン、実装スケッチ、チェックリストが含まれています。このファイルはワークフロー、非妥協条件、決定テーブル、トークンのデフォルト値を提供します。詳細はパターンファイルを開いてください。
- パターンインデックス:
references/INDEX.mdに各パターンとその一行ルールがリストされています。 - パターンファイル:
references/patterns/<prefix>-<name>.md。プレフィックスはmfound(目的、タイミング、振付、リデュースドモーション)、mspring(ばね)、mgesture(ドラッグ、モメンタム、エッジ、シート、割り込み)、mtrans(進入/退出、空間的な起点、ルート遷移、マイクロインタラクション、スクロール駆動)、mperf(パフォーマンス)、mref(レビュールーブリック、アンチパターン)です。 - スタータートークン:
assets/motion-tokens.css。duration、easing、staggerの名前と値は dashboard-ui のtokens.cssと一致しています。ライトモードとダークモードで単独で動作します。読み込むdashboard-uiのロールトークンはゼロ詳細度で宣言されているため、dashboard-uiのtokens.cssまたはプロジェクト独自の同じロール名のトークンが、どの読み込み順でも上書きされます。 - データUI: 数値トゥイーン、チャート遷移、リンク探索、ライブ再計算、ローディング状態には、dashboard-ui の
motion-*およびprog-*パターンを使用してください。このスキルではこれらを繰り返しません。
ワークフロー
- 動かすべきかどうかを判断する。 役割を名付ける:フィードバック、連続性、方向付け、注意、または(稀に)喜び。発生頻度とキーボードからトリガーされるかどうかを推定し、以下の頻度テーブル(
mfound-purpose-and-frequency.md)から該当する行を選びます。役割がない場合、またはアクションがキーボード駆動であるか1日100回以上発生する場合は、アニメーションなしで停止します。 - メカニズムを選ぶ。
- 静止間およびトグル(メニュー、ダイアログ、トグル):CSSトランジション(
mfound-durations-and-easing.md)、またはばねlinear()トークン(mspring-css-linear-and-tokens.md)。 - 指やポインターで駆動される、または速度で割り込み可能:JSばね(
mspring-parameters-and-mapping.md、mgesture-interruptibility-and-velocity.md)。 - ナビゲーション:ビュートランジション(
mtrans-view-transitions-and-routes.md)。 - スクロール位置に連動:スクロール駆動アニメーション(
mtrans-scroll-driven-animations.md)。
- 静止間およびトグル(メニュー、ダイアログ、トグル):CSSトランジション(
- トークンからタイミングを設定する。 要素ごとのduration、方向ごとのeasing、exitはenterの0.75倍、ばねはdurationとbounceとして記述。コンポーネントで生の値を使用しないこと。
- 空間に配置する。
transform-originをトリガーに設定し、exitをミラーリングし、forwardとbackの一貫性を保ち、永続的なクロームは静止させます(mtrans-spatial-origin-and-continuity.md)。トップレイヤー要素のenter/exitはmtrans-enter-exit-top-layer.mdに従います。 - ジェスチャーの場合、次の順序で適用します:
- 10pxのしきい値で1:1追跡(
mgesture-direct-manipulation-drag.md); - リリース時の投影と速度(
mgesture-momentum-projection-and-snap.md); - ラバーバンドエッジ(
mgesture-rubber-banding-and-bounds.md); - シートとスワイプルール(
mgesture-sheets-and-swipe-to-dismiss.md)。
- 10pxのしきい値で1:1追跡(
- 複数のものが変化するときは振付を行う: 原因が最初、次に親、次に子;20~40msのstagger、上限あり(
mfound-choreography-and-stagger.md)。 - 軽量にする。 transformとopacityのみをアニメーション化し、グローバルな
will-changeは使わず、フィードバックは次のフレームでペイントする(mperf-compositor-will-change-and-inp.md)。 - リデュースドモーションバージョン を削除ではなく置換として記述する(
mfound-reduced-motion-vestibular.md)。 - フレームからレビューする。
- アンチパターンパスを実行する(
mref-anti-patterns-gallery.md)。 - フレームストリップ(4倍スロー、フルモーションとリデュースドモーション、および1回の割り込み実行)とページ内監査をキャプチャします。
- 18項目のルーブリックをスコアリングする(
mref-motion-review-rubric.md)。80%以上かつmust-checkが0でないことを確認して出荷します。 - 各所見をチェックID・エビデンス・修正、およびチェックしなかったものとして報告します。
- アンチパターンパスを実行する(
非妥協条件
以下のいずれかを破る場合は、書面による理由が必要です。
動かすかどうかと時間
- すべてのアニメーションには名前付きの役割があります。キーボードトリガーおよび1日100回以上のアクションにはアニメーションはありません。
- 最初の視覚的応答は、アニメーションの長さに関係なく、入力から100ms以内に表示されます。
- 時間はトークン(100 / 150 / 240 / 400 ms)から取得します。UIクロームで400msを超えるものはなく、稀な瞬間だけ600msに達することがあります。
- 進入はease-out;画面上の移動はease-in-out;ユーザーが待つものには
ease-inは使用しません。退出はenterの約0.75倍です。
ばねとジェスチャー 5. ばねは duration + bounce として記述します。UIクロームには bounce 0、モメンタムを伴うジェスチャーの後だけ 0.1~0.2、opacity、色、データ値には決して使用しません。 6. ドラッグされた要素は、掴んだ点からポインターを1:1で追跡し、ドラッグ中はトランジションなし。約10px後にドラッグを確定します。 7. リリース時には、投影された 位置に最も近いターゲットにスナップし、リリース速度でセトルばねを開始します。 8. エッジはラバーバンド;指の下でハードストップしません。 9. ユーザーが影響を与えられるものはすべて、現在の画面上の値から割り込み可能です。アニメーションキューはなく、モーション中に入力がブロックされることはありません。トグルUIはキーフレームではなくトランジションを使用します。 10. 破壊的なジェスチャーアクションはリリース時に確定し、元に戻す機能を提供します。すべてのジェスチャーにはボタンまたはキーボード相当の操作があります(WCAG 2.5.7)。
進入、退出、ナビゲーション
11. scale(0) から開始しない。opacity 0 と scale 0.95~0.97 または 8~24px の移動から進入し、transform-origin をトリガーに設定します。
12. 進入には @starting-style を使用し、退出には display/overlay を allow-discrete とともに使用します。可視の最終状態がデフォルトであるため、未対応ブラウザでも動作します。
13. ルート遷移はプログレッシブエンハンスメントです。まずデータを準備し、次に遷移します。デフォルトのクロスフェードまたは16~24pxの方向シフトを遷移タイプごとに使用し、1~3個の共有要素を指定し、その後フォーカスを移動します。
14. トーストは情報の唯一のコピーを保持してはいけません。エラーは自動で消えません。元に戻すトーストは少なくとも8秒間表示され、そのアクションはトーストの外にも存在します。タイマーはホバー、フォーカス、非表示タブで一時停止します(dashboard-ui comp-notifications-alerts.md)。
パフォーマンスと安全性
15. 小さなコントロールより大きいものでは、transform系プロパティとopacityのみをアニメーション化します。transition: all は禁止。will-change は一時的で、計測後にのみ使用します。
16. prefers-reduced-motion: reduce の下では、空間的な動きを150ms以下のフェードに置き換え、フィードバックを維持し、1:1のドラッグ追跡を維持し、bounceを削除します。グローバルな 0.01ms キルスイッチを出荷しないでください。JSアニメーションもこの設定を尊重する必要があります。
17. 製品UIでは、パララックス、スクロールジャック、フルビューポートズーム、アイドルループモーションは禁止。5秒を超える自動再生には一時停止コントロールがあり、1秒間に3回以上点滅してはいけません。
18. コードや記憶ではなく、キャプチャしたフレームからモーションをレビューします。
決定テーブル
頻度 → モーション(mfound-purpose-and-frequency.md)
| 頻度 | モーション |
|---|---|
| キーボードトリガー、または1日100回以上(スキルのカットオフ) | なし |
| 1日に数十回 | 100~150msのフェード、小さなスケール程度;移動なし、bounceなし |
| セッションに数回 | 150~240ms、8~24pxの移動可 |
| 稀(初回実行、大きな成功) | 最大400~600ms、bounceを許可するばね可 |
メカニズム(mspring-parameters-and-mapping.md、mspring-css-linear-and-tokens.md)
| 状況 | 使用するもの |
|---|---|
| 色、opacity、状態変化 | CSSトランジション、linear または ease-out |
| 途中で反転される可能性のあるトグル要素 | CSSトランジション(キーフレームは不可) |
| ばね感のある静止間空間モーション | CSSばね linear() トークンと独自のduration |
| ドラッグやフリック後のリリース、速度を伴う再ターゲット | JSばね(Motion、React Spring、SwiftUI、Compose) |
| レイアウト変更(並び替え、サイズ変更、展開) | FLIP、Motion layout、またはビュートランジション |
| ページまたはルート変更 | ビュートランジション(同一または異種ドキュメント) |
| スクローラーを通した進行 | スクロール駆動アニメーション |
要素ごとの期間とイージング(mfound-durations-and-easing.md)
| 要素 | 期間 | 曲線 |
|---|---|---|
| 押下、トグル、ホバー | 100 ms | ease-out(押下スケール0.97) |
| ツールチップ、メニュー、ポップオーバー | 150 ms 進入 / 110 ms 退出 | 進入はease-out、退出はease-inまたはフェードアウト |
| ダイアログ、トースト | 240 ms 進入 / 180 ms 退出 | 進入はease-out、退出はease-inまたはフェードアウト |
| シート、ドロワー | 240~400 ms | --motion-ease-drawer、またはドラッグ後のばね |
| コンテナ変換(カード→詳細) | 400 ms | emphasized |
| ルートクロスフェード | 150~250 ms | linear |
ばねプリセット(mspring-parameters-and-mapping.md)
| トークン | 期間 / bounce | 使用 |
|---|---|---|
spring-fast | 0.24 s / 0 | トグル、小さなコントロール |
spring-default | 0.3 s / 0 | メニュー、シートのセトル、レイアウト |
spring-slow | 0.45 s / 0 | 全画面サーフェス |
spring-snappy | 0.3 s / 0.15 | フリック後のリリース、スナップ |
spring-playful | 0.4 s / 0.3 | まれな喜びのみ |
ライブラリパラメータ(Motion、React Spring、SwiftUI、Material 3)は mspring-parameters-and-mapping.md の1つの式から導出されます。
ジェスチャーのしきい値(mgesture-*)
| 値 | デフォルト |
|---|---|
| ドラッグ開始 / 軸ロック | 10 px |
| 速度サンプルウィンドウ | 100 ms |
| 投影減速度 | 1msあたり0.998(高速ページングでは0.99) |
| フリック確定 | > 400 px/s |
| シート閉じ | 高さの25%以上ドラッグ、またはフリック |
| ラバーバンド定数 | 0.55(一般的な近似値) |
トークンのデフォルト値
完全なセットは assets/motion-tokens.css にあります。
| グループ | デフォルト値 |
|---|---|
| 期間 | instant 0 · micro 100 · short 150 · medium 240 · long 400 ms · exit ratio 0.75 |
| イージング | standard cubic-bezier(0.2,0,0.38,0.9) · enter (0,0,0.38,0.9) · exit (0.2,0,1,0.9) · emphasized (0.2,0,0,1) · drawer (0.32,0.72,0,1) |
| ばね(CSS) | --motion-spring-{fast,default,slow,snappy,playful} と対応する -dur(360 / 450 / 670 / 420 / 660 ms) |
| ジオメトリ | scale-from 0.96 · press 0.97 · distance 8 / 16 / 24 px |
| 振付 | stagger 30 ms · max 300 ms(メニューでは150 ms) |
| リデュースドモーション | 空間トークンは0または1に折りたたみ;フェードはタイミングを維持 |
このスキルの適用方法
- 構築する場合:
assets/motion-tokens.cssをロードするか、プロジェクトのトークンにマッピングします。- プラットフォーム機能を優先:CSSトランジション、
@starting-style、<dialog>とpopover API、ビュートランジション、スクロール駆動アニメーション、linear()。ジェスチャーと速度にのみJSライブラリを使用します。 - TypeScriptの
any型は決して使用しないでください。
- レビューする場合: 最初にフレームをキャプチャし、次にアンチパターンギャラリーとルーブリックを実行します。チェック、スコア、エビデンス、修正を重大度順に並べたテーブルを報告し、チェックしなかったものをリストします。
- プロジェクトにモーションシステムがある場合(M3、Carbon、独自のトークン):そのトークンが優先されます。これらをこれらのロールにマッピングし、ギャップをフラグします。
- ルールが競合する場合: アクセシビリティとユーザー制御(リデュースドモーション、割り込み可能性、スクロールジャックなし)が表現性に優先し、頻度が喜びに優先します。