加入動畫(強制)
每個元件都必須包含 Framer Motion 動畫。
APEX 工作流程
階段 0:分析現有動畫
任務: 探索程式碼庫
提示: "找出現有的 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}>項目 1</motion.div>
<motion.div variants={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-100 毫秒 | ease-out |
| 按壓按鈕 | 100-150 毫秒 | ease-out |
| 開啟模態框 | 200-300 毫秒 | ease-out |
| 頁面轉場 | 300-400 毫秒 | 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 動畫:
references/design/05-add-motion.md - 動畫模式:
references/motion-patterns.md