移行ガイド：Framer Motion から Motion への変更点と対応策

2025年8月30日

Motion

Web開発の世界では、アニメーションライブラリも日々進化しています。これまでReactアプリケーションのアニメーション実装で多くの開発者に愛用されてきたFramer Motionが、新たにMotionという次世代ライブラリに生まれ変わりました。

この移行は単なるアップデートではありません。パフォーマンスの大幅な向上、よりシンプルなAPI設計、そしてWeb標準への準拠といった重要な改良が加えられています。既存のFramer Motionプロジェクトをお持ちの方にとって、この移行は新しい可能性を開く重要なステップとなるでしょう。

背景

Framer Motion の現状と課題

Framer Motionは2019年のリリース以来、Reactエコシステムにおいてアニメーション実装の標準的な選択肢として広く採用されてきました。その柔軟性と豊富な機能により、多くの開発者が複雑なアニメーションを比較的簡単に実装できるようになりました。

しかし、長年の運用により以下のような課題が明らかになりました。

mermaidflowchart TD
  framer[Framer Motion] -->|課題1| bundle[バンドルサイズの増大]
  framer -->|課題2| perf[パフォーマンスのボトルネック]
  framer -->|課題3| api[複雑化したAPI]
  bundle --> impact[アプリケーションの重量化]
  perf --> slow[アニメーションの遅延]
  api --> learn[学習コストの増大]

上記の図が示すように、機能の充実に伴いライブラリ自体が重くなり、特にモバイルデバイスでのパフォーマンスに影響を与えるケースが増えています。

Motion 登場の経緯

これらの課題を根本的に解決するため、Framer社は全く新しいアプローチでMotionライブラリを開発しました。Motionは以下の3つの核となる設計思想に基づいています。

#	設計思想	内容
1	パフォーマンス第一	Web Animations APIの活用によるネイティブレベルの高速化
2	シンプルなAPI	必要最小限の機能に絞り込んだ直感的なインターフェース
3	軽量化	バンドルサイズを従来の50%以下に削減

移行の必要性

現在のFramer Motionプロジェクトをお持ちの開発者の方々にとって、Motionへの移行は以下の理由から重要な検討事項となります。

パフォーマンス向上の恩恵: アニメーション処理がメインスレッドから分離され、よりスムーズな動作を実現できます。特にモバイルデバイスでの体験向上は顕著です。

将来性の確保: Framer社のリソースは今後Motionの開発に集中されるため、長期的なサポートと新機能の恩恵を受けるためには移行が必要です。

開発効率の向上: シンプルになったAPIにより、新しいチームメンバーの学習コストが削減され、開発スピードの向上が期待できます。

課題

既存コードの互換性問題

Motionへの移行で最も大きな課題となるのが、既存のFramer Motionコードとの互換性です。API設計が根本的に見直されたため、多くの部分で書き換えが必要になります。

以下は主要な互換性の問題点です。

mermaidflowchart LR
  old[Framer Motion API] -->|変更| new[Motion API]
  old --> variants[variants システム]
  old --> gestures[ジェスチャーハンドリング]  
  old --> layout[レイアウトアニメーション]
  new --> simple[シンプルなプロパティ指定]
  new --> hooks[Hooksベースの制御]
  new --> auto[自動最適化]

重要な変更点:

variantsシステムの廃止
イベントハンドラーの命名規則変更
一部のアニメーションプロパティの統合

パフォーマンスの課題

移行プロセス中に発生する可能性のあるパフォーマンス課題も考慮が必要です。

段階的移行時の問題: Framer MotionとMotionを同時に使用する期間中は、一時的にバンドルサイズが増大します。この期間をできるだけ短縮するための計画が重要になります。

アニメーション処理の違い: Motion は Web Animations API を活用するため、従来のRAF（RequestAnimationFrame）ベースの処理とは動作が異なります。既存のタイミングに依存したコードの調整が必要な場合があります。

API の変更点による影響

最も具体的な課題として、API変更による既存コードへの影響があります。

