跳转至

用户状态设计规范

用户意图

指针用户在按住或拖动启用的控件时,应在被操作的表面上获得即时、一致的反馈。该反馈不得暗示已禁用的控件做出了响应,也不得抹除持久选中的表面。

设计原则

  • DR1 — 按压被操作的表面。 在指针按住或拖动期间,下方矩阵中的每个启用表面 MUST 在指定的可视部分绘制 --color-overlay-pressed。该覆盖是瞬态的,MUST 在按压或拖动结束时清除。覆盖的时序遵循 spec:AST-094 FR11 在各种指针下的按压配置文件。
  • DR2 — 禁用即无响应。 矩阵中的禁用控件 MUST 保持不可操作,且 MUST NOT 获得按压视觉处理。
  • DR3 — 持久选中优先。 在指针按住期间,选中的 SegmentedControl 项 MUST 保持其凸起的选中表面;只有未选中项接收按压覆盖层。在触摸呈现方式下,该表面会抬起,如同 UISegmentedControl 的行为(component:SegmentedControl FR14);在精细主指针下,它保持不变。其按压时序遵循 spec:AST-094 FR11。

结构与层级

角色 用途 必需关系
交互目标 接收指针按住或拖动 拥有或控制矩阵中指定的绘制表面
按压覆盖层 确认当前操作 叠加在现有填充之上,不替换内容或持久状态
持久选中表面 传达已选中的分段 在指针按住期间不接收按压覆盖层;在触摸呈现方式下抬起

状态表示

组件 启用的指针按住或拖动 禁用的指针按住
CheckboxInput 指示器绘制 --color-overlay-pressed 指示器保持不变
Collapsible 触发器行绘制 --color-overlay-pressed 触发器行保持不变,且不会展开或折叠
Link 文本表面绘制 --color-overlay-pressed 文本表面保持不变,且不会激活
Slider 仅被拖动的滑块手柄绘制 --color-overlay-pressed 滑块手柄保持不变,值不会改变
Switch 轨道和滑块手柄都绘制 --color-overlay-pressed 轨道和滑块手柄保持不变,值不会改变
TabList Tab 标签页表面绘制 --color-overlay-pressed 标签页表面保持不变,选择不会改变
RadioList 指示器绘制 --color-overlay-pressed 指示器保持不变,选择不会改变
SegmentedControl 未选中项绘制 --color-overlay-pressed;选中项保持其凸起的表面,并在触摸呈现方式下抬起 项目表面保持不变,选择不会改变

此表是当前完整的声明。它不批准其他组件的按压处理,也不确定它们的状态设计。

响应式与输入行为

  • DR4 — 跟随真实交互。 受按住驱动的控件仅在指针按下时保持覆盖层。Slider 遵循其现有的拖动状态,因此覆盖层保持在正在拖动的滑块手柄上,即使拖动起始于轨道上也是如此。
  • DR5 — 保留静止结果。 释放或取消后,控件 MUST 返回到其原本会具有的相同视觉状态;按压反馈不会创建持久状态。

无障碍意图

按压反馈补充而绝不取代控件的语义状态、标签、焦点指示或禁用行为。一个以禁用状态暴露的控件必须保持不可操作,即使其实现使其可聚焦以解释其不可用的原因。

代表性示例

  • 按住启用的 CheckboxInput 行会使其指示器变暗;在未激活的情况下于外部释放会恢复原始指示器像素。
  • 拖动范围 Slider 时,仅绘制当前正在移动的滑块手柄。
  • 按住选中的 SegmentedControl 项不会在其凸起的表面上绘制按压覆盖层,该表面在触摸呈现方式下抬起;按住未选中项则会绘制按压覆盖层。

视觉参考

由 packages/core/src/__tests__/PressedState.a11y.chromium.spec.ts 生成的真实 Chromium 证据捕获了八个组件的匹配静止、按住指针、释放、禁用和选中例外表面。CI 在 pressed-state-evidence 产物中发布这些 PNG、像素差异、Chromium 版本、视口、story ID、哈希以及确切的 PR-head SHA。生成的证据验证了本文档,但不是规范性设计资产。

components frontmatter 列表是 DR1–DR5 的机器可读采用矩阵。 组件记录不会重复此跨组件决策。

决策日志

DEC-1 — 在受限的八组件矩阵上使用系统按压叠加层

参考: design:user-states/DEC-1 决策者: cixzhang,2026-09-19

一致的反馈有助于指针用户理解哪个已启用的表面正在响应。 该决策有意限定于矩阵中的表面,保留禁用行为,并保持已选分段的凸起表面稳定。

DEC-2 — 被点击的文本字段立即显示其焦点外观

参考: design:user-states/DEC-2 决策者: cixzhang,2026-11-07

被点击的文本字段立即显示其焦点外观,无需淡入淡出过渡,与 Web 的即时焦点外观一致,同时保持性能:在 Chromium 中,2 次重绘而非 18 次;在 iPhone 上的 Safari 中,焦点停滞已经掩盖了大部分淡入淡出过渡。

设备的主指针决定时序,因此在带有硬件键盘的平板上按 Tab 也会立即显示焦点外观。

开放问题

对于受限的按压状态决策或 DEC-2,没有开放问题。悬停、DEC-2 之外的焦点、已选分段例外之外的选择处理,以及其他组件的采用,均不在本记录当前的主张范围内。

内容边界

本文件定义了已批准的跨组件按压状态意图及其受限采用矩阵,以及被点击文本字段的焦点时序(DEC-2)。 组件实现负责选择器和事件机制;架构记录负责交互模态和令牌行为;测试和 CI 工件负责当前的符合性证据。

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