动效设计规范
动效设计规范¶
用户意图¶
动效应阐明发生了什么变化以及内容来自何处,同时不应让界面显得夸张做作或拖沓迟缓。在减少动效的情况下,每一次状态变化都应保持可理解。
设计原则¶
- DR1 — 动效承载意义。 动画 MUST 解释响应、连续性、进入、退出或空间变化,而非装饰原本静态的内容。
- DR2 — 体量决定时长。 小型局部反馈应当比大型进入、退出或持续运动显得更快。
- DR3 — 运动自然平息。 缓动应当传达受控的减速,而非装饰性的回弹或弹性;主题的表现特性仅可在进入和移动时过冲(
spec:AST-108)。 - DR4 — 稳定内容保持稳定。 动效应避免不必要的布局扰动,并保留阅读和交互语境。
- DR5 — 减少动效保留意义。 每个动画过渡 MUST 具有一种即时或极小运动的形态,以传达相同的状态变化。
design:reduced-motion负责当前的减少动效规则。
构成与层级¶
| 角色 | 目的 | 必需关系 |
|---|---|---|
| 起始状态 | 确立正在变化的内容 | 在连续性明确之前保持可识别 |
| 过渡提示 | 连接起始与目标状态 | 仅使用解释该变化所需的运动 |
| 目标状态 | 显示完成后的结果 | 稳定下来,不残留装饰性活动 |
| 减少动效路径 | 无需位移即可传达相同结果 | 在需要处保留时序与状态含义 |
状态呈现¶
悬停和按压使用最轻量的有效响应;进入和退出可以使用更明显的过渡;大型或持续的运动需要更强的用户理由。加载和状态 MUST 在没有动画的情况下保持可理解。
响应式与输入行为¶
源 wiki 未在上述原则之外确立响应式路径、中断或特定于输入的运动规则。除下文的悬停显示规则外,这些问题仍留待单独依据证据进行决策。
悬停显示延迟¶
悬停显示交互是指支持悬停的指针所揭示、显示或展开的任何内容:工具提示、悬停卡片、悬停打开的菜单或浮出面板、悬停时揭示内容的容器、预览,或悬停时打开的弹出框。
- 进入延迟。 悬停显示交互 MUST 在渲染或更新前等待一小段延迟,这样指针扫过触发器时不会导致过早渲染或更新。界面的所有者选择默认延迟;其记录可以将延迟设为零,并附上理由(
architecture:interaction-modalityINV11)。 - 退出保护。 离开触发器 MUST NOT 让内容闪烁消失:内容会一直保留,直到短暂的退出延迟结束;对于容器揭示,则直到其淡出完成,这样移出再移回会被视为一次悬停。在
prefers-reduced-motion: reduce下,容器揭示的淡出是即时的(design:reduced-motionDR3),因此其内容会立即消失。 - 指针特定。 键盘焦点立即揭示,无需停留。悬停门控绝不会延迟触摸或粗指针输入;点击是否打开界面由其所有者决定(
architecture:interaction-modalityINV4)。 - 组内移交。 在一组触发器中,指针从一个已打开的触发器移到下一个时,下一个会立即显示;进入延迟仅适用于首次打开(
architecture:interaction-modalityINV11)。 - 默认开启;可调节。 延迟与保护默认开启,每个所有者设置自己的默认值。计时驱动的界面(工具提示、悬停卡片、悬停打开的菜单或浮出面板)将它们以
delay和hideDelay(毫秒)形式暴露;调用方仅在说明用例的情况下缩短或移除它们。容器揭示将其时序保留在 CSS 中;调用方通过hoverDelay选择启用其进入延迟,而其退出淡出没有选项。
悬停显示界面的清单及其默认值:
| 界面 | 进入延迟 | 退出保护 | 符合情况 |
|---|---|---|---|
Tooltip |
开启,delay |
hideDelay,否则由悬停桥接 |
是 |
HoverCard |
开启,delay |
开启,hideDelay |
是 |
TopNavMenu |
开启,delay |
开启,hideDelay |
是 |
TopNavMegaMenu |
开启,delay |
开启,hideDelay |
是 |
DropdownMenu 子菜单 |
开启,无选项 | 开启,无选项 | 部分符合:无 delay 或 hideDelay 选项 |
SideNavItem 折叠浮出面板 |
开启,无选项 | 开启,无选项 | 部分符合:无 delay 或 hideDelay 选项 |
TopNavHeading 菜单 |
首次打开无延迟,无选项 | 开启,无选项 | 不符合:首次打开没有进入延迟(缺口,FR5) |
SideNavHeading 菜单 |
首次打开时无延迟,且无选项 | 启用,且无选项 | 否:首次打开没有进入延迟(缺口,FR5) |
Slider 值工具提示 |
无(delay 设为零) |
启用 | 否:零延迟且没有记录原因 |
带 showOn="hover" 的 Overlay |
无,且无选项 | 退出淡出,减少动效下立即 | 否:没有进入延迟 |
容器显现(Thumbnail、TreeList 行) |
可选加入 | 退出淡出,减少动效下立即 | 部分符合:进入延迟为可选加入 |
| Markdown 标题链接 | 无(module:Markdown/headingLinks AR3) |
退出淡出,减少动效下立即 | 部分符合:AR3 中记录了零延迟,但没有原因 |
被列为不符合的表面是其所有者需要填补的缺口,或需要用已记录的使用场景来证明其合理性;本记录不改变其已发布行为。
验证¶
| 契约 | 验证 | 代表性状态 | 失败信号 |
|---|---|---|---|
| DEC-1 | 使用假计时器对工具提示、悬停卡片和菜单的时序进行单元测试 | 在延迟时间内刷入和刷出;停留超过延迟;在防护时间内离开并重新进入 | 内容在延迟结束前被渲染,或在防护期间被移除 |
| DEC-1 | 容器显现的真实浏览器测试 | 停留;刷过;离开;减少动效 | 内容在停留前显现,或在减少动效下出现淡出 |
| DEC-1 | 真实浏览器键盘和粗指针测试 | 焦点在内;手指放在触发器上 | 焦点显现前有任何停留;对触摸应用悬停延迟 |
| DEC-1 | 证据缺口:在 INV11 识别器构建完成之前,不存在组交接测试 | 在组中从一个打开的触发器移动到下一个;首次打开 | — |
| DEC-1 | 对新的或更改的悬停显示表面进行清单审查 | 上述每个表面 | 一个没有进入延迟且没有记录使用场景的表面 |
可访问性意图¶
动效不得成为感知状态、层级或完成度的必要条件。减少动效应抑制不必要的移动,同时保留反馈。动画内容不应反复分散阅读或输入时的注意力。
代表性示例¶
- 按下的控件立即响应,不会引发装饰性移动。
- 表面的进入过程说明新内容所属的位置,然后安静地稳定下来。
- 减少动效模式在无需空间移动的情况下显示相同的完成状态。
视觉参考¶
不包含规范性资产。微交互、进入/退出和减少动效的配对资产应在提升之前添加到 docs/design/assets/motion/ 下。
组件契约链接¶
- 上述清单中的每个表面拥有自己的延迟和防护值;
architecture:interaction-modalityINV11 拥有悬停意图机制。
决策日志¶
本记录从公开的 Design Conventions wiki 中提炼动效意图,而不复制持续时间值、CSS 属性或审计机制。有一点已决定:
DEC-1 — 每次悬停显示交互都经过防抖¶
参考: design:motion/DEC-1
决策者: cixzhang,2026-10-11;delay 和 hideDelay 选项,2026-11-06
每次悬停显示交互都需要一个短暂延迟,以防止指针刷过时过早渲染和更新,并且需要一个退出防护,以免内容闪烁消失。延迟的存在是为了防止用户在移动指针时刷过界面导致卡顿的重新渲染;这是输入处理,而不是动效品味。键盘焦点立即显现,粗指针不受门控。默认启用;调用者仅针对明确说明的使用场景选择退出。由计时器驱动的悬停表面(工具提示、悬停卡片、悬停打开的菜单和浮出层)将等待时间公开为 delay,将退出防护公开为 hideDelay(毫秒),正如 Tooltip、HoverCard 和 TopNavMenu 已经做的那样。在一组触发器中,指针从一个打开的触发器移动到下一个时,会立即显示下一个(architecture:interaction-modality INV11)。本决策否决了移除表面默认延迟的做法:它牺牲了指针防护,却对已经立即看到内容的键盘或触屏用户没有任何好处。
未决问题¶
- OQ1 — 参考过渡。 哪些组件交互应作为局部、进入/退出和大幅移动的规范性示例?
- OQ2 — 中断与重排。 哪些要求应约束反转、取消、替换或响应式重排活动过渡?
- OQ3 — 允许的表现性动效。 哪些产品场景(如果有)能证明超出功能连续性的刻意表现性处理是合理的?
内容边界¶
本文件定义动效意图与悬停显示规则。它不定义持续时间或缓动令牌、CSS 属性、动画 API、其他组件行为或审计检查。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx