iter(g348): 表单标签与控件建立 for / aria-labelledby 关联

2026-10-27 02:33:02 +08:00
parent 840025b66b
commit 3a46b24c02
3 changed files with 27 additions and 4 deletions
@@ -1756,6 +1756,21 @@ function checkFormBusy(pkgs) {
  return issues;
 }

+/*** 校验标签归属：label 不带 for / 不指 aria-labelledby 时，点标签不聚焦、读屏也报不出字段名 ***/
+function checkFormLabel(pkgs) {
+  const issues = [];
+  for (const pkg of pkgs) {
+    if (pkg.type !== 'skin-dom') continue;
+    const formPath = path.join(ROOT, pkg.dir, 'src', 'form.ts');
+    if (!fs.existsSync(formPath)) continue;
+    const src = fs.readFileSync(formPath, 'utf8');
+    if (!/for: only\?\.id \?\? null/.test(src)) issues.push(`${pkg.name}/src/form.ts 的 label 没接 for：点「用户名」不会聚焦输入框`);
+    if (!/aria-labelledby', `\$\{fid\}-label`/.test(src)) issues.push(`${pkg.name}/src/form.ts 的组类控件缺 aria-labelledby：自绘下拉 / 单选组读屏报不出字段名`);
+    if (!/if \(only && !only\.id\) only\.id = /.test(src)) issues.push(`${pkg.name}/src/form.ts 没给控件补 id：没有 id 时 for 指向空气`);
+  }
+  return issues;
+}
+
 /*** 校验同义词表：目标 id 必须真实存在（改名后残留会让回退指到空气），同一个词不得归两组（歧义会让结果随表序漂移） ***/
 function checkSynonyms(ids) {
  const issues = [];
@@ -1843,6 +1858,7 @@ function cmdVerify() {
  issues.push(...checkInvalidRing(pkgs)); // 错误环只该在聚焦时亮
  issues.push(...checkFormSummary(pkgs)); // 汇总条必须实时重算
  issues.push(...checkFormBusy(pkgs)); // 提交忙碌态必须有可见反馈
+  issues.push(...checkFormLabel(pkgs)); // 标签必须真正归属控件
  issues.push(...checkSynonyms(new Set(pkgs.flatMap((p) => (p.docs?.components ?? []).map((c) => c.id))))); // 同义词表指向的组件必须真实存在
  checkDarkTokens(issues);
  checkTokenParity(issues);
@@ -1855,7 +1871,7 @@ function cmdVerify() {
    console.error(`${issues.length} violation(s)`);
    process.exit(1);
  }
-  console.log('verify OK (manifest ↔ docs ↔ demo 一致，文档 props ↔ 入参接口双向一致，皮肤无硬编码颜色与未定义令牌、暗色令牌齐全、tokens.json ↔ tokens.css 名字与值双源一致、@keyframes 无复制粘贴的重复帧、滚动容器全在细条规则内，README 组件清单与分组同步，backlog ↔ 留痕双向一致（编号严格递增、无重复 id、留痕时间线单调且带 +08:00，每个 iter 提交都有留痕），组合配方结构完整，MCP 工具清单三处一致，搜索同义词表目标存在且无歧义，combobox / slider / range 控件都有可访问名，toast 有 live 区域与 alert 抢占播报，表单错误文案被 aria-describedby 关联、重置真复位、错误环只在聚焦时亮、汇总条随校验重算、提交按钮有忙碌态，视觉回归抽查清单十九组件 × 五维度齐全)');
+  console.log('verify OK (manifest ↔ docs ↔ demo 一致，文档 props ↔ 入参接口双向一致，皮肤无硬编码颜色与未定义令牌、暗色令牌齐全、tokens.json ↔ tokens.css 名字与值双源一致、@keyframes 无复制粘贴的重复帧、滚动容器全在细条规则内，README 组件清单与分组同步，backlog ↔ 留痕双向一致（编号严格递增、无重复 id、留痕时间线单调且带 +08:00，每个 iter 提交都有留痕），组合配方结构完整，MCP 工具清单三处一致，搜索同义词表目标存在且无歧义，combobox / slider / range 控件都有可访问名，toast 有 live 区域与 alert 抢占播报，表单错误文案被 aria-describedby 关联、标签归属控件（for / aria-labelledby）、重置真复位、错误环只在聚焦时亮、汇总条随校验重算、提交按钮有忙碌态，视觉回归抽查清单十九组件 × 五维度齐全)');
 }

 /*** 校验 git 提交信息是否符合 COMMITTING.md 规范（参数为 message 文件路径或直接 message 文本），违规退出码 1 ***/