型定義の変更: TypeScriptプロジェクトでは、プロパティの型定義が変更されているため、コンパイルエラーが発生する可能性があります。

設定方法の変更: アニメーションの設定方法が簡略化されたことで、従来の詳細な制御が一部制限される場合があります。

解決策

Motion の新機能とメリット

Motionが提供する新機能を理解することで、移行によるメリットを最大限に活用できます。

以下の図は、Motionの主要な改善点を示しています。

mermaidstateDiagram-v2
  [*] --> Optimization: Motion の最適化
  Optimization --> WebAPI: Web Animations API 活用
  Optimization --> Bundle: バンドルサイズ削減
  Optimization --> Simple: API の簡素化
  
  WebAPI --> Native: ネイティブ性能
  Bundle --> Fast: 高速ロード
  Simple --> Easy: 開発効率向上
  
  Native --> [*]: 改善されたUX
  Fast --> [*]: 改善されたUX  
  Easy --> [*]: 改善されたUX

主要な新機能:

自動最適化機能: アニメーションの種類を自動判別し、最適な実行方法を選択
改良されたスプリングアニメーション: より自然な動きを少ないコードで実現
インライン設定: 複雑な設定オブジェクトが不要になり、直感的な記述が可能

段階的移行アプローチ

大規模なプロジェクトでの移行を成功させるため、以下の段階的アプローチを推奨します。

#	フェーズ	期間目安	作業内容
1	準備・調査	1-2週間	既存コードの調査、影響範囲の特定
2	新機能開発	2-3週間	新規機能はMotionで実装
3	部分移行	3-4週間	独立性の高いコンポーネントから移行
4	全面移行	2-3週間	残りのコンポーネントを一括移行
5	最適化	1週間	パフォーマンスチューニング

フェーズ1: 準備・調査での重要なポイントは、既存コードでFramer Motionがどのように使われているかを正確に把握することです。

移行時の注意点

移行を円滑に進めるための重要な注意点をご紹介します。

テスト環境での十分な検証: 特にアニメーションタイミングに依存した処理がある場合は、本番環境に近い条件での動作確認が不可欠です。

ユーザビリティの維持: 移行によりアニメーションの挙動が変わる可能性があるため、エンドユーザーの体験に影響がないか慎重にチェックしましょう。

チーム内での情報共有: API の変更点について、開発チーム全体での理解を統一することで、移行後のメンテナンスがスムーズになります。

具体例

インストールと設定変更

まずは基本的なインストールと設定の変更から始めましょう。

パッケージの追加:

javascript// Motionのインストール
yarn add motion

既存のFramer Motionの削除:

javascript// 段階的移行完了後に実行
yarn remove framer-motion

基本的なインポート文の変更:

Framer Motionでの書き方：

javascriptimport { motion, AnimatePresence } from 'framer-motion'

Motionでの書き方：

javascriptimport { motion, AnimatePresence } from 'motion/react'

インポート文の変更だけでも、バンドルサイズの削減効果を実感できます。

基本的なアニメーション実装の比較

シンプルなフェードインアニメーションの実装を比較してみましょう。

Framer Motion での実装:

javascript// コンポーネントの定義
const FadeInComponent = () => {
  return (
    <motion.div
      initial={{ opacity: 0 }}
      animate={{ opacity: 1 }}
      exit={{ opacity: 0 }}
      transition={{ duration: 0.5 }}
    >
      <h2>フェードインするコンテンツ</h2>
    </motion.div>
  )
}

Motion での実装:

javascript// よりシンプルな記述で同じ効果を実現
const FadeInComponent = () => {
  return (
    <motion.div
      animate={{ opacity: [0, 1] }}
      transition={{ duration: 0.5 }}
    >
      <h2>フェードインするコンテンツ</h2>
    </motion.div>
  )
}

Motionでは、initialとanimateを個別に指定する代わりに、配列記法で開始値から終了値までを一括指定できます。

スプリングアニメーションの改良:

Framer Motionでのスプリング設定：

javascriptconst SpringBox = () => {
  return (
    <motion.div
      animate={{ x: 100 }}
      transition={{
        type: "spring",
        stiffness: 100,
        damping: 10
      }}
    >
      移動するボックス
    </motion.div>
  )
}

