Repository navigation
[fields] markdown / html / richtext 的**可编辑**分支从不转发 host 下发的 id 与 aria-describedby —— label for 悬空、description 零消费者,且 #3318 的 aria-invalid 账本按设计看不见这一半 #4810
Description
在 #4788 的形态扫描中实测到的相邻一条,与 #4788 无关(#4788 只谈只读替换显示,本条发生在可编辑态),也不在 #3318 的完成范围内(理由见下)。不认领、不扩围。
实测
真 form renderer + 裸注册(与 #3990 / #4005 / #4788 的 probe 同一套),字段带 description: 'Some help',数「引用 …-form-item-description 这个 id 的元素个数」,并单独看 host label 的 for 解析到什么:
markdown editable descEl=SET consumers=0 hostIdEl=NONE for=DANGLING
markdown readonly descEl=SET consumers=0 hostIdEl=NONE for=DANGLING ← 这一半属于 #4788
text editable descEl=SET consumers=1 hostIdEl=input for=RESOLVES ← 对照组
textarea editable descEl=SET consumers=1 hostIdEl=textarea for=RESOLVES ← 对照组
html / richtext 与 markdown 是同一个 widget(fieldWidgetMap 里三个键都指向 RichTextField),读数相同。
机理
packages/fields/src/widgets/RichTextField.tsx 全文没有 toDomProps(实测 grep 计数 0)。可编辑分支把 props 只用来取 className / disabled,渲染 RichTextEditorSurface 时不铺任何 DOM pass-through:
- host
id(…-form-item)整个文档无元素承载 → 可见 label 的for指向一个不存在的 id; FormControl的 Slot 注入的aria-describedby同样落地失败 → 渲染出来的FormDescription零消费者。
对照组 TextAreaField / TextField 同一 host 同一 Slot,toDomProps(props) 一铺就都对了。
为什么这不在 #3318 的完成范围内(所以立成独立单,不是 #3318 的子单)
#3318 的账本是按 aria-invalid 一根轴扫出来的,而 markdown / html / richtext 在那次实测里是 PASS 的 17 个之一(RichTextEditorSurface 自己读 error 并置 aria-invalid)。也就是说:
- 29 个注册 field widget 在校验失败后从不携带
aria-invalid—— #3306 全注册表守卫实测的账本 #3318 关掉的那天,这三个类型的 ledger 行本来就不在; - 它们的
id/aria-describedby依旧不落地,而那次 sweep 的断言维度看不到这一点。
#3318 正文给的修法(「把 toDomProps(props) spread 到 widget 的真实可聚焦控件」)如果照做在 RichTextField 上,顺手也修了本条 —— 但 RichTextField 不在它的待修名单里,所以照 #3318 收工不会碰到它。
相关但不同的
slider/grid/signature的可编辑分支同样一个 pass-through 都不铺,但它们在 29 个注册 field widget 在校验失败后从不携带aria-invalid—— #3306 全注册表守卫实测的账本 #3318 的 ledger 里,按其修法会一并修好 —— 已在 29 个注册 field widget 在校验失败后从不携带aria-invalid—— #3306 全注册表守卫实测的账本 #3318 下留言补充读数,不在本单重复立。- [fields] 非 group-labelled widget 的只读替换显示丢掉 host 下发的整份 plumbing —— label 的
for悬空、description 零消费者(email / url / phone 实测) #4788:同一族的只读替换显示那一半(含 markdown 只读行),机制方向待维护者裁决。
参考
- 29 个注册 field widget 在校验失败后从不携带
aria-invalid—— #3306 全注册表守卫实测的账本 #3318(29 个 widget 的 aria-invalid 账本 —— 本条正是它的断言维度之外的残留) - 字段 widget 把渲染器专用 props 原样展开到 DOM——
schema="[object Object]"出现在真实输入框上 #3291(toDomProps白名单与 sweep 范式)、字段 widget 的错误提示键:spec 声明error,objectui 渲染errorMessage(declared ≠ enforced) #3222 /field:select从不向辅助技术播报校验状态 —— aria-invalid / aria-describedby / aria-required 被 Radix Select.Root 静默丢弃 #3306(同一失败类的前两批) - [fields] 只读 / 零选项的 group-labelled 选项 widget 提前 return,
groupDomProps没被展开 —— host label 的 IDREF 没有消费者,标签仍然什么都不命名(#3961 的残留,checkboxes 今天的 main 上就这样) #3990 / [fields] 只读态的 group-labelled 字段:description 的 IDREF 同样没有消费者(#3990 修的是「名」,这条是「描述」) #4005 / [fields] 非 group-labelled widget 的只读替换显示丢掉 host 下发的整份 plumbing —— label 的for悬空、description 零消费者(email / url / phone 实测) #4788(host plumbing 落地的家族)
备注:由 os-dev 在 #4788 的实施中实测发现并按 Prime Directive #10 立单(不认领、不扩围到 #4788)。
Activity
yinlianghui commentedon Aug 16, 2026
【认领】objectui 分片 PM(session_01GTRjn8xBqp75dk7kFupVRt)批次 11 补位派发。分支:
claude/issue-4810-richtext-editable-plumbing。范围:RichTextField 可编辑分支按 #3318 既定配方把toDomProps(props)铺到真实可聚焦控件(markdown/html/richtext 三键同一 widget 一次修);⛔ 只读半边不碰(#4788 三问在决策箱,机制未裁);⛔ 其它 widget 不碰(slider/grid/signature 归 #3318 账本)。Generated by Claude Code
yinlianghui commentedon Aug 16, 2026
【实施完成】PR #4821(draft)。分支
claude/issue-4810-richtext-editable-plumbing,based44279598。前提复核:卡内断言逐条为真 ——
RichTextField.tsx全文toDomProps计数 0;fieldWidgetMap的markdown/html/richtext三键确实同指此 widget(index.tsx:2411-2413);probe 复现读数与卡内一致(consumers=0 hostIdEl=NONE for=DANGLING)。修法:
toDomProps(props)铺到RichTextEditorSurface内部那个Textarea—— 实读确认它是本 widget 唯一接收焦点的元素,外层两级都是div。只给 inline 那一份 surface;fullscreen 对话框那一份不给(同一 host id 会被两个同时挂载的编辑面共用,且 host 的aria-describedby指的节点在 modal 外被 Radixaria-hidden),与TextAreaField对同一对 surface 的切分一致。#3318 的 PASS 项无回归:
aria-invalid={!!error}留在 spread 之后,widget 自读仍是权威。反向验证里这一条得到独立确认 —— 删掉 spread 后 3 条aria-invalid='false'钉子仍绿,3 条 required-failure 用例也只在最后一句aria-describedby上红(aria-invalid='true'的waitFor照过),即该属性在「修前 / 修后 / 变异后」三态完全相同。范围:只读分支一个字符未动(#4788 未裁);其它 widget 未动。改动仅
packages/fields,3 个文件(widget + 新钉子文件 + changeset)。顺手发现,已按 Prime Directive #10 另立:#4824 —— 全屏对话框那一份编辑面不播报校验失败,richtext 甚至恒
aria-invalid="false"(实测,与同刻 inline 面的true相反)。不认领、不在本单修。Generated by Claude Code
fix(fields): editable rich-text forwards the host id and aria-describ…