モーションシステム v4.2 は何をしますか?
React / Next.js向けの本番環境対応UIモーションシステム。
パフォーマンス、アクセシビリティ、ユーザビリティに重点を置いています — 単なる装飾ではありません。
使用するタイミング
このモーションシステムは、モーションが以下の目的を持つ場合に使用します:
- 注意を誘導する(例:オンボーディング、主要なアクション)
- 状態を伝達する(読み込み中、成功、エラー、遷移)
- 空間的な連続性を維持する(レイアウト変更、ナビゲーション)
適切なシナリオ
- インタラクティブコンポーネント(ボタン、モーダル、メニュー)
- 状態遷移(読み込み中 → 読み込み完了、開く → 閉じる)
- ナビゲーションとレイアウトの連続性(共有要素、クロスフェード)
考慮事項
- アクセシビリティ: 常に動きの抑制(reduced motion)をサポートする
- デバイス適応: 低スペック端末に合わせて調整する
- パフォーマンスのトレードオフ: 視覚的な滑らかさよりも応答性を優先する
モーションを使用すべきでない場面
- 純粋に装飾目的である場合
- ユーザビリティや明瞭さを損なう場合
- パフォーマンスに悪影響を及ぼす場合
仕組み
基本原則
モーションは以下の役割を果たさなければなりません:
- 注意を誘導する
- 状態を伝達する
- 空間的な連続性を維持する
どれも満たさない場合 → 削除します。
インストール
npm install motion
バージョン
motion/react- Motion for React プロジェクトのデフォルト(パッケージ:motion)framer-motion- Framer Motion に依存するプロジェクト向けの従来のインポートパス
混在させないでください。 混在させると、内部スケジューラが競合し、AnimatePresence のコンテキストが壊れます。一方のパッケージのコンポーネントは、もう一方のパッケージのコンポーネントと exit アニメーションを連携できなくなります。
プロジェクトがどのバージョンを使用しているかを確認するには:
cat package.json | grep -E '"motion"|"framer-motion"'
常に一貫して1つのソースからインポートします:
// 正しい(モダン)
import { motion, AnimatePresence } from "motion/react"
// 正しい(従来)
import { motion, AnimatePresence } from "framer-motion"
// 同じプロジェクト内で両方を混在させないでください
モーショントークン
// motionTokens.ts
export const motionTokens = {
duration: {
fast: 0.18,
normal: 0.35,
slow: 0.6
},
// これらを `transition` オブジェクト内の `ease` 値として使用します:
// transition={{ duration: motionTokens.duration.normal, ease: motionTokens.easing.smooth }}
easing: {
smooth: [0.22, 1, 0.36, 1] as [number, number, number, number],
sharp: [0.4, 0, 0.2, 1] as [number, number, number, number]
},
distance: {
sm: 8,
md: 16,
lg: 24
}
}
使用例:
import { motionTokens } from "@/lib/motionTokens"
<motion.div
initial={{ opacity: 0, y: motionTokens.distance.md }}
animate={{ opacity: 1, y: 0 }}
transition={{
duration: motionTokens.duration.normal,
ease: motionTokens.easing.smooth
}}
/>
パフォーマンスルール
安全
- transform
- opacity
避けるべきもの
- width / height
- top / left
ルール: 応答性 > 滑らかさ
デバイス適応
このヒューリスティックは、CPUコア数 と 使用可能メモリを組み合わせて、より信頼性の高いシグナルを得ます。deviceMemory は Chrome/Android で利用可能です。フォールバックは Safari と Firefox をカバーします。
const isLowEnd =
typeof navigator !== "undefined" && (
// メモリが少ない(Chrome/Androidのみ。それ以外は未定義 → 十分な性能とみなす)
(navigator.deviceMemory !== undefined && navigator.deviceMemory <= 2) ||
// コア数が少なく、かつメモリAPIがない(Safari/Firefoxの低性能ハードウェアをカバー)
(navigator.deviceMemory === undefined && navigator.hardwareConcurrency <= 4)
)
const duration = isLowEnd ? 0.2 : 0.4
アクセシビリティ
JS (useReducedMotion)
import { motion, useReducedMotion } from "motion/react"
export function FadeIn() {
const reduce = useReducedMotion()
return (
<motion.div
initial={{ opacity: 0, y: reduce ? 0 : 24 }}
animate={{ opacity: 1, y: 0 }}
/>
)
}
CSS
@media (prefers-reduced-motion: reduce) {
.motion-safe-transition {
transition: opacity 0.2s;
}
.motion-reduce-transform {
transform: none !important;
}
}
Tailwind
<div class="motion-safe:animate-fade motion-reduce:opacity-100"></div>
アーキテクチャとパターン
コアパターン
| シナリオ | パターン |
|---|---|
| ホバーフィードバック | whileHover |
| タップ / 押下フィードバック | whileTap |
| スクロールに応じた表示 | whileInView |
| スクロール連動値 | useScroll + useTransform |
| 条件付きマウント/アンマウント | AnimatePresence |
| 小さなレイアウトシフト(単一要素、~300px未満の変化) | layout プロパティ |
| 大きなレイアウトシフトやページ全体のリフロー | layout を避け、CSS トランジションやページレベルルーティングを使用 |
| 複雑な命令型シーケンス | useAnimate |
なぜ大きなコンテナで
layoutを避けるべきか? Framer のレイアウトアニメーションはtransformを使用して位置を調整しますが、ビューポート全体にまたがる要素や深いリフローを引き起こす要素では、計測コストが原因で目に見えるジャンクや CLS が発生します。代わりに、CSS Grid/Flexbox のトランジションを使用するか、特定の子要素にlayoutIdを指定して連携させることを推奨します。
レイアウトとトランジション
- 共有要素トランジション →
layoutId(マウントされたインスタンスごとに一意である必要があります) - Enter / Exit トランジション →
AnimatePresence(以下のmodeガイダンスを参照)
AnimatePresence mode
常に mode を明示的に指定してください。デフォルト("sync")は enter と exit を同時に実行するため、ほとんどの UI パターンで視覚的な重複が発生します。
mode | 使用する場面 |
|---|---|
"wait" | Exit が完了してから Enter が開始されます。モーダル、トースト、ページトランジション に使用します。 |
"sync"(デフォルト) | Enter と exit が重なります。重複が意図的な場合のみ使用します(例:クロスフェードカルーセル)。 |
"popLayout" | Exit する要素は即座にフローから除外され、残りの要素がそのスペースを埋めるようにアニメーションします。リスト、タブ、非表示可能なカード に使用します。 |
// モーダル — 常に "wait" を使用
<AnimatePresence mode="wait">
{open && <Modal key="modal" />}
</AnimatePresence>
// 非表示可能なリストアイテム — "popLayout" を使用
<AnimatePresence mode="popLayout">
{items.map(item => <Card key={item.id} />)}
</AnimatePresence>
高度なパターン(概念)
- パララックス(スクロール連動トランスフォーム)
- スクロールストーリーテリング(スティッキーセクション)
- 3Dチルト(ポインタ連動トランスフォーム)
- クロスフェード(共有
layoutId) - プログレッシブリビール(クリップパス)
- スケルトンローディング(ループする不透明度)
- マイクロインタラクション(ホバー/タップフィードバック)
- スプリングシステム(物理ベースのモーション)
モーダルの必須事項
- フォーカストラップ
- Escape キーで閉じる
- スクロールロック
- ARIA ロール
AnimatePresence mode="wait"を使用して、exit アニメーションが完了してから次のモーダルが入るようにする
完全な例
import React, { useEffect, useRef, useState } from "react"
import { motion, AnimatePresence } from "motion/react"
function useFocusTrap(ref: React.RefObject<HTMLDivElement | null>, active: boolean) {
useEffect(() => {
if (!active || !ref.current) return
const el = ref.current
const focusable = el.querySelectorAll<HTMLElement>(
'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])'
)
const first = focusable[0]
const last = focusable[focusable.length - 1]
function handleKey(e: KeyboardEvent) {
if (e.key !== "Tab") return
if (e.shiftKey && document.activeElement === first) {
e.preventDefault()
last?.focus()
} else if (!e.shiftKey && document.activeElement === last) {
e.preventDefault()
first?.focus()
}
}
el.addEventListener("keydown", handleKey)
first?.focus()
return () => el.removeEventListener("keydown", handleKey)
}, [active, ref])
}
function useScrollLock(active: boolean) {
useEffect(() => {
if (!active) return
const prev = document.body.style.overflow
document.body.style.overflow = "hidden"
return () => { document.body.style.overflow = prev }
}, [active])
}
function Modal({ open, closeModal }: { open: boolean; closeModal: () => void }) {
const ref = useRef<HTMLDivElement>(null)
useFocusTrap(ref, open)
useScrollLock(open)
useEffect(() => {
function onKey(e: KeyboardEvent) {
if (e.key === "Escape") closeModal()
}
if (open) window.addEventListener("keydown", onKey)
return () => window.removeEventListener("keydown", onKey)
}, [open, closeModal])
return (
// mode="wait" により、exit アニメーションが完了してから新しいモーダルが入ることを保証する
<AnimatePresence mode="wait">
{open && (
<motion.div
role="dialog"
aria-modal="true"
aria-labelledby="modal-title"
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
exit={{ opacity: 0 }}
transition={{ duration: 0.2 }}
className="fixed inset-0 flex items-center justify-center bg-black/40"
>
<motion.div
ref={ref}
initial={{ scale: 0.95, opacity: 0 }}
animate={{ scale: 1, opacity: 1 }}
exit={{ scale: 0.95, opacity: 0 }}
transition={{ duration: 0.2, ease: [0.22, 1, 0.36, 1] }}
className="bg-white p-6 rounded"
>
<h2 id="modal-title">ダイアログタイトル</h2>
<button onClick={closeModal}>閉じる</button>
</motion.div>
</motion.div>
)}
</AnimatePresence>
)
}
export function Example() {
const [open, setOpen] = useState(false)
return (
<>
<button onClick={() => setOpen(true)}>開く</button>
<Modal open={open} closeModal={() => setOpen(false)} />
</>
)
}
SSR セーフティ
- サーバーとクライアントのレンダリング間で初期状態を一致させる
- 暗黙のアニメーション起点を避ける(常に
initialを明示的に設定する) - Next.js App Router では motion コンポーネントを
"use client"でラップする
デバッグ
チェック項目:
- インポートの誤り(
motion/reactとframer-motionの混在) - Next.js App Router での
"use client"ディレクティブの欠落 AnimatePresenceの子要素のkeyプロパティの欠落- ハイドレーションの不一致(SSR とクライアントで初期状態が異なる)
- 大きなコンテナでの
layoutプロパティの誤用によるリフローのジャンク - 状態駆動型アニメーションがトリガーされない(依存配列を確認)
QA(品質保証)
- CLS(累積レイアウトシフト)がないこと
- キーボード操作が機能すること
- モーダル内でフォーカスがトラップされていること
- ARIA ロールが正しいこと(
role="dialog"、aria-modal="true") - 動きの抑制(reduced motion)が尊重されていること(
useReducedMotion+ CSS メディアクエリ) - Next.js でハイドレーションの警告が出ないこと
- アンマウント時にアニメーションがクリーンに停止すること(メモリリークがないこと)
- すべての使用箇所で
AnimatePresenceのmodeが明示的に設定されていること
アンチパターン
- レイアウトプロパティ(
width、height、top、left)のアニメーション - 目的のない無限アニメーション(常に問いかける:これはどのような状態を伝えるのか?)
- リストの過度なステガリング(
staggerChildrenは ≤ 0.1秒に保つ。それを超えると遅く感じられる) - 動きの抑制設定を無視すること
- 大きなコンテナやビューポート全体のコンテナで
layoutを使用すること AnimatePresenceでmodeを省略すること(デフォルトの"sync"は視覚的な重複を引き起こす)- 純粋に装飾目的でモーションを使用すること
哲学
モーションはインタラクションデザインです。
最終ルール
モーションが UX を向上させない場合 → 削除する。
例
ボタンインタラクション
import { motion } from "motion/react"
export function Button() {
return (
<motion.button
whileHover={{ scale: 1.02 }}
whileTap={{ scale: 0.97 }}
transition={{ duration: 0.15, ease: [0.4, 0, 0.2, 1] }}
>
クリックしてください
</motion.button>
)
}
動きの抑制の例
import { motion, useReducedMotion } from "motion/react"
export function FadeIn() {
const reduce = useReducedMotion()
return (
<motion.div
initial={{ opacity: 0, y: reduce ? 0 : 24 }}
animate={{ opacity: 1, y: 0 }}
transition={{ duration: reduce ? 0.1 : 0.35, ease: [0.22, 1, 0.36, 1] }}
/>
)
}
ステガーリスト
import { motion } from "motion/react"
const container = {
hidden: {},
visible: {
transition: { staggerChildren: 0.08 } // 鈍さを避けるため ≤ 0.1秒に保つ
}
}
const item = {
hidden: { opacity: 0, y: 10 },
visible: { opacity: 1, y: 0, transition: { duration: 0.3, ease: [0.22, 1, 0.36, 1] } }
}
export function List() {
return (
<motion.ul variants={container} initial="hidden" animate="visible">
{[1, 2, 3].map(i => (
<motion.li key={i} variants={item}>アイテム {i}</motion.li>
))}
</motion.ul>
)
}
AnimatePresence を使用したモーダル
import { motion, AnimatePresence } from "motion/react"
export function Modal({ open }: { open: boolean }) {
return (
<AnimatePresence mode="wait">
{open && (
<motion.div
initial={{ opacity: 0, scale: 0.95 }}
animate={{ opacity: 1, scale: 1 }}
exit={{ opacity: 0, scale: 0.95 }}
transition={{ duration: 0.2, ease: [0.22, 1, 0.36, 1] }}
/>
)}
</AnimatePresence>
)
}
スクロールパララックス
import { useScroll, useTransform, motion } from "motion/react"
export function Parallax() {
const { scrollYProgress } = useScroll()
const y = useTransform(scrollYProgress, [0, 1], [0, -80])
return <motion.div style={{ y }} />
}
スケルトンローディング
import { motion } from "motion/react"
export function Skeleton() {
return (
<motion.div
className="bg-gray-200 h-6 w-full rounded"
animate={{ opacity: [0.5, 1, 0.5] }}
transition={{
duration: 1.5, // 快適なパルス — 以前は欠落しており、高速なフラッシュを引き起こしていました
repeat: Infinity,
ease: "easeInOut"
}}
/>
)
}
共有レイアウト(クロスフェード)
import { motion } from "motion/react"
// layoutId はマウントされたインスタンスごとに一意である必要があります。
// 複数のインスタンスが同時に存在できる場合は、一意のIDを追加します:
// layoutId={`shared-${item.id}`}
export function Shared() {
return <motion.div layoutId="shared" />
}