添加动画(强制)
每个组件必须具有 Framer Motion 动画。
APEX 工作流
阶段 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 动效:
references/design/05-add-motion.md - 动效模式:
references/motion-patterns.md