Motion Dev アニメーション
Motion.dev - 月間1000万ダウンロード、Framer Motionの後継 React、Next.js、Svelte、Astro、Vue向けの120fps GPUアクセラレーションアニメーション
目的
Apple/Jon Iveの原則に従い、Motion.devを使用してプロダクショングレードのアニメーションを生成します。 目的主導(機能を提供) | 滑らか(120fps) | アクセシブル(モーション低減) | 高性能(GPUのみ) | エレガント(控えめ) | 一貫性(統一されたタイミング)
使用すべき場合
✅ 使用するケース:
- React 19+/Next.js 15+/Svelte 5+/Astro 4+ アニメーション実装
- スクロールエフェクト(パララックス、表示)、ジェスチャー(ホバー、ドラッグ、タップ)、レイアウトアニメーション
- 60fps以上のパフォーマンスを必要とするヒーローセクション、カード、マイクロインタラクション
- スプリング物理、自然な動き、アクセシビリティを必要とするプロジェクト
❌ 使用しないケース:
- CSSのみのトランジション(ネイティブの
transitionプロパティを使用) - JavaScriptフレームワークなしの静的サイト
- Vueプロジェクト(
motion-vパッケージを使用 - APIが異なる) - SVG/Canvasの複雑なアニメーション(GSAPが適切)
- フォーム専用CRUDアプリ(過剰)
ワークフロー: 明確化 → 計画 → 実装 → 検証
ステップ1: 要件の明確化
プロジェクトのコンテキストとアニメーションの目標を決定します:
- フレームワーク(React 19+, Next.js 15+, Svelte 5+, Astro 4+)
- アニメーションの種類(エントランス、ジェスチャー、スクロール、レイアウト)
- デザインの目標(控えめ、目立つ、遊び心、プロフェッショナル)
- パフォーマンスの制約(対象デバイス、バンドル制限、アクセシビリティ要件)
- トリガーメカニズム(マウント、ビューポート、ユーザー操作)
ステップ2: アニメーション戦略の計画
実装アプローチを定義します:
- アニメーションを適用するコンポーネント(ヘッダー、カード、ボタン、セクション)
- モーションパターン(フェード、スライド、スケール、スプリング、パララックス)
- タイミング仕様(継続時間、遅延、スタガー間隔)
- 物理パラメータ(剛性: 300-400、減衰: 20、質量: 1)
- アクセシビリティフォールバック(prefers-reduced-motion 代替案)
ステップ3: 段階的な実装
アニメーションを段階的に構築します:
- セットアップ: Motion.devのインストール、インポートの設定、コンポーネント構造の準備
- コアアニメーション: モーションプロパティの適用(initial、animate、transition)
- 洗練: タイミング、イージングカーブ、スプリング物理の調整による自然な動作の実現
- アクセシビリティ: モーション低減検出、キーボードナビゲーションサポートの追加
- 最適化: GPUアクセラレーションの確認、バンドルサイズの最小化、パフォーマンステスト
ステップ4: 品質基準の検証
要件に対するチェック:
- パフォーマンス: 60fps以上(Chrome DevTools → Performanceタブ)
- レイアウト安定性: CLS = 0(Lighthouse監査)
- アクセシビリティ: prefers-reduced-motionを尊重(システム設定テスト)
- キーボードナビゲーション: すべてのインタラクティブ要素がキーボードでアクセス可能
- モバイル対応: タッチフレンドリーなジェスチャー、iOS/Androidでテスト
アニメーションパターン決定木
INPUT: 何をアニメーションさせるか?
├─ エントランス(ページ読み込み、マウント)
│ → パターン: initial={{opacity: 0, y: 20}} animate={{opacity: 1, y: 0}}
│ → タイミング: 0.6-0.8s、ease: [0.22, 1, 0.36, 1]
│ → スタガー: 要素間0.1-0.2s
│ → 例: ./examples/hero-fade-up.md
│
├─ ジェスチャー(ホバー、タップ、ドラッグ)
│ → パターン: whileHover={{scale: 1.05}}、whileTap={{scale: 0.95}}
│ → 物理: スプリング(剛性: 300-400、減衰: 20)
│ → タイミング: 即時応答(継続時間なし)
│ → 例: ./examples/card-hover.md、./examples/magnetic-button.md
│
├─ スクロール(表示、パララックス)
│ → パターン: whileInView + viewport または useScroll + useTransform
│ → トリガー: viewport={{once: true、amount: 0.3}}
│ → パフォーマンス: Transform/opacityのみ
│ → 例: ./examples/scroll-reveal.md、./examples/parallax-layers.md
│
└─ レイアウト(並び替え、展開)
→ パターン: layoutプロパティ(自動FLIP)
→ 共有: モーフィング用の layoutId="id"
→ 注意: トランスフォームのみアニメーション
APIクイックリファレンス
| コンポーネント/フック | 使用法 | 使用場面 |
|---|---|---|
| motion.div | <motion.div animate={{x: 100}}> | 基本アニメーション |
| whileHover | whileHover={{scale: 1.05}} | ホバー状態(0.2-0.3s) |
| whileTap | whileTap={{scale: 0.95}} | クリックフィードバック |
| whileInView | whileInView={{opacity: 1}} | スクロール表示 |
| drag | drag="x" dragConstraints | ドラッグ可能要素 |
| layout | <motion.div layout /> | 自動FLIPアニメーション |
| useScroll | スクロール進行度の追跡 | パララックス、プログレスバー |
| useTransform | 値のマッピング | スクロールリンクエフェクト |
| useSpring | スプリング物理 | スムーズな値の変更 |
| useInView | ビューポート検出 | アニメーションのトリガー |
完全なAPI: APIリファレンス全文 を参照
フレームワーク統合
| フレームワーク | インポート | コンポーネント | 終了アニメーション |
|---|---|---|---|
| React/Next.js | "motion/react" | <motion.div> | <AnimatePresence> |
| Svelte | "motion" | Vanilla API | N/A |
| Astro | "motion" | クライアントスクリプト | N/A |
| Vue | "motion-v" | <motion.div> | Reactと同様 |
品質基準
| カテゴリ | 要件 | 確認方法 |
|---|---|---|
| パフォーマンス | 60fps以上 | Chrome DevTools → Performance |
| GPUアクセラレーション | transform/opacityのみ | width/height/left/top を使用しない |
| バンドル | 50KB未満 | webpack-bundle-analyzer |
| アクセシビリティ | prefers-reduced-motion | システム設定テスト |
| モバイル | タッチフレンドリー | iOS/Androidテスト |
| レイアウトシフト | CLS = 0 | Lighthouse監査 |
サンプルライブラリ(プログレッシブローディング)
アニメーションの種類に基づいてオンデマンドで読み込みます:
ヒーローセクション
- ヒーローフェードアップ - クラシックなAppleスタイルのエントランス
- ヒーロースタガー - 調整された要素
- ヒーロースプリットテキスト - 文字の表示
スクロールエフェクト
- スクロール表示 - Intersection Observerフェードイン
- パララックスレイヤー - マルチスピードの奥行き
- スクロール進行度 - 読書インジケーター
ジェスチャーとインタラクション
- カードホバー - エレガントな浮き上がり+影
- マグネティックボタン - カーソル追従
- ドラッグカルーセル - タッチスライダー
レイアウトアニメーション
- リスト並び替え - ドラッグで並び替えFLIP
- アコーディオン - 展開/折りたたみ
- タブ切り替え - 共有レイアウト
全サンプル: ./examples/ ディレクトリ内の全ファイル
リファレンスドキュメント(オンデマンド読み込み)
- APIリファレンス全文 - 全コンポーネント、フック、プロパティ
- スプリング物理ガイド - 剛性、減衰、質量の調整
- パフォーマンス最適化 - GPU、will-change、遅延読み込み
- アクセシビリティガイド - モーション低減、キーボード、スクリーンリーダー
- トラブルシューティング - 一般的な問題と解決策
- Framer Motion移行ガイド - アップグレードガイド
テンプレート(プロダクション対応)
- Next.jsページテンプレート - ヒーロー+機能+お客様の声
- コンポーネントライブラリ - 10以上の再利用可能コンポーネント
- スクロールテンプレート - パララックス+表示パターン
- ダッシュボードテンプレート - インタラクティブカード、チャート
インストール
# React/Next.js/Svelte/Astro
npm install motion
# Vue
npm install motion-v
共通パターン(コピーペースト対応)
パターン1: フェードアップエントランス
<motion.div
initial={{ opacity: 0, y: 20 }}
animate={{ opacity: 1, y: 0 }}
transition={{ duration: 0.6, ease: [0.22, 1, 0.36, 1] }}
/>
パターン2: ホバーカード
<motion.div
whileHover={{ y: -8, boxShadow: "0 20px 40px rgba(0,0,0,0.12)" }}
transition={{ type: "spring", stiffness: 300, damping: 20 }}
/>
パターン3: スクロール表示
<motion.div
initial={{ opacity: 0, y: 50 }}
whileInView={{ opacity: 1, y: 0 }}
viewport={{ once: true, amount: 0.3 }}
/>
その他のパターン: スタガーリスト、終了アニメーション、レイアウトトランジション → ./examples/ ディレクトリ
エラーハンドリング
| 問題 | 解決策 |
|---|---|
| アニメーションがトリガーしない | initial ≠ animate の値を確認 |
| パフォーマンスが悪い | transform/opacityのみ + will-change CSSを使用 |
| レイアウトシフト | 明示的な寸法を設定、layoutプロパティを使用 |
| 終了が機能しない | <AnimatePresence> でラップ、keyプロパティを追加 |
実装のベストプラクティス
- シンプルに始める → フェード+スライドから構築し、徐々に複雑性を追加
- バリアントを抽出する → アニメーション状態を名前付きバリアントとして定義し、保守性を向上
- スプリング物理を優先 → スプリングトランジションをデフォルトに(トゥイーンより自然)
- リスト項目をスタガー → staggerChildren(0.1-0.2s)を使用してリズムと階層を表現
- モバイルを徹底的にテスト → iOS/Androidデバイスでタッチジェスチャーとパフォーマンスを確認
- モーション低減を含める → 常に prefers-reduced-motion フォールバックアニメーションを提供
- パフォーマンスをプロファイリング → Chrome DevTools Performanceタブを使用、60fps以上を目標
デザイン哲学(Apple/Jon Iveの原則)
以下のデザイン原則をすべてのアニメーションに適用:
- シンプルさ: 200-400msの継続時間を使用し、同時動作を最小限に抑え、transformプロパティを優先
- 自然な物理: スプリングベースのトランジションを実装し、線形イージングを避け、質量ベースの動きを適用
- 目的主導の動き: ユーザーの注意を誘導し、インタラクションフィードバックを提供し、視覚的階層を確立
- エレガントな抑制: 「少ないほど豊か」の原則を適用し、一貫したタイミングを維持し、ユーザーのモーション設定を尊重
検証
構造化出力の検証については、以下を参照:
- Motion Config Schema - JSONスキーマ
- 検証スクリプト - 自動チェック
メタデータ
バージョン: 3.0.0(研究に基づく最適化) 最適化: 命令型言語、少数ショットパターン(3例)、階層化された複雑性、プログレッシブローディング トークン効率: コア部分を87%削減(15K → 2K)+ 自動キャッシュ Motion.dev: v11+ フレームワーク: React 19+、Next.js 15+、Svelte 5+、Astro 4+、Vue 3+ 研究: arXiv 2402.07927v1、2211.01910、2310.14735v5、PubMed 40334089 ライセンス: MIT