Communitygithub.com

Motion UI

製品UIのモーションとジェスチャーを計画、構築、レビューするための研究に基づいたプレイブック。19のパターンファイル、ワークフロー、非妥協条件、意思決定テーブル、トークンのデフォルト値を提供します。

Motion UI とは?

Motion UI スキルは、プロダクトUIにおけるモーションとジェスチャーの設計・実装・レビューのための包括的なガイドです。19のパターンファイル(目的、タイミング、ばね、ジェスチャー、遷移、パフォーマンス、レビュー基準など)から構成され、各ファイルにはルール、アンチパターン、アクセシビリティ、トークン、実装スケッチ、チェックリストが含まれています。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントと連携して使用することを想定しており、CSSトランジション、`@starting-style`、ビュートランジション、スクロール駆動アニメーションなどのプラットフォーム機能を優先し、ジェスチャーや速度が必要な場合にのみJSライブラリを使用するよう推奨しています。ワークフローはアニメーションの要否判断からメカニズム選択、タイミング設定、空間配置、ジェスチャー適用、振付、パフォーマンス最適化、リデュースドモーション対応、フレームベースのレビューまでをカバーし、18項目のレビュールーブリックで80%以上のスコアを目標としています。非妥協条件は18項目にわたって詳細に定義されており、アクセシビリティとユーザー制御(リデュースドモーション、割り込み可能性、スクロールジャック禁止)が表現性よりも優先されることを明確にしています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehudaBriskman/fUdesIgn/tree/HEAD/plugins/motion-ui/skills/motion-ui

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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-* パターンを使用してください。このスキルではこれらを繰り返しません。

ワークフロー

  1. 動かすべきかどうかを判断する。 役割を名付ける:フィードバック、連続性、方向付け、注意、または(稀に)喜び。発生頻度とキーボードからトリガーされるかどうかを推定し、以下の頻度テーブル(mfound-purpose-and-frequency.md)から該当する行を選びます。役割がない場合、またはアクションがキーボード駆動であるか1日100回以上発生する場合は、アニメーションなしで停止します。
  2. メカニズムを選ぶ。
    • 静止間およびトグル(メニュー、ダイアログ、トグル):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)。
  3. トークンからタイミングを設定する。 要素ごとのduration、方向ごとのeasing、exitはenterの0.75倍、ばねはdurationとbounceとして記述。コンポーネントで生の値を使用しないこと。
  4. 空間に配置する。 transform-origin をトリガーに設定し、exitをミラーリングし、forwardとbackの一貫性を保ち、永続的なクロームは静止させます(mtrans-spatial-origin-and-continuity.md)。トップレイヤー要素のenter/exitは mtrans-enter-exit-top-layer.md に従います。
  5. ジェスチャーの場合、次の順序で適用します:
    • 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)。
  6. 複数のものが変化するときは振付を行う: 原因が最初、次に親、次に子;20~40msのstagger、上限あり(mfound-choreography-and-stagger.md)。
  7. 軽量にする。 transformとopacityのみをアニメーション化し、グローバルな will-change は使わず、フィードバックは次のフレームでペイントする(mperf-compositor-will-change-and-inp.md)。
  8. リデュースドモーションバージョン を削除ではなく置換として記述する(mfound-reduced-motion-vestibular.md)。
  9. フレームからレビューする。
    • アンチパターンパスを実行する(mref-anti-patterns-gallery.md)。
    • フレームストリップ(4倍スロー、フルモーションとリデュースドモーション、および1回の割り込み実行)とページ内監査をキャプチャします。
    • 18項目のルーブリックをスコアリングする(mref-motion-review-rubric.md)。80%以上かつmust-checkが0でないことを確認して出荷します。
    • 各所見をチェックID・エビデンス・修正、およびチェックしなかったものとして報告します。

非妥協条件

以下のいずれかを破る場合は、書面による理由が必要です。

動かすかどうかと時間

  1. すべてのアニメーションには名前付きの役割があります。キーボードトリガーおよび1日100回以上のアクションにはアニメーションはありません。
  2. 最初の視覚的応答は、アニメーションの長さに関係なく、入力から100ms以内に表示されます。
  3. 時間はトークン(100 / 150 / 240 / 400 ms)から取得します。UIクロームで400msを超えるものはなく、稀な瞬間だけ600msに達することがあります。
  4. 進入は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 msease-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 msemphasized
ルートクロスフェード150~250 mslinear

ばねプリセット(mspring-parameters-and-mapping.md)

トークン期間 / bounce使用
spring-fast0.24 s / 0トグル、小さなコントロール
spring-default0.3 s / 0メニュー、シートのセトル、レイアウト
spring-slow0.45 s / 0全画面サーフェス
spring-snappy0.3 s / 0.15フリック後のリリース、スナップ
spring-playful0.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、独自のトークン):そのトークンが優先されます。これらをこれらのロールにマッピングし、ギャップをフラグします。
  • ルールが競合する場合: アクセシビリティとユーザー制御(リデュースドモーション、割り込み可能性、スクロールジャックなし)が表現性に優先し、頻度が喜びに優先します。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル