使用 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. 进入/退出动画
import { AnimatePresence } from 'motion/react';
<AnimatePresence>
{show && <motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }} exit={{ opacity: 0 }} />}
</AnimatePresence>;
动画属性
变换(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。弹簧动画会变为瞬时过渡。
性能优化建议
- 尽量只动画 transforms/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',
}}
/>
Toast 通知:
<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 文档: https://motion.dev/docs/react
- Motion 示例: https://motion.dev/examples(100+ 免费示例)
- GitHub 仓库: https://github.com/motiondivision/motion
- 扩展资源: 参见
resources.md获取精选 animation.dev 课程和资料
快速故障排查
动画未运行?
- 检查元素是否条件渲染(使用 AnimatePresence)
- 确认目标值与初始值不同
- 检查 CSS 是否覆盖(例如
!important)
性能问题?
- 坚持使用 transforms 和 opacity
- 使用
layout属性代替动画尺寸 - 检查浏览器 DevTools Performance 面板
布局动画闪烁?
- 确保父容器有
position: relative - 如需,对父容器和子容器都添加
layout - 检查是否有冲突的 CSS 过渡
注意事项
- Motion 基于 MIT 许可,生产就绪
- 混合引擎:120fps,GPU 加速
- 内置 TypeScript 支持
- 支持 tree-shaking,优化打包体积
- 兼容 React 18+(包括 Suspense)