跳转至

减少动效设计规范

{
  "paths": ["packages/core/src/**"]
}

用户意图

请求设备减少动效的人,仍能看到 Astryx 显示的每一个变化,但不会发生位移、缩放或弹性效果。在触屏上,变化采用交叉淡化,正如 iOS 在“减少动效”(Reduce Motion)与“首选交叉淡化”(Prefer Cross-Fade)下的做法;但原位数值变化以及悬停或选中颜色除外,它们会立即生效;使用鼠标、触控板或键盘时,变化是即时的。

设计原则

  • DR1 — 减少动效下无位移。 当用户偏好减少动效(prefers-reduced-motion: reduce)时,由核心组件进行动画的过渡——包括入场、离场、展示内容之间的切换或状态变化——MUST NOT 移动、缩放、调整大小或弹性运动其内容。DR2 和 DR3 规定了每种指针设备分别获得怎样的呈现。

结构分解与层级

角色 用途 必需关系
起始状态 变化前用户看到的内容 不移动地离开
目标状态 变化后用户看到的内容 出现在最终的位置、大小和顺序
交叉淡化 在触屏上连接两个状态 仅改变不透明度,200 毫秒或更短
直接移动 用户用手移动的内容 跟随指针或手指,抛出后继续滑行(DR2);这不是一种过渡

状态呈现

状态 必需呈现 允许的变体
减少动效,粗指针 仅不透明度的交叉淡化,200 毫秒或更短(DR2);原位数值和颜色立即生效(DR2) 更短的交叉淡化
减少动效,任何其他指针 即时变化(DR3),触摸拖动释放时除外(DR2) 无
无减少动效偏好,主题为 'system' 本记录范围之外 组件与主题动效
主题为 'always'(DR2a) 无论用户设置如何,均如同减少动效 DR1–DR3

响应式与输入行为

  • DR2 — 触摸呈现进行交叉淡化。 在减少动效下,当主要指针为粗指针(pointer: coarse),或触摸拖动的释放触发了该过渡时,每个 DR1 过渡 MUST 仅改变不透明度,并且 MUST 在 200 毫秒或更短时间内完成。进入的元素在最终位置出现并淡入;离开的元素在原地淡出。释放后继续抛掷的动量、衰减滑行及其在边缘的停稳,属于直接移动,不进行交叉淡化,如同 iOS 减少动效下滚动持续减速一样。组件在释放时启动的过渡,例如吸附到卡位、关闭或分页到目标,仍然交叉淡化。原生滚动属于浏览器,不受影响;Astryx 在抛掷后自行动画的滑行,在减少动效下的表现与原生动量一致。原位数值变化,例如进度填充的长度或其他连续值,不进行交叉淡化:在减少动效下,它在任何指针上都立即生效,不附加任何元素(DEC-3)。控件的悬停或选中颜色,例如 SelectableCard 的选中边框和圆环,同样在任何指针上都立即生效,与 iOS 相同(DEC-4)。其按压颜色的出现也是如此。随交叉淡化部分一同变化的颜色,遵循该交叉淡化,例如 Switch 的轨道随滑块一起(component:Switch FR15)。触摸按压的释放保持 200 毫秒或更短的淡化。
  • DR2a — 主题可以为所有人减少动效。 主题的 reducedMotion: 'always' 对每个人都应用 DR1–DR3,无论其设置如何;'system' 则跟随每个人的设置(spec:AST-108)。没有任何主题选项会放宽 DR1–DR4。
  • DR3 — 精细指针呈现即时变化。 在减少动效下,当主要指针不是粗指针时,所有其他 DR1 过渡 MUST 立即完成,且不动画任何属性。
  • DR4 — 核心中不提供退出选项。 核心组件、其 props 及其主题值不提供任何方式在减少动效下保留位移、缩放、弹性或更长的动画,并且组件自身的动效设置不会覆盖 DR1–DR3。

在拖动过程中,随用户自己的指针或手指移动的内容作为直接操作跟随其移动,不属于 DR1 过渡;继续抛掷的动量同样不在此列(DR2)。当触摸拖动被释放时组件启动的过渡,例如滑动的手指滑动后一行滑出或弹回(spec:AST-057 FR5),按 DR2 所述进行交叉淡化,因为是由手指启动的;由触控板启动的过渡,在粗主要指针上遵循 DR2,其他情况下遵循 DR3。任何其他过渡,例如一个面板将控制权移交给另一个面板(component:BottomSheetSwitcher FR3),在粗主要指针上遵循 DR2,其他情况下遵循 DR3。

无障碍意图

减少动效移除的是运动,而非信息。用户仍能感知到某物出现、离开或发生了变化,结果与没有该偏好时相同。焦点和播报保持不变。

代表性示例

  • 在手机上开启减弱动态(Reduce Motion)时,通过轻点打开的菜单会在落点处淡入,而不是滑入或缩放进入。
  • 在手机上开启减弱动态时,通过轻点呈现的底部抽屉会在其静止高度淡入,而不是从底部边缘升起。
  • 在减弱动态并使用鼠标时,Tooltip、Popover 或 Dialog 会在单帧内出现和消失。

视觉参考

未包含规范性资源文件。

  • spec:AST-057 FR5 为滑动行的滑出、回弹和保持打开实现 DR2 和 DR3。
  • component:BottomSheetSwitcher FR3 和 ORD1 为抽屉之间的过渡实现 DR2 和 DR3。

验证

契约 验证 代表性状态 失败信号
DR1、DR2 减弱动态、粗指针下的真实浏览器计算动画 图层进入与退出(Tooltip、Popover、菜单); Dialog;模态 BottomSheet;一次呈现切换 动画化的 transform、尺寸或位置;弹簧;opacity 之外的属性;超过 200 ms;没有交叉淡化的变化
DR2 动量 减弱动态下触摸甩动之后的真实浏览器计算动画 一次拂动后滑行并在边缘停下;一次释放后吸附到挡位、关闭或翻页到目标 滑行被交叉淡化取代或在释放时停止;吸附、关闭或翻页以位移方式完成而非交叉淡化
DR2 数值 减弱动态下粗指针与细指针的真实浏览器计算动画 确定状态的 ProgressBar 的填充条以及另一个就地变化的连续数值 在减弱动态下,数值发生动画、交叉淡化或添加元素,均视为失败
DR2 颜色 减弱动态下粗指针与细指针的真实浏览器计算动画 Button 的按压起始;ClickableCard、SelectableCard 和 Thumbnail 的悬停、边框和选中颜色 悬停或选中颜色、或按压起始发生动画或交叉淡化;触摸释放的淡出超过 200 ms
DR1、DR3 减弱动态、细指针下的真实浏览器计算动画 相同的组件 任何动画属性,或变化被部分应用的帧
DR4 组件属性与主题审查,加上上述浏览器检查 设置了 motion 属性或主题 motion 值的组件 在减弱动态下恢复位移或延长动画的属性或主题值

决策日志

DEC-1 — 减弱动态与 iOS 一致:触摸时交叉淡化,其余情况立即变化

参考: design:reduced-motion/DEC-1 决策者: cixzhang,2026-10-24

在触摸设备上开启减弱动态的用户期望看到平台行为:变化以交叉淡化而非移动的方式呈现,淡化让变化无需位移也依然醒目。使用细指针时变化立即发生,因此既没有移动,也没有等待。每个核心组件都遵循同一条规则,没有任何组件能够保留其动画,这意味着该偏好会在所有地方以相同方式得到尊重。

已拒绝:在减弱动态下保留完整动画的按组件设置。

DEC-2 — 甩动后的动量继续,与 iOS 一致

参考: design:reduced-motion/DEC-2 决策者: cixzhang,2026-10-24

在 iOS 减弱动态下,被拂动的滚动视图会继续滑行并在边缘停下;只有应用启动的过渡会变为交叉淡化。与此保持一致,让甩动感觉像是用户自己的动作,并避免内容在释放时骤然停止;而由组件启动的吸附、关闭和翻页在 DR2 下仍会交叉淡化。

已拒绝:在释放时交叉淡化或停止动量。

DEC-3 — 就地数值变化立即生效

参考: design:reduced-motion/DEC-3 决策者: cixzhang,2026-10-26

进度填充的长度及类似的连续数值在当前所在位置变化;在两个长度之间进行交叉淡化需要第二个元素,并且仍会表现出移动。在减弱动态下,无论何种指针,都会立即采用新数值。

已拒绝:在触摸屏上对旧值和新值进行交叉淡化。

DEC-4 — 仅颜色的状态变化立即生效

参考: design:reduced-motion/DEC-4 决策者: cixzhang,2026-11-03;配套条款,依据负责人的动画规则(2026-11-04)

控件的悬停颜色、选中颜色以及按压颜色的起始都发生在原位置,且不会移动任何元素,因此减弱动态没有需要从它们身上移除的内容。在减弱动态下,无论何种指针,它们都会立即采用新颜色,这与 iOS 的做法一致,也与就地数值的变化方式一致(DEC-3)。随某个交叉淡化部件一起变化的颜色,例如 Switch 的轨道随着其滑块变化,会跟随该交叉淡化,因此两者永远不会显示不同的状态。触摸按压的释放保留其 200 ms 或更短的淡出,以此确认这次点击。

已拒绝:在触摸屏上对悬停或选中颜色进行交叉淡化。

未决问题

无。

内容边界

本记录定义用户在减弱动态下看到的内容。它不定义减弱动态之外的时长或缓动、token、CSS 属性、动画 API、连续状态指示器(如 spinner),也不定义审计检查。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx