[components] 内建 select 的空选项/依赖门态分支把 host id 落在一个 div 上 —— label 的 for 指向不可 label 元素,仍是不关联的

[yinlianghui]

实施 #3976(内建 select 分支的 host id 落到真实 trigger)时顺手测到的相邻状态,与 #3976 的修法不相交,单独记录。

实测(probe,未提交;#3976 的修改对这一条无影响)

一个 { name: 'empty', label: 'Empty', type: 'select', options: [] }:

label for = _r_7_-form-item   ->  owner tag = DIV

DOM:

label class="…" for="_r_7_-form-item">Empty</label>
div class="text-sm text-muted-foreground" id="_r_7_-form-item"
    aria-describedby="_r_7_-form-item-description" aria-invalid="false">No options available</div>

即:选项为空(或 #2284 的依赖门态,emptyHint 分支)时,内建 select 渲染的是
BuiltinSelectEmptyState 那个 div,FormControl(Radix Slot)下发的 id 就落在这个 div 上,
而 FormLabel 的 for 指向它。for 只能指向可 label 元素(button / input / meter /
output / progress / select / textarea),指向 div 是惰性 HTML。

与既有工作的关系

• [components] 表单渲染器内建 select 分支把 host id 展开到 Radix Select.Root —— 手写 form schema 里 type: 'select' 的 label for 全部悬空(#3306 的内建侧同形) #3976 修的是「有选项时 id 落到 Radix Root 被丢弃」;这一条是「无选项时 id 落到一个不可 label 的 div」,原因不同。
• [fields] 复合/分组 field widget 丢弃或错投 host 下发的控件 id：address / geolocation 的表单 label for 悬空，checkboxes / radio / rating / file 的 for 落在不可 label 的 div 上 #3961 / PR fix(fields,components): 复合/分组 field widget 的组标签改用 IDREF 关联(#3961) #3978 为不可 label 的复合控件引入了 aria-labelledby 的 IDREF 通道;但这里的空状态根本没有控件,所以「改成 IDREF」并不显然正确 —— 也可能应当在分支不渲染控件时干脆不发 for(渲染器目前无从得知),或者给空状态一个语义角色。方向属于裁决,不在这里预设。

影响面(诚实说:很小,所以按 observation 记)

• 用户侧:空状态里没有任何可聚焦控件,所以「点标签没反应」与「控件无可访问名」都无处发生 —— 名字要命名的东西不存在。
• 作者/测试侧有真实摩擦:对这样的字段 getByLabelText('Empty') 会抛
  "found a label … however no form control was found associated to that label",
  读起来像渲染器坏了,而实际是空状态。
• 同形的还有 @object-ui/fields 的 OptionsEmptyState(注册 widget 路径的空状态),如果这一条要修,两条路径应一起看。

严重度交 PM 分诊;这里只按 #4949 的纪律把事实与证据落到纸面。

参考

• [components] 表单渲染器内建 select 分支把 host id 展开到 Radix Select.Root —— 手写 form schema 里 type: 'select' 的 label for 全部悬空(#3306 的内建侧同形) #3976(内建 select 的 host id;本单在其 probe 中被测到)
• field:select 从不向辅助技术播报校验状态 —— aria-invalid / aria-describedby / aria-required 被 Radix Select.Root 静默丢弃 #3306(widget 侧同机制)
• [fields] 复合/分组 field widget 丢弃或错投 host 下发的控件 id：address / geolocation 的表单 label for 悬空，checkboxes / radio / rating / file 的 for 落在不可 label 的 div 上 #3961 / PR fix(fields,components): 复合/分组 field widget 的组标签改用 IDREF 关联(#3961) #3978(不可 label 控件的 IDREF 命名通道)
• 表单支持级联/依赖选项:新增 SelectOption.visibleWhen 通用谓词 #2284(依赖门态的 emptyHint)

[claude]

Findings triage — held (finding stays; no ownership taken).

• Premise re-verified on the post-[components] 表单渲染器内建 select 分支把 host id 展开到 Radix Select.Root —— 手写 form schema 里 type: 'select' 的 label for 全部悬空(#3306 的内建侧同形) #3976 ref — required because the upstream card this was split from merged since filing (objectui origin/main @ 0cbdca8 IS the [components] 表单渲染器内建 select 分支把 host id 展开到 Radix Select.Root —— 手写 form schema 里 type: 'select' 的 label for 全部悬空(#3306 的内建侧同形) #3976/PR fix(components): 内建 select 分支把 host id/aria-* 落到真实 trigger,label for 不再悬空 (#3976) #3992 merge): the empty-options branch still returns <BuiltinSelectEmptyState/> (form.tsx:2467), which spreads ...rest onto a div (form.tsx:2188-2199), so the Slot-injected host id still lands on a non-labelable element and FormLabel for still dangles. The card's claim of independence from [components] 表单渲染器内建 select 分支把 host id 展开到 Radix Select.Root —— 手写 form schema 里 type: 'select' 的 label for 全部悬空(#3306 的内建侧同形) #3976's fix holds.
• Why held rather than promoted: zero user-facing harm by the card's own honest measurement (the empty state has no focusable control, so there is nothing for the name to name); the real friction is test-side (getByLabelText throws a misleading error). And the fix direction is an open fork the card explicitly declines to pre-decide (omit for when no control renders / give the empty state a semantic role / extend the [fields] 复合/分组 field widget 丢弃或错投 host 下发的控件 id：address / geolocation 的表单 label for 悬空，checkboxes / radio / rating / file 的 for 落在不可 label 的 div 上 #3961 IDREF channel) — not mechanical, so not sweep-packable with the labelling-family cards either. No family sweep is forming yet: [fields/components] 一个 multiple: true 的 select 字段在对象表单里 host label 仍然惰性 —— 按字段类型键入的 labelling 声明碰不到它(#3975 修完后的实测残留) #3986 is queued but unclaimed, [components] 表单渲染器内建 select 分支把 host id 展开到 Radix Select.Root —— 手写 form schema 里 type: 'select' 的 label for 全部悬空(#3306 的内建侧同形) #3976 just merged solo.
• Restart conditions: ① a direction ruling on empty-state labelling (natural rider on any future [fields] 复合/分组 field widget 丢弃或错投 host 下发的控件 id：address / geolocation 的表单 label for 悬空，checkboxes / radio / rating / file 的 for 落在不可 label 的 div 上 #3961-family extension); ② if a select-labelling family sweep forms once [fields/components] 一个 multiple: true 的 select 字段在对象表单里 host label 仍然惰性 —— 按字段类型键入的 labelling 声明碰不到它(#3975 修完后的实测残留) #3986 is taken up, reconsider packing this and OptionsEmptyState (@object-ui/fields, same shape) into it; ③ if the misleading getByLabelText failure actually bites a CI run, escalate from observation to queue.

本评论来自分诊座位 Routine（#5474 试点），不构成认领。

---

Generated by Claude Code