UI 运动模式
两项任务:在网页上为产品 UI 添加动画,以及在视频中重建产品 UI 而不重新设计。两者使用相同的令牌。
1. 令牌优先
一次定义运动,随处导入。组件中不出现内联数值。
// lib/motion-tokens.ts
export const motionTokens = {
duration: { instant: 0.1, fast: 0.18, normal: 0.3, slow: 0.5, scene: 0.7 },
easing: {
standard: [0.2, 0, 0, 1], // 进入 + 移动
exit: [0.4, 0, 1, 1], // 离开
emphasized: [0.3, 0, 0, 1],
},
distance: { nudge: 4, small: 8, medium: 16, large: 32 },
stagger: 0.06, // 保持介于 0.05 和 0.10 之间
} as const;
export const springs = {
press: { type: "spring", stiffness: 600, damping: 38 }, // 按钮、开关
snappy: { type: "spring", stiffness: 420, damping: 34 }, // 标签、菜单
gentle: { type: "spring", stiffness: 260, damping: 27 }, // 卡片、面板
layout: { type: "spring", stiffness: 320, damping: 30 }, // 重排、调整大小
camera: { type: "spring", stiffness: 140, damping: 20 }, // 大幅度移动,仅用于视频
} as const;
质量为 1 时,阻尼比 ζ = damping / (2·√stiffness):press 0.78,snappy 0.83,gentle 0.84,layout 0.84,camera 0.85 —— 全部落在 0.75–0.90 范围内(过冲 ≤ ~6%)。可按照该公式根据品牌进行调整,并始终将该表格作为唯一来源。
2. 无障碍与 SSR
"use client";
import { useReducedMotion } from "motion/react";
export function useSafeMotion() {
const reduce = useReducedMotion();
return {
reduce,
// 减少运动:去掉变换,保持短的透明度变化(≤0.2 s)
enter: reduce ? { opacity: 1 } : { opacity: 1, y: 0 },
initial: reduce ? { opacity: 0 } : { opacity: 0, y: 8 },
transition: reduce ? { duration: 0.2 } : undefined,
};
}
- 对首次绘制时已可见的元素使用
initial={false},以避免水合闪烁。 - 仅对
transform和opacity做动画。切勿在循环中对width、height、top、left或box-shadow做动画;改用layout或 scale。 - 低端设备:缩短持续时间并跳过装饰性动画。
3. 模式及其规则
| 模式 | 规则 |
|---|---|
| 按钮按下 | whileTap={{ scale: 0.96 }} 配合 springs.press;在 100 毫秒内提供反馈 |
| 条件渲染 | 用 AnimatePresence 包裹并赋予稳定的 key;每个 initial + animate 都需对应一个 exit |
| 页面 / 路由过渡 | AnimatePresence mode="wait":退出动画完成后才进入 |
| 列表交错 | staggerChildren 0.05–0.10 秒;交错项上限约为 8 个,其余同时出现 |
| 重排 / 调整大小 | 仅在小子树(≲5 个子元素)上使用 layout;否则使用显式 x/y |
| 模态框 / 底部弹出 | 焦点陷阱、Escape 关闭、滚动锁定、role="dialog"、aria-modal="true"、焦点返回 |
| 提示 | 从所在边缘进入;自动消失,悬停/聚焦时暂停 |
| 数字变化 | 垂直滚动:旧值向上退出并带模糊,新值从下方进入;font-variant-numeric: tabular-nums |
| 滚动揭示 | whileInView 配合 viewport={{ once: true }};滚动离开时从不重新动画 |
| 加载 → 成功 | 按钮压缩 → 旋转动画 → 对勾;保持按钮宽度稳定 |
4. 重建用于视频的产品 UI
- 测量而非猜测。 从产品源码或计算样式中获取令牌:颜色、圆角、字体族/字重/字间距、间距、图标集和描边。从真实截图中采样颜色并进行比较。
- 混合默认方案。 使用真实截图作为背景;仅重建那些会动画的元素,并在其上实现像素级对齐。
- 未经明确批准绝不重新设计。 不使用新的颜色、字体、图标或文案。
- 抓取干净内容。 使用登出账户或演示账户、虚构数据、不包含个人身份信息、除非用户拥有否则不包含第三方品牌。
- 可搜索。 在视频中,每个动画值都基于绝对时间驱动(
value = f(t)),而不是来自motion/react的运行状态。motion/react用于实时网页,闭环弹簧或 GSAP 时间轴用于渲染视频。
当这些模式用于网站而非视频时,在上线之前需通过 design-expert 验证关卡(键盘、焦点、减少运动、性能)。