Motionによるアニメーション実装
すべてのアニメーション作業には Motion ライブラリ (https://motion.dev) を使用します。
クイックスタート
React (プライマリ):
import { motion } from "motion/react"
// 基本アニメーション
<motion.div animate={{ opacity: 1, y: 0 }} />
// トランジション設定付き
<motion.div
animate={{ x: 100 }}
transition={{ type: "spring", stiffness: 100 }}
/>
コアパターン
1. スプリング物理 (推奨)
<motion.div
animate={{ scale: 1 }}
transition={{
type: 'spring',
stiffness: 260,
damping: 20,
}}
/>
スプリングプリセット:
- 優しい (Gentle):
stiffness: 120, damping: 14 - ふわふわ (Wobbly):
stiffness: 180, damping: 12 - 硬い (Stiff):
stiffness: 300, damping: 20
2. ジェスチャー操作
<motion.div
whileHover={{ scale: 1.05 }}
whileTap={{ scale: 0.95 }}
drag="x"
dragConstraints={{ left: -100, right: 100 }}
/>
3. レイアウトアニメーション
<motion.div layout>{/* 位置やサイズが変わるコンテンツ */}</motion.div>
4. スクロール連動エフェクト
import { useScroll, useTransform } from "motion/react"
const { scrollYProgress } = useScroll()
const opacity = useTransform(scrollYProgress, [0, 1], [1, 0])
<motion.div style={{ opacity }} />
5. 子要素のスタガー表示
<motion.ul
variants={{
visible: { transition: { staggerChildren: 0.07 } },
}}
>
{items.map((item) => (
<motion.li
key={item}
variants={{
hidden: { opacity: 0, y: 20 },
visible: { opacity: 1, y: 0 },
}}
/>
))}
</motion.ul>
6. Enter/Exit アニメーション
import { AnimatePresence } from 'motion/react';
<AnimatePresence>
{show && <motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }} exit={{ opacity: 0 }} />}
</AnimatePresence>;
アニメーションプロパティ
Transform (GPU高速化、パフォーマンス良好):
x, y, z- 移動scale, scaleX, scaleY- 拡大縮小rotate, rotateX, rotateY, rotateZ- 回転skew, skewX, skewY- 歪み
Visual (控えめに使用、パフォーマンスに影響する可能性あり):
opacitybackground, backgroundColorcolorborderRadius
SVG固有:
pathLength- パス描画アニメーション用pathOffset- パスのオフセットpathSpacing- ダッシュ間の間隔
アクセシビリティ
常にユーザーの設定を尊重:
<motion.div
animate={{ x: 100 }}
transition={{
type: 'spring',
// ユーザーが動きを減らす設定の場合、アニメーションを無効化
duration: 0,
}}
/>
Motion は自動的に prefers-reduced-motion を処理します。スプリングは瞬時にトランジションになります。
パフォーマンスのヒント
- 可能な限り transform/opacity のみをアニメーション (GPU高速化)
layoutプロパティ を使用し、width/height を手動でアニメーションしない- スクロール中のアニメーション は可能な限り避ける
- 複雑なアニメーションには
will-change: transformを使用 (Motion が処理) - 同時アニメーション数を制限 - 一度にすべて表示する代わりにスタガー表示
設計原則 (簡易版)
アニメーションを適用すべきタイミング
- 状態遷移 (読み込み中 → 成功)
- 空間変化 (ビューの出入り)
- 注意を引く (控えめに)
- ユーザー操作の確認
アニメーションを避けるべきタイミング
- 最初の発生以降の繰り返し操作
- パフォーマンスが重要なパス
- ユーザー制御のスクロール
- すべての操作 (抑制が重要)
タイミングガイドライン
- マイクロインタラクション: 150-250ms
- パネル/モーダルのトランジション: 200-300ms
- ページトランジション: 300-500ms
- スプリング: 物理演算に継続時間を委ねる
スプリング vs 継続時間
- スプリングを使用: インタラクティブ要素、ジェスチャー、レイアウト変更
- 継続時間を使用: 意図的なシーケンス、振り付け、ローダー
詳細なアニメーション哲学については principles.md を参照。
一般的なパターン
読み込み中状態:
<motion.div
animate={{ rotate: 360 }}
transition={{
repeat: Infinity,
duration: 1,
ease: 'linear',
}}
/>
トースト通知:
<motion.div
initial={{ x: 400, opacity: 0 }}
animate={{ x: 0, opacity: 1 }}
exit={{ x: 400, opacity: 0 }}
transition={{ type: 'spring', stiffness: 300, damping: 30 }}
/>
ドロワー:
<motion.div
initial={{ x: '-100%' }}
animate={{ x: 0 }}
exit={{ x: '-100%' }}
transition={{ type: 'spring', damping: 25 }}
/>
アコーディオン:
<motion.div
animate={{ height: isOpen ? 'auto' : 0 }}
transition={{ type: 'spring', bounce: 0 }}
style={{ overflow: 'hidden' }}
/>
リソース
- Motion ドキュメント: https://motion.dev/docs/react
- Motion サンプル: https://motion.dev/examples (100以上の無料サンプル)
- GitHub リポジトリ: https://github.com/motiondivision/motion
- その他のリソース: 厳選された animation.dev レッスンと保管庫については
resources.mdを参照
クイックトラブルシューティング
アニメーションが動作しない?
- 要素が条件付きレンダリングされているか確認 (AnimatePresence を使用)
- 目標値が初期値と異なることを確認
- 上書きするCSSがないか確認 (例:
!important)
パフォーマンスの問題?
- transform と opacity に限定
- 寸法をアニメーションする代わりに
layoutプロパティを使用 - ブラウザの DevTools パフォーマンス タブを確認
レイアウトアニメーションがちらつく?
- 親要素に
position: relativeを設定 - 必要に応じて親子両方に
layoutを追加 - 競合するCSSトランジションがないか確認
注意事項
- Motion は MIT ライセンス、本番環境対応済み
- ハイブリッドエンジン: 120fps、GPU高速化
- TypeScript サポート組み込み
- ツリーシェイク可能で最適なバンドルサイズ
- React 18+ で動作 (Suspense 含む)