アニメーション追加(必須)
すべてのコンポーネントにFramer Motionアニメーションを必ず実装すること。
APEX WORKFLOW
フェーズ0:既存アニメーションの分析
Task: explore-codebase
Prompt: "既存のFramer Motionパターンを探す:バリアント、タイミング、
イージング、ホバー効果。アニメーションの慣例を報告する。"
ルール: 既存のアニメーションパターンに準拠するか、移行を提案すること。
標準パターン
コンテナ+スタッガー(必須)
import { motion } from "framer-motion";
const container = {
hidden: { opacity: 0 },
show: { opacity: 1, transition: { staggerChildren: 0.1 } }
};
const item = {
hidden: { opacity: 0, y: 20 },
show: { opacity: 1, y: 0 }
};
<motion.div variants={container} initial="hidden" animate="show">
<motion.div variants={item}>Item 1</motion.div>
<motion.div variants={item}>Item 2</motion.div>
</motion.div>
ホバー効果(必須)
// カードホバー
<motion.div whileHover={{ y: -4 }} transition={{ duration: 0.2 }}>
// ボタンホバー
<motion.button
whileHover={{ scale: 1.02 }}
whileTap={{ scale: 0.98 }}
>
スクロールアニメーション
<motion.div
initial={{ opacity: 0, y: 40 }}
whileInView={{ opacity: 1, y: 0 }}
viewport={{ once: true, margin: "-100px" }}
/>
タイミングガイドライン
| インタラクション | 持続時間 | イージング |
|---|---|---|
| ホバー | 50-100ms | ease-out |
| ボタン押下 | 100-150ms | ease-out |
| モーダル開く | 200-300ms | ease-out |
| ページ遷移 | 300-400ms | ease-in-out |
禁止事項
// ❌ ランダムなバウンスループ
animate={{ y: [0, -10, 0] }}
transition={{ repeat: Infinity }}
// ❌ 過剰なエフェクト
whileHover={{ scale: 1.2, rotate: 5 }}
// ❌ 低速アニメーション
transition={{ duration: 1.5 }}
アクセシビリティ(必須)
import { useReducedMotion } from "framer-motion";
function Component() {
const shouldReduce = useReducedMotion();
return (
<motion.div
animate={shouldReduce ? {} : { y: 0 }}
transition={shouldReduce ? { duration: 0 } : { duration: 0.3 }}
/>
);
}
検証
[ ] 既存アニメーションの分析(フェーズ0)
[ ] 既存パターンに準拠または移行を提案
[ ] リスト/グリッドのスタッガー
[ ] すべてのインタラクティブ要素にホバー
[ ] prefers-reduced-motion に対応
[ ] 過剰/ランダムなアニメーションなし
参照
- APEX Motion:
references/design/05-add-motion.md - Motion Patterns:
references/motion-patterns.md