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,
}}
/>
スプリングプリセット:
- 穏やか:
stiffness: 120, damping: 14 - 揺れやすい:
stiffness: 180, damping: 12 - 硬め:
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- 歪み
ビジュアル(控えめに使用、パフォーマンスに影響する可能性あり):
opacitybackground, backgroundColorcolorborderRadius
SVG固有:
pathLength- パス描画アニメーション用pathOffset- パスのオフセットpathSpacing- ダッシュ間の間隔
アクセシビリティ
常にユーザー設定を尊重:
<motion.div
animate={{ x: 100 }}
transition={{
type: 'spring',
// ユーザーが動きの低減を希望する場合、アニメーションを無効化
duration: 0,
}}
/>
Motionは自動的にprefers-reduced-motionを処理します。スプリングは即時トランジションになります。
パフォーマンスのヒント
- 可能な限りtransform/opacityのみをアニメーション化(GPUアクセラレーション)
- 手動で幅/高さをアニメーション化する代わりに**
layoutプロップを使用** - 可能な限りスクロール中のアニメーションを避ける
- 複雑なアニメーションには**
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 Docs: https://motion.dev/docs/react
- Motion Examples: https://motion.dev/examples (100以上の無料サンプル)
- GitHub Repository: https://github.com/motiondivision/motion
- 拡張リソース:
resources.mdで厳選されたanimation.devのレッスンと保管庫を参照
クイックトラブルシューティング
アニメーションが実行されない?
- 要素が条件付きでレンダリングされているか確認(AnimatePresenceを使用)
- ターゲット値が初期値と異なることを確認
- 上書きするCSS(例:
!important)がないか確認
パフォーマンスの問題?
- transformとopacityに限定
- ディメンションをアニメーション化する代わりに
layoutプロップを使用 - ブラウザDevToolsのパフォーマンスタブを確認
レイアウトアニメーションがちらつく?
- 親要素に
position: relativeがあることを確認 - 必要に応じて親と子の両方に
layoutを追加 - 競合するCSSトランジションがないか確認
注意事項
- MotionはMITライセンスで、プロダクション対応
- ハイブリッドエンジン:120fps、GPUアクセラレーション
- TypeScriptサポート組み込み
- ツリーシェイカブルでバンドルサイズ最適化
- React 18+(Suspenseを含む)で動作