UIモーションパターン
2つの仕事:実際の製品UIをWeb上でアニメーション化すること、および製品UIをビデオ用に再設計せずに再構築すること。どちらも同じトークンを使用します。
1. トークンファースト
モーションを一度定義し、どこでもインポートします。コンポーネント内にインライン数値は記述しません。
export const motionTokens = {
duration: { instant: 0.1, fast: 0.18, normal: 0.3, slow: 0.5, scene: 0.7 },
easing: {
standard: [0.2, 0, 0, 1], // 進入 + 移動
exit: [0.4, 0, 1, 1], // 離脱
emphasized: [0.3, 0, 0, 1],
},
distance: { nudge: 4, small: 8, medium: 16, large: 32 },
stagger: 0.06, // 0.05〜0.10の間を維持
} as const;
export const springs = {
press: { type: "spring", stiffness: 600, damping: 38 }, // ボタン、トグル
snappy: { type: "spring", stiffness: 420, damping: 34 }, // チップ、メニュー
gentle: { type: "spring", stiffness: 260, damping: 27 }, // カード、パネル
layout: { type: "spring", stiffness: 320, damping: 30 }, // 並べ替え、サイズ変更
camera: { type: "spring", stiffness: 140, damping: 20 }, // 大きな移動、ビデオのみ
} as const;
質量1、減衰比ζ = damping / (2·√stiffness):press 0.78、snappy 0.83、gentle 0.84、layout 0.84、camera 0.85 — すべて0.75〜0.90の範囲内(オーバーシュート≤約6%)。ブランドに合わせてこの式で調整し、このテーブルを唯一の情報源として維持してください。
2. アクセシビリティとSSR
"use client";
import { useReducedMotion } from "motion/react";
export function useSafeMotion() {
const reduce = useReducedMotion();
return {
reduce,
// モーション軽減:transformを削除し、短いopacity変化(≤0.2秒)を維持
enter: reduce ? { opacity: 1 } : { opacity: 1, y: 0 },
initial: reduce ? { opacity: 0 } : { opacity: 0, y: 8 },
transition: reduce ? { duration: 0.2 } : undefined,
};
}
- 初回ペイント時にすでに表示されている要素には
initial={false}を使用して、ハイドレーション時のフラッシュを回避します。 transformとopacityのみをアニメーション化します。width、height、top、left、またはbox-shadowをループでアニメーション化しないでください。代わりにlayoutまたはscaleを使用します。- ローエンドデバイス:durationを短縮し、装飾的なモーションをスキップします。
3. パターンとそのルール
| パターン | ルール |
|---|---|
| ボタンプレス | whileTap={{ scale: 0.96 }}とsprings.pressを使用;100ミリ秒以内にフィードバック |
| 条件付きレンダリング | AnimatePresenceでラップし、安定したkeyを設定;すべてのinitial + animateにはexitが必要 |
| ページ / ルート遷移 | AnimatePresence mode="wait":exitが完了してからenterを開始 |
| リストスタッガー | staggerChildrenを0.05〜0.10秒に設定;スタッガーするアイテムは約8個までに制限し、残りは同時に表示 |
| 並べ替え / サイズ変更 | 小さなサブツリー(≲5子要素)にのみlayoutを使用;それ以外は明示的なx/yを使用 |
| モーダル / シート | フォーカストラップ、Escapeで閉じる、スクロールロック、role="dialog"、aria-modal="true"、フォーカスを戻す |
| トースト | 表示される端から進入;自動非表示はホバー/フォーカス時に一時停止 |
| 数値変化 | 垂直ロール:古い値は上方に退出しぼやけ、新しい値は下から進入;font-variant-numeric: tabular-nums |
| スクロールリビール | whileInViewとviewport={{ once: true }}を使用;スクロールアウト時に再アニメーション化しない |
| ローディング → 成功 | ボタンが圧縮→スピナー→チェックマーク;ボタンの幅は安定させる |
4. ビデオ用の製品UI再構築
- 推測するな、計測せよ。 製品ソースまたは計算されたスタイルからトークンを取得:色、角丸、フォントファミリー/ウェイト/トラッキング、スペーシング、アイコンセットとストローク。実際のスクリーンショットから色をサンプリングして比較。
- ハイブリッドがデフォルト。 実際のスクリーンショットをコンテキストとして使用;アニメーションする要素のみをピクセル単位でその上に再構築。
- 明示的な承認なしに再設計しないこと。 新しい色、フォント、アイコン、またはコピーは追加しない。
- クリーンにキャプチャ。 ログアウト済みまたはデモアカウント、架空のデータ、個人情報なし、ユーザーが所有していない限りサードパーティのブランドなし。
- シーク可能。 ビデオでは、すべてのアニメーション値を絶対時間(
value = f(t))から駆動し、motion/reactのランタイム状態からは駆動しない。ライブWebにはmotion/reactを、レンダリングされたビデオには閉形式のスプリングまたはGSAPタイムラインを使用する。
これらのパターンがWebサイトで使用され、ビデオではない場合は、出荷前にdesign-expert検証ゲート(キーボード、フォーカス、モーション軽減、パフォーマンス)を実行してください。