实施 #3961(复合/分组 widget 的 group 标注)时,把该单的 probe 从正文列出的字段类型扩到 18 个跑了一遍(probe 未提交),multiselect 落在与 checkboxes / rating 完全相同的失效形态上,但它不在 #3961 正文实测表、也不在 PM 裁定的六个 widget 内,所以单独立单而不夹带进那个 PR。
Blocked-by: #3961(它引入本单要用的 ComponentMeta.labelling 声明位;在它合入前本单无从修)
实测
真表单 + 每字段一行,读 host label 的 for 与它解析到的元素,再看 host label 文本是否成为任何元素的可访问名。#3961 的 PR 已在同一棵树上生效,所以这是「六个 widget 修好之后」的剩余账:
checkboxes for=(none) ownId=…-group-label byLabelText=1(div[role=group]) byRole+name=[group:1] ← #3961 修好
rating for=(none) ownId=…-group-label byLabelText=1(div[role=group]) byRole+name=[group:1] ← #3961 修好
multiselect for=…-form-item ownId=(none) -> div byLabelText=0() byRole+name=[] ← 本单
MultiSelectField 把 host 的 id 保留在包裹 div 上(packages/fields/src/widgets/MultiSelectField.tsx 的 groupDomProps 展开点,与 CheckboxesField 逐字同形),每个选项是一个 button[role=checkbox] 各带自己的 label。于是 host 的 for 指向一个 div:HTML 里 label[for] 指向不可 label 的元素是惰性的 —— HTMLLabelElement.control 返回 null,既不产生点击激活,也不贡献可访问名。视觉上有「Tags」标签,屏幕阅读器只听到 "Alpha" / "Beta",不知道这一组是什么。
#3961 的正文实测表覆盖的是它当时 probe 的字段集合(address / geolocation / checkboxes / radio / rating / file + 一批阳性对照),multiselect 不在其中;PM 的范围裁决(评论 5233281956)也按那张表逐 widget 列了处置。所以这是审计覆盖面的缺口,不是那次修法的缺陷。
顺带说明它与 #3318 的关系:#3318 治的是「校验失败不播报 aria-invalid」,multiselect 在它的 29 个账本条目里 —— 但那是另一个事实(状态通道),修好它并不会让 host label 关联上。本单必须自己修。
修法(#3961 的机制已就位,两处各一行)
packages/fields/src/index.tsx 的 FIELD_TYPES_GROUP_LABELLED 加 'multiselect';MultiSelectField 的包裹 div 补 role={isLabelledGroup ? 'group' : undefined},isLabelledGroup 判据同 CheckboxesField(groupDomProps['aria-labelledby'] != null),standalone 无 host label 时不发 role。
钉子两方向照 #3961 的 composite-group-label-e2e.test.tsx 抄:表单内 getByRole('group', { name: hostLabel }) 接线前 0 / 后 1;standalone 不回退;group-labelling-declaration.test.ts 里的「恰好是审计集合」断言同时收紧(它会因为新增声明而翻红,必须一并更新 —— 那正是它存在的意义)。
参考
实施 #3961(复合/分组 widget 的 group 标注)时,把该单的 probe 从正文列出的字段类型扩到 18 个跑了一遍(probe 未提交),
multiselect落在与checkboxes/rating完全相同的失效形态上,但它不在 #3961 正文实测表、也不在 PM 裁定的六个 widget 内,所以单独立单而不夹带进那个 PR。Blocked-by: #3961(它引入本单要用的
ComponentMeta.labelling声明位;在它合入前本单无从修)实测
真表单 + 每字段一行,读 host label 的
for与它解析到的元素,再看 host label 文本是否成为任何元素的可访问名。#3961 的 PR 已在同一棵树上生效,所以这是「六个 widget 修好之后」的剩余账:MultiSelectField把 host 的id保留在包裹div上(packages/fields/src/widgets/MultiSelectField.tsx的groupDomProps展开点,与 CheckboxesField 逐字同形),每个选项是一个button[role=checkbox]各带自己的 label。于是 host 的for指向一个div:HTML 里label[for]指向不可 label 的元素是惰性的 ——HTMLLabelElement.control返回 null,既不产生点击激活,也不贡献可访问名。视觉上有「Tags」标签,屏幕阅读器只听到 "Alpha" / "Beta",不知道这一组是什么。为什么 #3961 没顺手带上
#3961 的正文实测表覆盖的是它当时 probe 的字段集合(address / geolocation / checkboxes / radio / rating / file + 一批阳性对照),
multiselect不在其中;PM 的范围裁决(评论 5233281956)也按那张表逐 widget 列了处置。所以这是审计覆盖面的缺口,不是那次修法的缺陷。顺带说明它与 #3318 的关系:#3318 治的是「校验失败不播报
aria-invalid」,multiselect在它的 29 个账本条目里 —— 但那是另一个事实(状态通道),修好它并不会让 host label 关联上。本单必须自己修。修法(#3961 的机制已就位,两处各一行)
packages/fields/src/index.tsx的FIELD_TYPES_GROUP_LABELLED加'multiselect';MultiSelectField的包裹 div 补role={isLabelledGroup ? 'group' : undefined},isLabelledGroup判据同 CheckboxesField(groupDomProps['aria-labelledby'] != null),standalone 无 host label 时不发 role。钉子两方向照 #3961 的
composite-group-label-e2e.test.tsx抄:表单内getByRole('group', { name: hostLabel })接线前 0 / 后 1;standalone 不回退;group-labelling-declaration.test.ts里的「恰好是审计集合」断言同时收紧(它会因为新增声明而翻红,必须一并更新 —— 那正是它存在的意义)。参考
for悬空，checkboxes / radio / rating / file 的for落在不可 label 的 div 上 #3961 / 其 PR(六个 widget 的同类修复 + 声明位)aria-invalid—— #3306 全注册表守卫实测的账本 #3318(同一批 widget 的aria-invalid账本,相邻但不同事实)fordangles #3952 / PR fix(fields): BooleanField 使用 host 下发的控件 id,可见 label 不再悬空 (#3952) #3959(单一控件形态的同类修复)