用户状态设计规范¶
用户意图¶
指针用户在按住或拖动启用的控件时,应在被操作的表面上获得即时、一致的反馈。该反馈不得暗示已禁用的控件做出了响应,也不得抹除持久选中的表面。
设计原则¶
- DR1 — 按压被操作的表面。 在指针按住或拖动期间,下方矩阵中的每个启用表面 MUST 在指定的可视部分绘制
--color-overlay-pressed。该覆盖是瞬态的,MUST 在按压或拖动结束时清除。覆盖的时序遵循spec:AST-094FR11 在各种指针下的按压配置文件。 - DR2 — 禁用即无响应。 矩阵中的禁用控件 MUST 保持不可操作,且 MUST NOT 获得按压视觉处理。
- DR3 — 持久选中优先。 在指针按住期间,选中的 SegmentedControl 项 MUST 保持其凸起的选中表面;只有未选中项接收按压覆盖层。在触摸呈现方式下,该表面会抬起,如同 UISegmentedControl 的行为(
component:SegmentedControlFR14);在精细主指针下,它保持不变。其按压时序遵循spec:AST-094FR11。
结构与层级¶
| 角色 | 用途 | 必需关系 |
|---|---|---|
| 交互目标 | 接收指针按住或拖动 | 拥有或控制矩阵中指定的绘制表面 |
| 按压覆盖层 | 确认当前操作 | 叠加在现有填充之上,不替换内容或持久状态 |
| 持久选中表面 | 传达已选中的分段 | 在指针按住期间不接收按压覆盖层;在触摸呈现方式下抬起 |
状态表示¶
| 组件 | 启用的指针按住或拖动 | 禁用的指针按住 |
|---|---|---|
| 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