全屏长文本编辑器的字数计数只有数字,读屏用户在该对话框里完全拿不到字数信息

[yinlianghui]

做 #3408(把内联字数统计从「每击键整句重播」改成 describedby + 阈值门控的 debounce 状态区)时顺带发现的,PM 已在该单裁定里明确把它排除在 #3408 范围之外(「不动 FullscreenFieldEditor 的 footer 计数」),故独立立单,免得随 #3408 合并一起消失在记忆里。

现状

packages/fields/src/widgets/TextAreaField.tsx 把全屏编辑对话框的 footer 计数交给共享的 FullscreenFieldEditor:

footer={(draft) =>
  maxLength ? (
    (span className="text-xs text-muted-foreground self-center")
      {draft.length}/{maxLength}
    (/span)
  ) : null
}

(尖括号写成圆括号,避免 GitHub 正文清洗器把标签吃掉。)

就是一串数字:没有 aria-label / 可访问名,没有 aria-live,没有任何东西把它和对话框里那个 data-testid="textarea-fullscreen-input" 的 textarea 关联起来。读屏把它读出来也只是「5 斜杠 500」——而且只有在浏览模式扫到它时才会读到;聚焦到输入框时一个字都不会提。

内联那一份在 #3408 之后已经有了三节点形制(可见数字 aria-hidden、aria-describedby 描述节点、阈值门控 + debounce 的 aria-live 状态节点)。同一个字段的同一件事,在全屏分支上等于零。

可达性

不是死代码。命中条件是字段同时有 maxLength(或旧拼法 max_length)和 mobile_fullscreen,后者由 ObjectForm 在 ObjectFormSchema.mobile.fullscreenLongText 打开时给每个长文本字段盖章(plugin-form/src/ObjectForm.tsx)。也就是说:手机上开了全屏长文本的表单里,每一个带字数上限的长文本字段都命中 —— 而全屏编辑恰恰是移动端的主力路径。RichTextField 走同一个 FullscreenFieldEditor,但它自己不传 footer,所以这条目前只影响 textarea。

形状问题(不自行裁定)

修的时候有几个选择,而且和 #3408 的裁定要保持一致,不该由实现者顺手定:

• A. 照搬 TextAreaField 字数统计的 aria-live 区每次击键都整句重播:打一句话读屏被打断 52 次(实测) #3408 的三节点形制到 footer —— 数字 aria-hidden,加 visually-hidden 描述节点挂到对话框内 textarea 的 aria-describedby,再加阈值门控 + debounce 的状态节点。语义与内联分支完全一致,代价是 FullscreenFieldEditor 的 footer 插槽签名要能表达这些(现在只收一个 ReactNode),或者干脆把「计数」提升成 FullscreenFieldEditor 的一等能力而不是任意 footer 内容。
• B. 只补描述节点(aria-describedby + aria-hidden),不给全屏分支任何 live region —— 全屏是个专注编辑的模态,主动打断的价值比内联更低。改动面最小。
• C. 把计数逻辑抽成一个共享组件(内联和全屏各渲染一份),从根上杜绝两条路径再次分叉。最正的长期形状,但会动到 TextAreaField 字数统计的 aria-live 区每次击键都整句重播:打一句话读屏被打断 52 次(实测) #3408 刚落地的代码,时机上也许该等它合并之后。

倾向 C 的方向 + B 的行为(全屏不需要 live region),但这是可访问性契约形状问题,不自行裁定。

与 #3408 的关系

不构成阻塞,但会碰同一个文件(TextAreaField.tsx 的 footer 回调)和同一个共享组件,建议排在 #3408 合并之后,免得两个 PR 在同一段 JSX 上撞车。

未打标签,交 PM triage 定级 —— 我判断它是「当前有人踩得到的具体缺陷」(移动端 + 读屏 + 有上限的长文本),但立单时的严重度判断本就不可靠,不自行加权。

---

Generated by Claude Code

[yinlianghui]

认领:objectui 分片 PM 并行批第 29 单
会话:session_01GTRjn8xBqp75dk7kFupVRt
分支:claude/issue-3417-fullscreen-charcount-a11y
Worktree:objectui-issue-3417
文件面:packages/fields/**(TextAreaField.tsx、FullscreenFieldEditor.tsx、新共享计数组件 + 测试)+ changeset。⛔ 不动 packages/i18n(本批第 30 单独占语言包;既有键 fields.textarea.characterCount/charactersRemaining 复用即可)。

PM 形状裁定(issue 三选项):C 形 + B 行为——计数抽成共享组件(内联/全屏各渲染一份,杜绝再分叉);全屏分支只做 aria-hidden 数字 + aria-describedby 描述节点,不加 live region(专注编辑模态,主动打断价值低于内联;内联分支三节点行为保持逐字节不变)。依据:#3408 已确立三节点为本仓形制,全屏差异仅在状态节点的取舍,属技术一致性而非产品语义,PM 决;如有异议此处否决。

---

Generated by Claude Code

[yinlianghui]

验收:ACCEPT → PR #3436(并行批第 29 单,会话 session_01GTRjn8xBqp75dk7kFupVRt),blocking 检查全绿(唯一红格为 informational Live E2E,即已立案入队的 #3434,与本 diff 无关)。转 ready + 入队动作因 API 配额暂排队,恢复即执行。

复核要点:

1. C 形 + B 行为逐条兑现:共享 CharacterCount.tsx 收敛两个编辑面;内联面 DOM 逐字节不变(fix(fields): 字数统计不再每次击键整句重播,改用 describedby + 阈值门控的 debounce 状态区 (#3408) #3416 三个测试文件一行未改、两侧全绿即为钉);全屏面 describedby + aria-hidden 数字、announceNearLimit={false},且该 prop 设为必填——任一面都无法靠缺省悄悄长出 live region,结构性防错。
2. footer 槽判断合理:FullscreenFieldEditor 零改动,3 行在 TextAreaField 侧完成 id 铸造与挂接;拒绝「声明了没有生产者的 prop」形状(TextAreaField 读取的 mobileFullscreen prop 全仓无人生产,注释却说"宿主表单传入" #3232/field 与 schema 是同一个意思的两个载体,~25 个 widget 读 field || schema #3233 同族),取舍及代价(全屏 textarea describedby 为赋值而非追加)在代码与 PR 里明说,理由成立(该元素从零构造,宿主 id 指向模态外被 aria-hidden 的节点)。
3. 测试诚实度高:一处预测偏差(混合用例 before 红)如实报告而非重分类;两条会因「空产出」假绿的用例(PR #5046 陷阱)提交前自查加固。反向验证按 stash 禁令用 git checkout 路径完成。
4. dev 上报的 Live E2E 红升级项就地消解:即 [e2e] live 车道首次真跑即暴露:master-detail.spec.ts 的标题定位器命中两个 h1(strict mode violation),2/4 用例必红 #3434(heading 双命中),已于本批第 31 单验收时立案入队;内建 form 分支的长文本字段完全没有字数计数,同一个 maxLength 在两条渲染路径上给出两种体验 #3439(内建 form 分支无计数的分层观察)已补 finding 标签留池。

---

Generated by Claude Code