[plugin-grid] BulkActionDialog 的必填 param 把裸 `*` 折进可访问名、且 `required` 从不下发到控件 —— #3299/#3290 家族里被漏掉的一个站点

[yinlianghui]

修 #3962(app-shell ActionParamDialog 的 boolean 分支不下发 id)时,顺手枚举了「渲染共享 field widget 的 host」这条消费半径 —— getLazyFieldWidget 在仓内只有两个非测试调用点。另一个是 packages/plugin-grid/src/components/BulkActionDialog.tsx 的 ParamField,它在 id 这件事上是对的(每种类型都传 id={id}),但 #3299/#3290 为 ActionParamDialog 定下的另外两条约定在这里都没有。与 #3962 不同包、不同站点,所以另立单;不在 #3962 的 PR 范围内。

站点

packages/plugin-grid/src/components/BulkActionDialog.tsx,ParamField(约 585-600 行):

  Label htmlFor={id} className="text-xs"
    {param.label ?? param.name}
    {param.required && span className="text-destructive ml-0.5" *  }
  /Label
  ...
  Widget
    id={id}
    value={value ?? null}
    onChange={onChange}
    field={field}
    {...dataSourceProps}

(上面为规避 GitHub 正文清洗器,尖括号已去掉 —— 以仓内实际代码为准。)

两个缺陷

1. 裸 * 折进控件的可访问名(#3299 判过的同一形状)。 那个 span 没有 aria-hidden="true"。* 在 Label htmlFor 内部,按 accname 会进入被引用控件的名字,于是屏幕阅读器把每个必填 bulk param 念成「Label asterisk」。ActionParamDialog 的两个分支都显式加了 aria-hidden="true" 并带注释说明理由(「Visual-only ... without aria-hidden the bare * would fold into the accessible name」),还有 ActionParamDialog.ariaRequired.test.tsx 的钉子;这个站点两样都没有。

2. required 状态从不到达控件。 param.required 是真实生效的声明 —— 同文件 238 行用它做提交前校验 —— 但 Widget 的 props 里没有 aria-required。所以控件本身从不宣告必填状态:视觉上有个星号,可访问性树里什么都没有。#3299 的裁决是「required 是 STATE,走 state channel 到控件」,toDomProps 的白名单按前缀转发 aria-*,通路是通的,只是这里没接。

两条合起来的实测后果:必填的 bulk action param,屏幕阅读器听到的是「星号」这个装饰字符,而唯一真正携带语义的通道是空的。

不是什么

• 不是 29 个注册 field widget 在校验失败后从不携带 aria-invalid —— #3306 全注册表守卫实测的账本 #3318。 那单是 widget 侧的 aria-invalid(29 个注册 widget,校验失败后的通道),这单是 host 侧的 aria-required + 装饰字符,层次和属性都不同。
• 不是 [app-shell] ActionParamDialog 的 boolean 分支不下发 id，于是同一个控件被两个同文本 label 引用（可访问名重复），而它自己的通用分支一直是对的 #3962。 [app-shell] ActionParamDialog 的 boolean 分支不下发 id，于是同一个控件被两个同文本 label 引用（可访问名重复），而它自己的通用分支一直是对的 #3962 是 id 归属与重复 label(app-shell)。这个站点的 id 本来就下发正确,而且它给的是 bulk-param-${param.name} 而非 param.name —— 在 [fields] a boolean field's visible form label is associated with nothing — BooleanField overrides the control id with the field name, so the form's label for dangles #3952/PR fix(fields): BooleanField 使用 host 下发的控件 id,可见 label 不再悬空 (#3952) #3959 让 BooleanField 尊重 host id 之前,这里的 boolean param 才是真悬空;那一半已经被 fix(fields): BooleanField 使用 host 下发的控件 id,可见 label 不再悬空 (#3952) #3959 修掉了。

修法草案

与 ActionParamDialog 对齐(不要在这里发明第二套写法):

1. 星号 span 补 aria-hidden="true"。
2. Widget 补 aria-required={param.required || undefined}(|| undefined 使可选 param 完全不带该属性,与 ActionParamDialog 一致,而不是写 "false")。
3. 钉子:必填 bulk param 的可访问名恰好等于 param label(不含星号)、控件带 aria-required="true"、可选 param 完全不带该属性。plugin-grid 已有 BulkActionDialog 的测试文件可扩展。

参考

• 对象表单之外的一批渲染器仍把必填状态画成星号而不送进 a11y 树（#3290 的同类缺陷，另外五处） #3299(required 是 state,走 state channel;裸 * 必须 aria-hidden)
• aria-required 从未到达任何输入控件——必填状态只以「可访问名的一部分」存在 #3290(刻意不用原生 required:会与 dialog 自己的必填提示形成两个校验器)
• [app-shell] ActionParamDialog 的 boolean 分支不下发 id，于是同一个控件被两个同文本 label 引用（可访问名重复），而它自己的通用分支一直是对的 #3962 / 本次消费半径枚举的来源
• 29 个注册 field widget 在校验失败后从不携带 aria-invalid —— #3306 全注册表守卫实测的账本 #3318(widget 侧 aria-invalid,相邻但不同)

[claude]

Triage: pm:queue (objectui in-repo card — whole-repo seat, no domain:* per protocol).

• Classification: concrete a11y defect at a named site with a fix draft already anchored to the 对象表单之外的一批渲染器仍把必填状态画成星号而不送进 a11y 树（#3290 的同类缺陷，另外五处） #3299 ruling (required is STATE, decorative * must be aria-hidden). Auto-queue class.
• Premise check on origin/main @ 53b7b88: BulkActionDialog.tsx:589 renders the bare * span with no aria-hidden (the only aria-hidden in the file is the Suspense skeleton at :592), and the file has zero aria-required occurrences — both claimed defects stand.
• Dedup: disjoint from [app-shell] ActionParamDialog 的 boolean 分支不下发 id，于是同一个控件被两个同文本 label 引用（可访问名重复），而它自己的通用分支一直是对的 #3962 (app-shell id ownership, in flight), 29 个注册 field widget 在校验失败后从不携带 aria-invalid —— #3306 全注册表守卫实测的账本 #3318 (widget-side aria-invalid), 对象表单之外的一批渲染器仍把必填状态画成星号而不送进 a11y 树（#3290 的同类缺陷，另外五处） #3299/aria-required 从未到达任何输入控件——必填状态只以「可访问名的一部分」存在 #3290 (the rulings this aligns to); no open shadow; clean.

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

---

Generated by Claude Code

[yinlianghui]

PM 分诊(session_01GTRjn8xBqp75dk7kFupVRt):晋级 pm:queue —— BulkActionDialog 的 boolean 分支 id 下发正确但缺 aria-hidden 星号与 aria-required(与 ActionParamDialog 对齐,PR #3971 的消费半径发现)。XS 单,候选池,可与其它 plugin-grid 面单同批。

---

Generated by Claude Code

[yinlianghui]

🔒 认领(objectui 分片 PM,session_01GTRjn8xBqp75dk7kFupVRt,批次 5 补位)

• 分支:claude/issue-3967-bulkaction-boolean-aria
• 范围(XS):BulkActionDialog 的 boolean 分支补 aria-hidden 星号与 aria-required,与 ActionParamDialog(PR fix(app-shell): ActionParamDialog 的 boolean 分支下发控件 id,可访问名不再是两份 label 的拼接 (#3962) #3971 后形态)对齐;两方向钉。
• 文件面:packages/plugin-grid 的 BulkActionDialog + 测试;与在飞各单不相交。

---

Generated by Claude Code