Motion Dev 动画
Motion.dev - 月下载量超 1000 万,Framer Motion 的继承者 为 React、Next.js、Svelte、Astro、Vue 提供 120fps GPU 加速动画
目的
使用 Motion.dev 生成符合 Apple/Jon Ive 原则的生产级动画: 有目的性(服务于功能)| 流畅(120fps)| 无障碍(减少动效)| 高性能(仅 GPU)| 优雅(微妙)| 一致(统一时序)
何时使用
✅ 适用场景:
- React 19+/Next.js 15+/Svelte 5+/Astro 4+ 动画实现
- 滚动效果(视差、揭示)、手势(悬停、拖拽、点击)、布局动画
- 需要 60fps+ 性能的 Hero 区块、卡片、微交互
- 需要弹簧物理、自然动效、无障碍性的项目
❌ 不适用场景:
- 纯 CSS 过渡(使用原生
transition属性) - 无 JavaScript 框架的静态网站
- Vue 项目(使用
motion-v包 - 不同 API) - SVG/Canvas 复杂动画(GSAP 更适合)
- 纯表单 CRUD 应用(过度使用)
工作流:澄清 → 规划 → 实现 → 验证
步骤 1:澄清需求
确定项目上下文和动画目标:
- 框架(React 19+、Next.js 15+、Svelte 5+、Astro 4+)
- 动画类型(入场、手势、滚动、布局)
- 设计目标(微妙、突出、趣味、专业)
- 性能约束(目标设备、包大小限制、无障碍要求)
- 触发机制(挂载、视口、用户交互)
步骤 2:规划动画策略
定义实现方法:
- 要动画化的组件(标题、卡片、按钮、区块)
- 动效模式(淡入、滑动、缩放、弹簧、视差)
- 时序规格(持续时间、延迟、交错间隔)
- 物理参数(刚度:300-400、阻尼:20、质量:1)
- 无障碍降级(prefers-reduced-motion 替代方案)
步骤 3:分阶段实现
逐步构建动画:
- 设置:安装 Motion.dev,配置导入,准备组件结构
- 核心动画:应用动效属性(initial、animate、transition)
- 细化:调整时序、缓动曲线、弹簧物理以达到自然效果
- 无障碍:添加减少动效检测、键盘导航支持
- 优化:验证 GPU 加速、减少包大小、测试性能
步骤 4:验证质量标准
根据要求检查:
- 性能:≥60fps(Chrome DevTools → Performance 选项卡)
- 布局稳定性:CLS = 0(Lighthouse 审计)
- 无障碍:遵循 prefers-reduced-motion(系统设置测试)
- 键盘导航:所有交互元素可通过键盘访问
- 移动端响应:触摸友好手势,已在 iOS/Android 上测试
动画模式决策树
INPUT: 哪些元素需要动画?
├─ 入场(页面加载、挂载)
│ → 模式:initial={{opacity: 0, y: 20}} animate={{opacity: 1, y: 0}}
│ → 时序:0.6-0.8s, ease: [0.22, 1, 0.36, 1]
│ → 交错:元素之间 0.1-0.2s
│ → 示例:./examples/hero-fade-up.md
│
├─ 手势(悬停、点击、拖拽)
│ → 模式:whileHover={{scale: 1.05}}, whileTap={{scale: 0.95}}
│ → 物理:Spring(刚度:300-400、阻尼:20)
│ → 时序:即时响应(无持续时间)
│ → 示例:./examples/card-hover.md、./examples/magnetic-button.md
│
├─ 滚动(揭示、视差)
│ → 模式:whileInView + viewport 或 useScroll + useTransform
│ → 触发:viewport={{once: true, amount: 0.3}}
│ → 性能:仅 transform/opacity
│ → 示例:./examples/scroll-reveal.md、./examples/parallax-layers.md
│
└─ 布局(重排序、展开)
→ 模式:layout 属性(自动 FLIP)
→ 共享:layoutId="id" 用于变形
→ 注意事项:仅动画化 transforms
API 快速参考
| 组件/钩子 | 用法 | 何时使用 |
|---|---|---|
| motion.div | <motion.div animate={{x: 100}}> | 基础动画 |
| whileHover | whileHover={{scale: 1.05}} | 悬停状态(0.2-0.3s) |
| whileTap | whileTap={{scale: 0.95}} | 点击反馈 |
| whileInView | whileInView={{opacity: 1}} | 滚动揭示 |
| drag | drag="x" dragConstraints | 可拖拽元素 |
| layout | <motion.div layout /> | 自动 FLIP 动画 |
| useScroll | 跟踪滚动进度 | 视差、进度条 |
| useTransform | 映射值 | 滚动联动效果 |
| useSpring | 弹簧物理 | 平滑值变化 |
| useInView | 视口检测 | 触发动画 |
完整 API:详见 完整 API 参考
框架集成
| 框架 | 导入 | 组件 | 退出动画 |
|---|---|---|---|
| React/Next.js | "motion/react" | <motion.div> | <AnimatePresence> |
| Svelte | "motion" | 原生 API | 不适用 |
| Astro | "motion" | 客户端脚本 | 不适用 |
| Vue | "motion-v" | <motion.div> | 与 React 类似 |
质量标准
| 类别 | 要求 | 验证方式 |
|---|---|---|
| 性能 | ≥60fps | Chrome DevTools → Performance |
| GPU 加速 | 仅 transform/opacity | 无 width/height/left/top |
| 包大小 | <50KB | webpack-bundle-analyzer |
| 无障碍 | prefers-reduced-motion | 系统设置测试 |
| 移动端 | 触摸友好 | iOS/Android 测试 |
| 布局偏移 | CLS = 0 | Lighthouse 审计 |
示例库(渐进式加载)
根据动画类型按需加载:
Hero 区块
- Hero 淡入上升 - 经典 Apple 风格入场
- Hero 交错 - 编排元素
- Hero 文字分割 - 字符揭示
滚动效果
手势与交互
布局动画
- 列表重排序 - 拖拽重排序 FLIP
- 手风琴 - 展开/折叠
- 标签切换 - 共享布局
完整示例:./examples/ 目录下所有文件
参考文档(按需加载)
- 完整 API 参考 - 所有组件、钩子、属性
- 弹簧物理指南 - 调整刚度、阻尼、质量
- 性能优化 - GPU、will-change、懒加载
- 无障碍指南 - 减少动效、键盘、屏幕阅读器
- 故障排查 - 常见问题与解决方案
- Framer Motion 迁移 - 升级指南
模板(生产就绪)
- Next.js 页面模板 - Hero + 特性 + 推荐
- 组件库 - 10 个以上可复用组件
- 滚动模板 - 视差 + 揭示模式
- 仪表板模板 - 交互式卡片、图表
安装
# React/Next.js/Svelte/Astro
npm install motion
# Vue
npm install motion-v
常用模式(可直接复制使用)
模式 1:淡入上升入场
<motion.div
initial={{ opacity: 0, y: 20 }}
animate={{ opacity: 1, y: 0 }}
transition={{ duration: 0.6, ease: [0.22, 1, 0.36, 1] }}
/>
模式 2:悬停卡片
<motion.div
whileHover={{ y: -8, boxShadow: "0 20px 40px rgba(0,0,0,0.12)" }}
transition={{ type: "spring", stiffness: 300, damping: 20 }}
/>
模式 3:滚动揭示
<motion.div
initial={{ opacity: 0, y: 50 }}
whileInView={{ opacity: 1, y: 0 }}
viewport={{ once: true, amount: 0.3 }}
/>
更多模式:交错列表、退出动画、布局过渡 → ./examples/ 目录
错误处理
| 问题 | 解决方案 |
|---|---|
| 动画未触发 | 检查 initial ≠ animate 值 |
| 性能差 | 仅使用 transform/opacity + will-change CSS |
| 布局偏移 | 设置显式尺寸,使用 layout 属性 |
| 退出动画不工作 | 包裹 <AnimatePresence>,添加 key 属性 |
实现最佳实践
- 从简开始 → 从淡入 + 滑动构建,逐步增加复杂性
- 提取变体 → 将动画状态定义为命名的变体以便维护
- 优先使用弹簧物理 → 默认使用弹簧过渡(比 tweens 更自然)
- 列表项交错 → 使用 staggerChildren(0.1-0.2s)来实现节奏和层次
- 充分测试移动端 → 在 iOS/Android 设备上验证触摸手势和性能
- 包含减少动效 → 始终提供 prefers-reduced-motion 降级动画
- 分析性能 → 使用 Chrome DevTools Performance 选项卡,目标 ≥60fps
设计理念(Apple/Jon Ive 原则)
将这些设计原则应用于所有动画:
- 简洁:使用 200-400ms 持续时间,最小化并发动效,优先使用 transform 属性
- 自然物理:实现基于弹簧的过渡,避免线性缓动,应用基于质量的运动
- 有目的的动作:引导用户注意力,提供交互反馈,建立视觉层次
- 优雅克制:应用“少即是多”原则,保持一致的时序,尊重用户动效偏好
验证
关于结构化输出验证,请参见:
- Motion 配置 Schema - JSON schema
- 验证脚本 - 自动检查
元数据
版本:3.0.0(研究驱动优化) 优化:命令式语言、少样本模式(3 个示例)、层次复杂性、渐进式加载 Token 效率:核心缩减 87%(15K → 2K)+ 自动缓存 Motion.dev:v11+ 框架:React 19+、Next.js 15+、Svelte 5+、Astro 4+、Vue 3+ 研究:arXiv 2402.07927v1、2211.01910、2310.14735v5、PubMed 40334089 许可证:MIT