Motionでの簡略化されたスプリング設定：

javascriptconst SpringBox = () => {
  return (
    <motion.div
      animate={{ x: 100 }}
      transition={{ type: "spring" }} // 自動で最適なパラメータを選択
    >
      移動するボックス
    </motion.div>
  )
}

複雑なアニメーション移行例

より実践的な例として、カードコンポーネントのホバーアニメーションの移行を見てみましょう。

Framer Motion版（移行前）:

javascript// variantsシステムを使った複雑な設定
const cardVariants = {
  rest: { 
    scale: 1, 
    rotateY: 0,
    transition: { duration: 0.3 }
  },
  hover: { 
    scale: 1.05, 
    rotateY: 5,
    transition: { duration: 0.3 }
  }
}

const CardComponent = () => {
  return (
    <motion.div
      className="card"
      variants={cardVariants}
      initial="rest"
      whileHover="hover"
    >
      <h3>製品カード</h3>
      <p>商品の詳細説明</p>
    </motion.div>
  )
}

Motion版（移行後）:

javascript// よりダイレクトで理解しやすい記述
const CardComponent = () => {
  return (
    <motion.div
      className="card"
      whileHover={{ 
        scale: 1.05, 
        rotateY: 5,
        transition: { duration: 0.3 }
      }}
    >
      <h3>製品カード</h3>
      <p>商品の詳細説明</p>
    </motion.div>
  )
}

リスト項目の順次表示アニメーション:

Framer Motionでの実装：

javascriptconst ListAnimation = ({ items }) => {
  const containerVariants = {
    hidden: { opacity: 0 },
    visible: {
      opacity: 1,
      transition: {
        staggerChildren: 0.1
      }
    }
  }

  const itemVariants = {
    hidden: { y: 20, opacity: 0 },
    visible: { y: 0, opacity: 1 }
  }

  return (
    <motion.ul
      variants={containerVariants}
      initial="hidden"
      animate="visible"
    >
      {items.map((item, index) => (
        <motion.li key={index} variants={itemVariants}>
          {item}
        </motion.li>
      ))}
    </motion.ul>
  )
}

Motionでの実装：

javascriptconst ListAnimation = ({ items }) => {
  return (
    <motion.ul>
      {items.map((item, index) => (
        <motion.li
          key={index}
          animate={{ 
            y: [20, 0], 
            opacity: [0, 1] 
          }}
          transition={{ 
            delay: index * 0.1,
            duration: 0.3
          }}
        >
          {item}
        </motion.li>
      ))}
    </motion.ul>
  )
}

エラー対応とデバッグ

移行過程でよく発生するエラーとその対処法をご紹介します。

型エラーの対処:

TypeScript環境では以下のようなエラーが発生する可能性があります。

typescript// エラーコード: TS2322
// Property 'variants' does not exist on type 'MotionProps'

// 対処法: variantsを使わない記述に変更
// Before (エラーが発生)
<motion.div variants={cardVariants} />

// After (修正後)
<motion.div whileHover={{ scale: 1.1 }} />

アニメーションが動作しない場合:

javascript// 問題: CSSプロパティのコンフリクト
// 解決法: CSS側のtransitionプロパティを削除またはMotionで上書き

const FixedComponent = () => {
  return (
    <motion.div
      style={{ transition: 'none' }} // CSS側のtransitionを無効化
      animate={{ x: 100 }}
      transition={{ duration: 0.5 }}
    >
      正しくアニメーションするコンテンツ
    </motion.div>
  )
}

パフォーマンス問題のデバッグ:

javascript// Motion でのパフォーマンス最適化
const OptimizedComponent = () => {
  return (
    <motion.div
      animate={{ x: 100 }}
      // GPU処理を明示的に有効化
      style={{ willChange: 'transform' }}
      // 不要な再レンダリングを防ぐ
      transition={{ duration: 0.5 }}
    >
      最適化されたアニメーション
    </motion.div>
  )
}