跳转至

Selector 空指示符空间折叠系统规格

意图

为未选中选项让出当前被空的选择标记列所占用的宽度。用户不应因为一个不绘制任何内容的指示符而损失标签空间。因此,选中行在其标记出现时可能更早发生位移或截断;这一差异是选中状态可接受的一部分。

本规格记录一项已批准的未来变更。在下列实现与验证落地,并且当前契约在同一拉取请求中更新之前,component:Selector 仍是已发布行为的唯一权威来源。

非目标

  • 在本规格拉取请求中实现运行时变更。
  • 添加公开 prop 来保留或选择指示符列预留。
  • 移除 indicatorPosition 或改变其默认逻辑边缘。
  • 隐藏主题有意渲染的未选中指示符,例如未选中的单选替换图标。
  • 更改选择、键盘、加载、自适应呈现、Popover、BottomSheet 或 listbox/dialog 语义。
  • 制定 input 族或 selection 族的布局规则。

需求

  • FR1 — 空指示符空间折叠。 解析后的选择指示符不绘制任何内容的未选中选项,MUST NOT 保留空指示符列。
  • FR2 — 已渲染指示符保留空间。 选中标记以及任何渲染未选中状态的主题替换图标,MUST 保持在配置的 indicatorPosition 的行布局中。
  • FR3 — 依赖状态的宽度是有意为之。 当只有选中行渲染标记时,其标签可以从与未选中标签不同的内联位置开始,或可用宽度更少。实现 MUST 保留可读的行内容和现有溢出行为,而不是用空白空间补偿。
  • FR4 — 逻辑位置仍然适用。 indicatorPosition="start" 和 "end" MUST 将每个渲染的标记放置在 LTR 和 RTL 下的对应逻辑边缘。
  • IR1 — 从渲染内容推导布局。 组件 MUST 根据解析后的指示符输出来判断是否存在空间;MUST NOT 添加新的公开预留或对齐 prop。
  • IR2 — 保留主题替换。 该变更 MUST 继续通过当前由主题拥有的指示符路径解析指示符,包括选中和未选中状态。
  • IR3 — 保留语义所有权。 折叠视觉空间 MUST NOT 改变选项角色、aria-selected、listbox 所有权、触发器关系,或携带稳定 selector-check 主题目标的元素。

平台支持

  • 支持的功能/引擎下限:Astryx Core 支持的所有浏览器。
  • 不支持的行为:无;布局 MUST 使用现有的跨浏览器 CSS 和 React 支持下限。
  • 浏览器证据:真实 Chromium 用于验证渲染后的间距和截断。需要 RTL 和紧凑宽度用例;仅凭 DOM 结构或 jsdom 不能作为视觉证据。

当前状态影响

当前的 main 会刻意为每个选项渲染一个指示符包装器,并对该包装器应用最小内联宽度。默认未选中勾选指示符不绘制任何内容,因此未选中行仍会预留空白空间。现有的 Selector.test.tsx 覆盖在两种指示符位置均明确断言两个行子元素。

实现将更改 component:Selector/FR3 及其映射的测试。该更改仍受 Selector 当前已使用的系统约束:

  • architecture:component-theming-surface 继续拥有稳定的主题目标;
  • architecture:icon-resolution-and-component-slots 继续拥有解析后的指示符替换和有状态渲染;
  • architecture:interaction-modality 和 architecture:layer-runtime 保持不变;指针 Popover 和触摸模态对话框行为不属于此布局更改;且
  • architecture:public-component-api 继续禁止将可推导的布局差异作为新的调用方可控 prop 暴露。

实现要求

  1. 仅当解析后的指示符不渲染任何内容时,折叠标记包装器。
  2. 为选中的默认勾选标记以及渲染未选中状态的主题指示符保留布局空间。
  3. 用针对空折叠和两个逻辑位置上已渲染替换指示符的聚焦覆盖,替换当前保留列断言。
  4. 在实现拉取请求中更新 component:Selector,使其当前的需求与验证映射描述已发布的结果。
  5. 在本规格移至 shipped 之前,添加稳定的真实浏览器视觉回归覆盖。

验证

契约 验证 代表性状态 突变或失败预期
FR1, FR3 聚焦的 Selector.test.tsx 布局断言 默认勾选;选中与未选中行;窄长标签 空包装器保持宽度,或选中状态截断被恢复的空白间距掩盖
FR2, IR2 指示符替换测试 默认勾选和主题单选;选中与未选中 未选中的主题输出消失或失去其布局空间
FR4 逻辑顺序测试和真实浏览器截图 start/end;LTR/RTL;选中/未选中 渲染的标记出现在物理边缘而非逻辑边缘
IR1, IR3 公共表面、角色和主题目标测试 默认和自定义选项渲染;搜索/非搜索 出现新的公开 prop、选项/listbox 语义改变,或稳定目标发生移动
视觉结果 在真实 Chromium 中的稳定视觉回归 指针 Popover 与触摸模态对话框;窄/宽;起始/结束;默认/主题指示器 残留空白、可见指示器重叠,或选中/未选中内容变得不可读

完成标准

本规范仅在满足以下条件时从 accepted 移至 shipped:

  • 空的默认勾选包装器不占用指示器列宽度;
  • 选中标记和可见的未选中主题替换在 LTR 和 RTL 的两种逻辑位置上均保留所需空间;
  • 选中行的位移和可用宽度变窄被涵盖为有意行为,包括长标签截断;
  • 聚焦的单元测试和真实浏览器视觉回归覆盖指针 Popover 和触摸模态对话框呈现,且不改变其语义;以及
  • component:Selector 在同一拉取请求中从保留列基线更新为新的已发布行为。

决策日志

DEC-1 — 未选中行折叠空指示器空间

参考: spec:AST-004/DEC-1 决策者: cixzhang, 2026-08-30

当未选中 Selector 选项的解析选择指示器不绘制任何内容时,该选项不会预留空白空间。这为未选中标签提供了更多可用宽度。选中标签在其指示器出现时可能更早发生位移或截断;这种状态差异是有意为之。

已否决:在每一行预留空列,仅仅为了让选中和未选中标签对齐。这种对齐将内容宽度耗费在不可见的视觉元素上,并使未选中状态变得不那么有用。

未决问题

无。

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