Motion UI
基于研究的玩法指南,适用于产品 UI 动效和手势:包含 19 个模式文件,每个文件都有规则、反模式、正反示例、无障碍、令牌、实现草稿和检查清单。本文件定义了工作流程、不可妥协原则、决策表和默认令牌。打开模式文件获取详细信息。
- 模式索引:
references/INDEX.md列出每个模式及其一句话规则。 - 模式文件:
references/patterns/<前缀>-<名称>.md。前缀包括mfound(意图、节奏、编排、减少动效)、mspring(弹簧动效)、mgesture(拖拽、动量、边缘、面板、中断)、mtrans(进入/退出、空间原点、转场、微交互、滚动驱动)、mperf(性能)和mref(审查模板、反模式)。 - 入门令牌:
assets/motion-tokens.css。时长、缓动和交错名称与值匹配 dashboard-ui 的tokens.css。它在亮色和暗色模式下独立工作:它读取的 dashboard-ui 角色令牌以零特异性声明,因此 dashboard-ui 的tokens.css或项目自己的同名角色令牌无论加载顺序如何都会覆盖它们。 - 数据 UI: 对于数字补间、图表过渡、关联探索、实时重算和加载状态,请使用 dashboard-ui 的
motion-*和prog-*模式。本技能不重复它们。
工作流程
- 决定它是否应该动起来。 命名任务:反馈、连续性、导向、关注,或者(少数情况)愉悦。评估它发生的频率以及是否由键盘触发,然后根据下面的频率表选择行(
mfound-purpose-and-frequency.md)。如果没有任务,或动作是键盘驱动的或一天发生 100+ 次,则停止:无动画。 - 选择机制。
- 静止到静止和切换(菜单、对话框、开关):CSS 过渡(
mfound-durations-and-easing.md),或弹簧linear()令牌(mspring-css-linear-and-tokens.md)。 - 由手指或指针驱动,或可中断且带速度的:JS 弹簧(
mspring-parameters-and-mapping.md,mgesture-interruptibility-and-velocity.md)。 - 导航:视图过渡(
mtrans-view-transitions-and-routes.md)。 - 绑定到滚动位置的:滚动驱动动画(
mtrans-scroll-driven-animations.md)。
- 静止到静止和切换(菜单、对话框、开关):CSS 过渡(
- 从令牌设置时长。 按元素设置时长,按方向设置缓动,退出时长 = 0.75 × 进入时长,弹簧为时长加回弹。组件中不能使用原始值。
- 在空间中放置它。 在触发器处使用
transform-origin,镜像退出,保持前进和后退一致,并让永久 UI 保持静止(mtrans-spatial-origin-and-continuity.md)。对于顶层元素的进入/退出,遵循mtrans-enter-exit-top-layer.md。 - 对于手势,按顺序应用:
- 1:1 跟踪,10 px 阈值(
mgesture-direct-manipulation-drag.md); - 释放时的投影和速度(
mgesture-momentum-projection-and-snap.md); - 橡皮筋边界(
mgesture-rubber-banding-and-bounds.md); - 面板和滑动规则(
mgesture-sheets-and-swipe-to-dismiss.md)。
- 1:1 跟踪,10 px 阈值(
- 编排当几件事同时变化时:原因优先,然后是父元素,最后是子元素;交错 20–40 毫秒,有上限(
mfound-choreography-and-stagger.md)。 - 让它便宜。 仅对 transform 和 opacity 进行动画,不使用全局
will-change,并在下一帧绘制反馈(mperf-compositor-will-change-and-inp.md)。 - 编写减少动画版本作为替换而非删除(
mfound-reduced-motion-vestibular.md)。 - 从帧进行审查。
- 运行反模式检查(
mref-anti-patterns-gallery.md)。 - 捕获帧序列(慢放 4 倍、完整和减少动画,外加一次中断运行)以及页面内审计。
- 对 18 项检查清单进行评分(
mref-motion-review-rubric.md)。达到 80% 或以上且无必须项为 0 时发布。 - 报告每项发现作为 检查ID · 证据 · 修复,以及未检查的内容。
- 运行反模式检查(
不可妥协原则
只有在有书面理由时才能违反其中一条。
是否动画及多长时间
- 每个动画都有一个命名任务。键盘触发和每天 100+ 次的操作没有动画。
- 无论动画时长如何,第一个视觉响应在输入后 100 毫秒内出现。
- 时长来自令牌(100 / 150 / 240 / 400 毫秒)。UI 界面中任何内容都不超过 400 毫秒;只有极少数情况可能达到 600 毫秒。
- 进入使用 ease-out;屏幕内移动使用 ease-in-out;用户等待的任何内容不使用
ease-in。退出时长约为进入的 0.75 倍。
弹簧和手势
- 弹簧用时长 + 回弹表示。UI 界面使用回弹 0,仅在带动量的手势后使用 0.1–0.2,且绝不用于透明度、颜色或数据值。
- 拖拽元素从抓取点 1:1 跟踪指针,拖拽过程中无过渡。约 10 px 后提交拖拽。
- 释放时,捕捉到投影位置最近的定位点,并在释放速度下开始归位弹簧。
- 边缘使用橡皮筋效果;没有任何东西在手指下硬停。
- 用户能影响的所有内容都可以从其当前屏幕值中断。没有动画队列且动画期间不阻塞输入。切换 UI 使用过渡,而不是关键帧。
- 破坏性手势动作在释放时提交并提供撤销。每个手势都有一个按钮或键盘等效项(WCAG 2.5.7)。
进入、退出和导航
- 绝不从
scale(0)开始。从透明度 0 加上 scale 0.95–0.97 或 8–24 px 的位移进入,并在触发器处设置transform-origin。 - 使用
@starting-style进行进入,使用display/overlay与allow-discrete进行退出。可见的最终状态是默认值,因此不受支持的浏览器仍可工作。 - 路由过渡是渐进增强。先准备数据,再过渡。使用默认交叉淡入淡出或根据过渡类型 16–24 px 的方向偏移,命名 1-3 个共享元素,之后移动焦点。
- 弹出通知绝不应是唯一的信息来源。错误绝不自动关闭;撤销提示至少停留 8 秒,且其动作在提示外部也存在。计时器在悬停、焦点和隐藏标签时暂停(dashboard-ui
comp-notifications-alerts.md)。
性能和安全
- 仅对 transform 系列属性和 opacity 进行动画处理,对于大于小控件的元素。没有
transition: all。will-change是临时的,且仅遵循测量。 - 在
prefers-reduced-motion: reduce下,将空间动画替换为 150 毫秒或更短的淡入淡出,保留反馈,保留 1:1 拖拽跟踪,并删除回弹。绝不发布全局0.01ms的开关,JS 动画也必须尊重设置。 - 在产品 UI 中不使用视差、滚动劫持、全屏缩放或空闲循环动画。超过 5 秒的自动播放需要暂停控制,并且每秒闪烁不超过 3 次。
- 从捕获的帧审查动画,而不是从代码或记忆。
决策表
频率 → 动效 (mfound-purpose-and-frequency.md)
| 频率 | 动效 |
|---|---|
| 键盘触发,或每天 100+ 次(技能的截止点) | 无 |
| 每天几十次 | 100–150 毫秒淡入淡出,可能放大缩小;无移动,无回弹 |
| 每次会话几次 | 150–240 毫秒,可移动 8–24 px |
| 罕见(首次运行、重大成功) | 最长 400–600 毫秒,允许带回弹的弹簧 |
机制 (mspring-parameters-and-mapping.md, mspring-css-linear-and-tokens.md)
| 情况 | 使用 |
|---|---|
| 颜色、透明度、状态变化 | CSS 过渡,linear 或 ease-out |
| 可能中途反向的切换元素 | CSS 过渡(绝不使用关键帧) |
| 静止到静止的空间动画并带弹簧感 | CSS 弹簧 linear() 令牌加上其自身的时长 |
| 拖拽或轻弹后释放,或带速度的重定向 | JS 弹簧(Motion, React Spring, SwiftUI, Compose) |
| 布局变化(重排、调整大小、展开) | FLIP, Motion layout, 或视图过渡 |
| 页面或路由变化 | 视图过渡(同文档或跨文档) |
| 滚动浏览进度 | 滚动驱动动画 |
按元素的时长和缓动 (mfound-durations-and-easing.md)
| 元素 | 时长 | 曲线 |
|---|---|---|
| 按下、切换、悬停 | 100 毫秒 | ease-out(按下缩放 0.97) |
| 工具提示、菜单、弹出框 | 进入 150 毫秒 / 退出 110 毫秒 | 进入 ease-out,退出 ease-in 或淡出 |
| 对话框、弹出通知 | 进入 240 毫秒 / 退出 180 毫秒 | 进入 ease-out,退出 ease-in 或淡出 |
| 面板、抽屉 | 240–400 毫秒 | --motion-ease-drawer,或拖拽后的弹簧 |
| 容器变换(卡片 → 详情) | 400 毫秒 | 强调的 |
| 路由交叉淡入淡出 | 150–250 毫秒 | linear |
弹簧预设 (mspring-parameters-and-mapping.md)
| 令牌 | 时长 / 回弹 | 使用 |
|---|---|---|
spring-fast | 0.24 秒 / 0 | 开关、小控件 |
spring-default | 0.3 秒 / 0 | 菜单、面板归位、布局 |
spring-slow | 0.45 秒 / 0 | 全屏表面 |
spring-snappy | 0.3 秒 / 0.15 | 轻弹后释放、捕捉 |
spring-playful | 0.4 秒 / 0.3 | 仅限罕见的愉悦效果 |
库参数(Motion, React Spring, SwiftUI, Material 3)来自 mspring-parameters-and-mapping.md 中的一个公式。
手势阈值 (mgesture-*)
| 值 | 默认 |
|---|---|
| 拖拽开始 / 轴锁定 | 10 px |
| 速度采样窗口 | 100 毫秒 |
| 投影减速度 | 每毫秒 0.998(快速翻页为 0.99) |
| 轻弹提交 | > 400 px/s |
| 面板关闭 | 拖拽超过其高度的 25%,或轻弹 |
| 橡皮筋常数 | 0.55(常用近似值) |
令牌默认值
完整集在 assets/motion-tokens.css 中。
| 组 | 默认值 |
|---|---|
| 时长 | instant 0 · micro 100 · short 150 · medium 240 · long 400 毫秒 · 退出比率 0.75 |
| 缓动 | standard cubic-bezier(0.2,0,0.38,0.9) · enter (0,0,0.38,0.9) · exit (0.2,0,1,0.9) · emphasized (0.2,0,0,1) · drawer (0.32,0.72,0,1) |
| 弹簧(CSS) | --motion-spring-{fast,default,slow,snappy,playful} 以及匹配的 -dur(360 / 450 / 670 / 420 / 660 毫秒) |
| 几何 | scale-from 0.96 · press 0.97 · distance 8 / 16 / 24 px |
| 编排 | stagger 30 毫秒 · max 300 毫秒(菜单中 150 毫秒) |
| 减少动效 | 空间令牌变为 0 或 1;淡入淡出保持其时长 |
如何应用本技能
- 构建时:
- 加载
assets/motion-tokens.css,或将其映射到项目的令牌。 - 优先使用平台特性:CSS 过渡、
@starting-style、<dialog>和 popover API、视图过渡、滚动驱动动画、linear()。仅在需要手势和速度时才使用 JS 库。 - 绝不使用 TypeScript
any类型。
- 加载
- 审查时: 先捕获帧,然后运行反模式库和检查清单。按严重性顺序报告检查项、分数、证据和修复的表格,并列明未检查的内容。
- 当项目已有动效系统(M3、Carbon、自有令牌)时:以其令牌为准。将它们映射到这些角色上,并标记差距。
- 当规则冲突时: 可访问性和用户控制(减少动效、可中断性、无滚动劫持)优先于表现力,频率优先于愉悦。