nex_animation/scripts/ui
mula.liu 357942ba2e NEX 阶段 8.5·第4项:第 9 闸升级为语义与行为检查(semanticcheck 1062 行)+ 咬出的 4 类真缺陷就地修复
为什么要新闸:此前所有检查(含 classaudit 的 9 道子闸)量的是**源码字符串**——
aria-label 写没写、tabIndex 写没写。字符串会骗人:`aria-label=" "`、指向不存在 id 的
aria-labelledby、常年写着的 `aria-expanded="true"`、给了 `role=button` 却没 tabIndex、
被 CSS `outline:none` 吃掉的焦点环——源码看着齐全,辅助技术什么都读不到。
批准书 §4 要求「优先用实际浏览器行为与辅助技术语义验证」,所以全部换成真东西:
CDP `Accessibility.getFullAXTree` 读 AT 实际拿到的角色与名称、`getComputedStyle` 读算出来的
焦点环、真按 Tab / Space / Escape 看键盘走到哪儿。

七条判据(退出码 = offender 条数):NAME(AT 可读名称,硬/软两档)· HOTSPOT(pointer 可点
但键盘到不了)· TAB(走位与焦点掉出文档)· FOCUS(焦点环可见性,聚焦前后实测对比)·
ARIA(声明的状态与运行时一致)· LIVE(状态通知)· STATES(空/错误/加载六态)。
旋钮:NEX_WIDTH / NEX_THEME / NEX_ROUTES / NEX_TABS / NEX_NAMESTRICT / NEX_HOTSPOTSTRICT /
NEX_FOCUS_DWELL。软档默认不进退出码(当前 20 颗/主题属「补一句 aria-label 就干净」的历史欠账,
登记为 S-1,按路由分批转硬),不为了让灯变绿而调口径。

它第一天咬到的 4 类 58 条真缺陷,全部就地修好:
· AudioPlay 进度条:可点可拖却键盘到不了、role=slider 没有值 → 补 `tabIndex` +
  `valuemin/max/text` + ←→↑↓ 5% / Shift 20% / Home / End,并 stopPropagation(不抢页面滚动)
· MediaLightbox 只读进度:假 slider 是 ARIA 谎报 → 改 `role=progressbar`
· AssetLibrary 三处图标按钮无 AT 名称 → 补 aria-label(选择素材 / 母版)
· `input.nex-file-input` 焦点环被全局 `:where(...):focus-visible{outline:none}` 吃掉
  → `app.css` 唯一一处 +11 行,把环画在**看得见的按钮**上
  (`.ant-btn:has(> .nex-file-input:focus-visible)`)——这是本轮唯一动 CSS 的地方

反向验证:`gateprobe` 加 3 条语义判据的反例(人造坏控件必须红、撤掉必须复绿),
常驻出口从 11/11 升到 `GATEPROBE_OK 14/14`;闸登记进 `nex.config.yaml → ui_gates`
(13 → 14 条命令),并把 authority 注释里写死的「12 道探针」改成「§15 探针清单」,
免得规范与代码又对不上一次。

验证:HEAD `semanticcheck` 1440 与 430 均 **EXIT=58**(NAME 20 / HOTSPOT 16 / TAB 16 /
FOCUS 6)→ 工作树两档均 **EXIT=0**;账号侧四条 chromeless 路由另跑 EXIT=0(硬档 0);
最终代码 14:25→14:36 干净复跑 430 档 0 条违规。规范落点 docs/UI规范.md §15.13、§16 第 9 步。
2026-11-08 14:50:07 +08:00
..
legacy UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档 2026-11-03 12:42:28 +08:00
aligncheck.py 用户管理按其它模块的口径重做,卡头不再复读页签与角标 2026-11-06 01:12:21 +08:00
btnclustercheck.py v 0.1.1 2026-11-05 16:53:24 +08:00
btnrowcheck.py 规范与闸门收口:R19 反馈四级、R20 标题前不挂图形写进硬规则,探针补到十道 2026-11-03 23:58:44 +08:00
classaudit.mjs NEX 阶段 8·N16:断点治理装上机器闸,登记从「两份人写的表」变成一条可对账的规矩 2026-11-07 22:39:17 +08:00
feedbackcheck.py 用户管理按其它模块的口径重做,卡头不再复读页签与角标 2026-11-06 01:12:21 +08:00
footercheck.py 用户管理按其它模块的口径重做,卡头不再复读页签与角标 2026-11-06 01:12:21 +08:00
gateprobe.py NEX 阶段 8.5·第4项:第 9 闸升级为语义与行为检查(semanticcheck 1062 行)+ 咬出的 4 类真缺陷就地修复 2026-11-08 14:50:07 +08:00
gridcheck.py v 0.1.1 2026-11-05 16:53:24 +08:00
helpshots.py v 0.1.1 2026-11-05 16:53:24 +08:00
rhythmcheck.py 规范补到十七条并把探针升到「六道 + 一道反向验证」:行高、栅格、纵向节奏、标签底色全部有闸 2026-11-03 20:21:39 +08:00
semanticcheck.py NEX 阶段 8.5·第4项:第 9 闸升级为语义与行为检查(semanticcheck 1062 行)+ 咬出的 4 类真缺陷就地修复 2026-11-08 14:50:07 +08:00
symmetrycheck.py 用户管理按其它模块的口径重做,卡头不再复读页签与角标 2026-11-06 01:12:21 +08:00
tableaudit.py v 0.1.1 2026-11-05 16:53:24 +08:00
tagcheck.py v 0.1.1 2026-11-05 16:53:24 +08:00
visualcheck.py NEX 阶段 8·D17/N7:<768 导航改左抽屉,同一屏只剩一个导航入口,顶栏胶囊溢出归零 2026-11-07 23:36:48 +08:00