From 418fb6bc5a06bc2e8d180089de9938b3d2b5cc4c Mon Sep 17 00:00:00 2001 From: "mula.liu" Date: Sun, 8 Nov 2026 17:24:23 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E8=A7=84=E8=8C=83):=20=E5=9B=BE=E6=A0=87?= =?UTF-8?q?=E8=AF=AD=E4=B9=89=E4=B8=89=E6=A1=A3=E5=8F=A3=E5=BE=84=E5=85=A5?= =?UTF-8?q?=E5=86=8C=20+=20=E9=98=B6=E6=AE=B5=208.5.1=20=E5=AE=9E=E6=96=BD?= =?UTF-8?q?=E6=8A=A5=E5=91=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - docs/UI规范.md §5.1.1:AT-1 从「在册待办」改成成文口径——图标默认是装饰,语义由 它所在的控件说;三档(默认装饰 / 显式具名 / 显式放行)与两头禁止(不许批量 aria-hidden,也不许批量具名);antd 内部自绘图形的处理边界与两类不动的理由写清。 §15.12 十四条 → 十七条判据 + 「对偶断言」规矩;§15.13 补 GLYPH 第 8 条判据与四档读数; §16 第 9 步把两道新闸纳入改动流程。 - docs/NEX-对照与例外.md §2.8:S-2 标 COMPLIANT + 验收手段;§6 记一条 InputNumber 英文 aria-label 漂移(P2,改它要动 antd 内部 DOM 或全站 locale);§7 变更记录。 - nex.config.yaml:ui_gates 注释与代码对齐(出口形状 ICONA / GLYPH / 17 条判据), census-icons.py 登记为只读普查、不进串行。 - 阶段 8.5.1 报告:S-2 现状量级(字形名可见 900 → 80、唯一语义 42 → 0、AX 名称含 字形码 261 → 1)、改法、防复发、120 状态像素回归与噪声对照、真机 VoiceOver 实录、 未解决与 MANUAL QA 边界逐条附证据路径。 不复制规范:只在与代码口径冲突处改既有章节,未新建重复文档。 --- docs/NEX-对照与例外.md | 5 +- docs/UI规范.md | 88 ++- nex.config.yaml | 7 +- ...X阶段8.5.1-S-2图标可访问名称-2026-11-08.md | 522 ++++++++++++++++++ 4 files changed, 601 insertions(+), 21 deletions(-) create mode 100644 reports/NEX阶段8.5.1-S-2图标可访问名称-2026-11-08.md diff --git a/docs/NEX-对照与例外.md b/docs/NEX-对照与例外.md index 81d543c..707c1d1 100644 --- a/docs/NEX-对照与例外.md +++ b/docs/NEX-对照与例外.md @@ -143,8 +143,9 @@ NEX 与本项目差异用「项目适配」解决,**不得反向修改本项 | NEX 条款 | 状态 | 本项目出处 | 理由 | |---|---|---|---| | §1 语义化交互(不用 `div + onClick`) | **ADOPTED(原则)**;3 处热区 **本轮阶段 2 修** | `Storyboard.tsx:1915`(`
`)、`ui/Rows.tsx:11`(`
`)、`AppHeader.tsx:60,70`(`Avatar`/`Text` 当链接)——**行号为阶段 0 记录值**;阶段 2 之后三处已分别变为 `Storyboard.tsx:1915+`(带 `tabIndex`/`onKeyDown`)、`ui/Rows.tsx:27`(`clickable` 分支)、`AppHeader.tsx:70`(已是真 ``) | 原则完全接受;存量违规仅这 3 处(已核实:`MediaThumb.tsx:106`、`AudioPlay.tsx:68`、`MediaLightbox.tsx:186` 均已带 role/tabIndex/aria-modal,**不是**问题) | +| §1/§2 控件的可读名称必须是自然语言——装饰图形的**字形码不得混入**(`upload 导入脚本`) | **COMPLIANT(阶段 8.5.1 · S-2 修)**;antd 内部图形的英文宿主名称另记 §6 一条漂移 | `components/icons/index.ts`(全站唯一图标出口,79 条一律 `decorative(Glyph,'IconX')`,**三档口径**:默认 `aria-hidden` / 显式 `aria-label` 走具名 / 显式 `aria-hidden={false}` 尊重调用方)、`ui/Input.tsx`(搜索按钮「搜索」+ 清空键「清空搜索」)、`ui/Ctlbar.tsx::Pager`(`itemRender` → 上一页/下一页)、`ui/Tabs.tsx`(溢出「更多页签」)、`forms/SecretInput.tsx`(「显示/隐藏密码」两态);两道机器闸:`classaudit` 第 2 闸 `ICONA`(源码侧出口形状)+ `semanticcheck` 第 8 条 `GLYPH`(DOM 侧字形码),`gateprobe` 配静态反例 | NEX 08 说「名称要能读」但没说什么算泄漏。本项目的口径是**两头都不许一刀切**:既不许批量 `aria-hidden`(那会把 42 处「图标是宿主唯一语义」变成没有名字),也不许给图标补 `aria-label={字形名}`(那正是缺陷本身)。改前 1 072 条图标读数里 **900 只**把字形码念出去、**42 只**是宿主唯一名称来源 → 改后 **80 / 0**;4 处调用点原本就写着 `aria-hidden` 的照旧尊重(不是批量加的) | | §2 焦点与键盘 | COMPLIANT(阶段 2 三处热区可键盘化 + **阶段 8 补排序键盘替代 N14**) | `app.css` 全站 `:focus-visible` 兜底;`ui/Table.tsx`、`MediaThumb.tsx`、`AgentConsole.tsx` 键盘处理;`lib/layers.ts::floatingLayerOpen` 分层 Esc;`Storyboard.tsx::moveByKey` + `ShotCard` 的 `aria-keyshortcuts` / `aria-describedby` | 拖拽排序的键盘替代 NEX 原本未覆盖 → **N14**,阶段 2 只做授权内的 3 处热区,**阶段 8 用户批准后落地**(`⌥↑` / `⌥↓`,实测见 `reports/ui_evidence/nex-p8/n14/`),并反向提交给 NEX `08` §2(子仓库提交) | -| §2/§3/§5 的**验收手段**(可访问名称 / 焦点可见 / 状态播报 / 空错载 是否真成立) | **COMPLIANT(阶段 8.5 起有机器证据)**;软档 20 颗/主题待 P2 | `scripts/ui/semanticcheck.py`(第 13 道常驻探针,七条判据 NAME/HOTSPOT/TAB/FOCUS/ARIA/LIVE/STATES,全部走 CDP 的 AX 树与真按键,不读源码字符串)、`UI规范.md` **§15.13**、本轮两处真缺陷修复 `pages/AssetLibrary.tsx:1217/1274/1359`(三颗裸 `Checkbox` 补 `aria-label`)、`styles/app.css:519`(`:has()` 补回被全局复位吃掉的上传按钮焦点环) | NEX 08 只列要求、没给「怎么证明」,此前本项目也只在源码里数 `aria-*` 字符串——实测这种数法**两个真缺陷一个都抓不到**(D-A 旁边有文字、D-B 病灶在 CSS)。HEAD `5a10bfb` 同尺对照:改前硬档 **58 条**(NAME 20 / HOTSPOT 16 / TAB 16 / FOCUS 6,1440 与 430 两档读数相同)→ 工作树改后硬档 0;那 40 条 NAME 软档(20 每主题)不计退出码;剩下的软档 19 类同一根因:`ui/Fields.tsx::Field` 孤立使用 antd `Form.Item`(外层无 `
`)⇒ `