NEX 阶段 8·N14:分镜排序补上键盘替代 ⌥↑/⌥↓,改镜序不再是鼠标专属
阶段 2 把分镜卡做到「点得开」,但排序仍然只有两条鼠标路(HTML5 拖拽 + 分镜表两颗按钮):
键盘能走到卡片,却走不动卡片。用户批准 N14 后按「不加新控件」的口径补齐第二条路。
实现(frontend/src/pages/project/Storyboard.tsx):
- move() 回传 Promise<boolean>(越界 false,其余走 run() 的既有返回值)。三个
void move(...) 调用点一字未改,行为不变——run() 本来就返回布尔,只是没人接。
- 新增 moveByKey():越界报「镜头 N 已经在第 M 位,无法继续前移/后移」,成功报
「已后移到第 M 位」;随后 refocusShotCard()(rAF 最多 8 帧找回 [data-shot-card])
把焦点还给同一张卡——列表整体重排会把卡片重挂、焦点掉回 <body>,
不归还的话第二下按键根本没有落点,等于「只能移一格」。拿不到就不抢焦点。
- ShotCard.onKeyDown 先接 Alt+↑/↓(preventDefault + stopPropagation)再走 Enter/Space:
卡片正处在 window 那条「方向键切镜」监听的冒泡路径上,不拦一次按键会既移镜又切镜;
window 侧同步加 if (ev.altKey && Arrow) return 兜底,焦点不在卡上时宁可不响应。
- 可达性:aria-keyshortcuts="Alt+ArrowUp Alt+ArrowDown" + 全站一份 sr-only 说明
(卡片用 aria-describedby 指过去)。不给整块热区加 title——原生 tooltip 会盖住
卡内每一处;也不给每张卡的 aria-label 各念一遍——30 张卡念 30 遍同样的话。
aria-label 逐字未改,阶段 2 的口径与探针定位都不受影响。
- 反馈的不对称是刻意的,写进 UI规范.md §13.3 ⑤ 第 3 条:拖拽时卡片跟着手走、落点
由卡片自己说,键盘时手没在版面上、必须由文字说出「成到哪」;判据从「输入方式一致」
改成「用户能不能自己看见落点」。播报走 notify()(Toast 容器本身是常驻 aria-live),
不另起第二条 live region(R19)。
- 不新增卡脚按钮:224 档实测那一行会劈成 2+1(正是 btnclustercheck 拦的形状),
补按钮就得缩控件或加行,两者都属本轮排除的视觉改动。看板/表格像素零变化,
新插入的 sr-only <p> 放 grid 外面,不参与列宽计算。
帮助页同步:pages/Help.tsx 的分镜步骤与快捷键清单加 ⌥↑ / ⌥↓(注明 Win/Linux 用 Alt)。
G3 补「热区不是按钮时快捷键挂在哪」;对照文档 §2.8 更新证据、§5 N14 ⏸→✅、§7 变更记录。
验证:npm run typecheck 通过(中途抓到一处真实 TS1005:普通注释搬进 JSX 子节点)·
npm run build 通过(仅既有 chunk>1200kB 告警)· classaudit 九道闸全 0 EXIT=0 ·
新写专项探针 sortcheck(明暗各 6 组:顺序变了 / 焦点没丢 / 有播报 / 边界会说话且顺序不动 /
不 Alt 的方向键行为不变 / Enter 仍打开检查器)PASS 0 条,对 HEAD 反证 FAIL 14 条 ·
常驻 11 道探针 EXIT=0 ×11(GATEPROBE_OK 11/11,含 feedbackcheck 与 gridcheck)·
visualcheck 120 状态(15 路由 × 4 视口 × 明暗)断言 0 / HTTP 0 / console 0,
另跑 1440 单档 30 状态同样全 0。证据 reports/ui_evidence/nex-p8/n14/。
上游:NEX 08 §2 新增「可排序条目的键盘移动方式」五条(子仓库单独提交)。
main
parent
ae4dd7f68e
commit
687bf5a64d
|
|
@ -142,7 +142,7 @@ NEX 与本项目差异用「项目适配」解决,**不得反向修改本项
|
|||
| NEX 条款 | 状态 | 本项目出处 | 理由 |
|
||||
|---|---|---|---|
|
||||
| §1 语义化交互(不用 `div + onClick`) | **ADOPTED(原则)**;3 处热区 **本轮阶段 2 修** | `Storyboard.tsx:1915`(`<article onClick>`)、`ui/Rows.tsx:11`(`<div onClick>`)、`AppHeader.tsx:60,70`(`Avatar`/`Text` 当链接)——**行号为阶段 0 记录值**;阶段 2 之后三处已分别变为 `Storyboard.tsx:1915+`(带 `tabIndex`/`onKeyDown`)、`ui/Rows.tsx:27`(`clickable` 分支)、`AppHeader.tsx:70`(已是真 `<Link>`) | 原则完全接受;存量违规仅这 3 处(已核实:`MediaThumb.tsx:106`、`AudioPlay.tsx:68`、`MediaLightbox.tsx:186` 均已带 role/tabIndex/aria-modal,**不是**问题) |
|
||||
| §2 焦点与键盘 | COMPLIANT(+ 阶段 2 增补拖拽替代) | `app.css` 全站 `:focus-visible` 兜底;`ui/Table.tsx`、`MediaThumb.tsx`、`AgentConsole.tsx` 键盘处理;`lib/layers.ts::floatingLayerOpen` 分层 Esc | 拖拽排序的键盘替代 NEX 未覆盖 → **N14**,阶段 2 一并补 |
|
||||
| §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(子仓库提交) |
|
||||
| §3 对比度 / 状态不只靠颜色 | COMPLIANT | `UI规范.md` §2.1(标签=点+文字,非仅颜色)、`Status` 文案来自 `lib/format.ts::statusLabel` | 状态一律「点 + 文字」双通道 |
|
||||
| §4 响应式(明确滚动容器) | COMPLIANT;侧栏 <768 **ADOPTED(阶段 8 · N7,见上 §8 行)** | `UI规范.md` §0 R13/R15、§6 外壳表;`LogBox`/`Drawer` 滚动容器在组件内 | 导航抽屉的滚动与焦点行为走 kit `Drawer`,页面侧没有新滚动容器 |
|
||||
| §5 内容与长文本(截断须给完整文案) | COMPLIANT(标签一处破口 **本轮阶段 1 修**) | `ui/Table.tsx::Clamp`、`min-w-0` 约定、`app.css:425-430`(`.nex-tag-text` 省略)| 分镜卡状态标签截断后**取不到完整文案**(缺 `title`)→ D1,阶段 1 修并补探针 |
|
||||
|
|
@ -270,7 +270,7 @@ cd frontend/src && grep -roh -- '--nex-[a-z0-9-]*' . | sort | uniq -c | sort -rn
|
|||
| N11 | 07 §1 把图表写成 Dashboard 固定组成 | 本表 **E6** + 配置 `chart_library_for_alignment_only: forbidden` | 已登记 |
|
||||
| N12 | 07 §2 缺卡片网格列表细则 | 阶段 6 +建议 NEX 补 | 待议 |
|
||||
| N13 | 07 无「审批/评审」模式 | `page_patterns.project_specific: [review-approval]` | 已声明 |
|
||||
| N14 | 08 §1/§2 未覆盖 HTML5 拖拽的键盘替代(分镜排序) | 阶段 2 只做授权内的那 3 处热区,**未**引入 `⌘/Ctrl+↑↓`:改排序交互属产品决策 | ⏸ 待议(不在本轮授权) |
|
||||
| N14 | 08 §1/§2 未覆盖 HTML5 拖拽的键盘替代(分镜排序) | 阶段 8 采纳:分镜卡加 `⌥/Alt + ↑↓`(`Storyboard.tsx::moveByKey`),**不动鼠标拖拽**、不新增卡脚按钮(224 档实测会劈行);快捷键写进 `aria-keyshortcuts` + 一份 `sr-only` 说明 + 使用说明页清单,结果播报走 `notify()`(吐司容器本身是常驻 `aria-live`,见 `UI规范.md` §13.3 ⑤ 第 3 条) | **✅ 已采纳**(阶段 8):NEX `08-accessibility-responsive.md` §2 新增「可排序列表的键盘替代」条款(子仓库提交);本项目侧口径同步 `UI规范.md` §13.3 ⑤ / G3 |
|
||||
| N16 | 04 §8 只说「不允许私有断点」,没给主阶梯放不下时的登记出口 | 本表 **E9** + `UI规范.md` §4「登记断点」口径(一名一使用者 + 必带视口测量 + 禁止裸 `max-[...]`) | **✅ 已采纳**(阶段 8):NEX `04-layout-system.md` 新增 §8.1 命名断点登记出口 + §8.2 窄屏降级范式;本项目侧同步加 `classaudit.mjs` 第 9 闸 BP 做机器对账(`UI规范.md` §4 复核口径改为「九条判据见 §15.1」) |
|
||||
| N15 | 10 阶段 5 未承认「项目已有质量门禁」应复用 | 本表 §2.10 判定 + 建议 NEX 增补复用条款 | 已登记 |
|
||||
|
||||
|
|
@ -288,7 +288,7 @@ cd frontend/src && grep -roh -- '--nex-[a-z0-9-]*' . | sort | uniq -c | sort -rn
|
|||
| 阶段 6 交付项 | kit 拆分与死代码清理:`ui/Panel.tsx` → `Panel`(容器与栅格)+ `State`(六态表面)+ `Info`(只读回显);`ui/Controls.tsx` → `Ctlbar`(控件栏与胶囊)+ `Fields`(字段);`ROW_STEPS` 并入 `grid.tsx`(等分控件栏与 `FormRow` 共读一张降列表);出口仍是 `ui/index.ts`,**业务页 0 diff**,净代码行 655 → 650。删死代码 7 个:`useAsync`、`usePolling`(连带删两个 hook 文件)、`navItemAt`、`Page.Sub`、`Controls.Req`、`Panel.Meta`、`forms/options.summaryOf`、`forms/Select.SelectOptionList`;`Breadcrumb` / `RadioGroup` **保留待用**(见下一行);`classaudit` 第 6 闸 `FB_IMPL` 白名单同步认出 `State.tsx` | ✅ 已完成(见 §7) | 明细见 `reports/NEX阶段4-7实施-2026-11-07.md` |
|
||||
| 阶段 5 交付项 | 反馈预算(N10)落地:`UI规范.md` §13.3 ⑤ 新增两条预算 + 判据;`ModelCenter` 两颗开关补吐司、「已保存/已删除」从抽屉外的页头 `Notice` 改走吐司(页内 `Notice` 只留错误与故障注入);`Library` 5 处裸 `confirm()` → `confirmAction`,录音链 3 颗 → 1 颗(`lib/versions.ts::keepOrRestoreCurrent` 加 `sink` 出口,默认 `notify` 故平台资产库零改动);`Dashboard` 统计卡 xs 档降列改两列(430 首屏可见第一张项目卡);`classaudit` 第 6 闸正则放宽并修掉「只匹配 `window.confirm(`」的反向漏检 | ✅ 已完成(见 §7) | 明细见 `reports/NEX阶段4-7实施-2026-11-07.md` |
|
||||
| 阶段 4 交付项 | 六态表面(首屏骨架 / 抽屉正文骨架 / Forbidden / NotFound)已落地,`visualcheck` 名单 14 → 15 | ✅ 已完成(见 §7) | 明细见 `reports/NEX阶段4-7实施-2026-11-07.md` |
|
||||
| 阶段 1–3 交付项 | 阶段 1(截断兜底 + 探针)、阶段 2(3 处热区可键盘化)、阶段 3(`LAYER` 层级表 + 两处真实遮挡修复)均已落地;N14 拖拽键盘替代除外 | ✅ 已完成(见 §7 三行记录) | 明细见 `reports/NEX阶段0-3实施-2026-11-07.md` |
|
||||
| 阶段 1–3 交付项 | 阶段 1(截断兜底 + 探针)、阶段 2(3 处热区可键盘化)、阶段 3(`LAYER` 层级表 + 两处真实遮挡修复)均已落地;**N14 拖拽键盘替代当时未做**(不在阶段 0–3 授权内),阶段 8 已补,见本表 N14 行与 §7 最后一行 | ✅ 已完成(见 §7 三行记录) | 明细见 `reports/NEX阶段0-3实施-2026-11-07.md` |
|
||||
| 本地杂物目录 | `.trash/`(27M)、`.local/`(352M)仍在磁盘 | 已 gitignore;`AGENTS.md` §1 已声明「不作现状依据」 | 保持,不参与任何统计 |
|
||||
|
||||
---
|
||||
|
|
@ -301,13 +301,14 @@ cd frontend/src && grep -roh -- '--nex-[a-z0-9-]*' . | sort | uniq -c | sort -rn
|
|||
| 2026-11-07 | 阶段 1 落地截断兜底:`visualcheck.py` 新增 `tagtitle` 探针、`ui/Status.tsx` 组件级 `title` 兜底、分镜卡状态标签与顶栏流水线台收口;`UI规范.md` §2.1/§15.2 补「信息标签可截断但必须有兜底」口径;登记缺陷 **D16**(见 §6) | Codex(阶段 1) |
|
||||
| 2026-11-07 | 阶段 2 三处非语义热区可键盘化:分镜卡 `<article>` 加 `tabIndex/aria-label/aria-current` + Enter/Space (守卫 `ev.target === ev.currentTarget`,不套 `role=button` 以免抹掉卡内控件);`ui/Rows.tsx::LogRow` 加 `clickable` 分支(role/tabIndex/onKeyDown,保留 `title` 语义与逐字颜色);`AppHeader.tsx` 品牌区由 `onClick + navigate` 改为真实 `<Link>`,头像与平台名合并为**一个**焦点站点(1440 下块宽 138px 与合并前一致)。登记缺陷 **D17**(见 §6) | Codex(阶段 2) |
|
||||
| 2026-11-07 | 阶段 4 补齐六态表面:新增 `ui/Panel.tsx::SkeletonBlock`(阶段 6 起在 `ui/State.tsx`)(antd `Skeleton` + `role=status` + `sr-only` + `.nex-skeleton` 闸门落点,不传 `label` 时整块 `aria-hidden` 以免一屏播两句进度)与两页兜底 `pages/Forbidden.tsx`(`AuthGate` 拦住非管理员时就地解释,权限规则未变)、`pages/NotFound.tsx`(`router.tsx` 的 `path:'*'` 不再静默 `Navigate` 回首页);`Drawer` 新增 `loading` 并接入 `ProjectBriefDrawer`;三处首屏 `<Loading>` 换成骨架后旧导出连同其 antd `Spin` import 一并删除;`UI规范.md` 新增 §13.8 六态表面 + §10 抽屉骨架口径 + §15.2 名单 14→15;`visualcheck.py` 增加 `/not-a-page` 探针(不入 `NAV_ROUTES`)与「页面不存在」文案断言 | Codex(阶段 4) |
|
||||
| 2026-11-07 | **阶段 8(已批准决策 ①–③,逐项一次提交;④ N14 见下一行)**:① **D16** `ui/Status.tsx::Tag` 的 `className` 并进 `cn()`,三处站点按实测能力边界改写,`classaudit` 增第 8 闸 TAGSKIN;② **N16** `classaudit` 增第 9 闸 BP(断点五判据机器对账),NEX 子仓库补 `04-layout-system.md` §8.1「命名断点登记出口」;③ **D17/N7** <768 导航改 `AppNavDrawer`(kit `Drawer` 加 `placement`/`flushBody`,侧栏撤 `breakpoint="md"`,菜单本体 `AppNavMenu` 两处共用),430 顶栏胶囊溢出归零、正文 366→430,`visualcheck` 的菜单断言补窄屏抽屉路径并顺手修掉 `NAV_ROUTES` 模板失配(覆盖 3 → 10 条路由)。`UI规范.md` §4 `insp-sm` 理由同步、§6 外壳表加抽屉行、§15 第 3 条改口径;`nex.config.yaml` shell 段加 `sidebar_narrow: drawer` | Codex(阶段 8) |
|
||||
| 2026-11-07 | **阶段 8(已批准决策 ①–③,逐项一次提交;④ N14 见本表最后一行)**:① **D16** `ui/Status.tsx::Tag` 的 `className` 并进 `cn()`,三处站点按实测能力边界改写,`classaudit` 增第 8 闸 TAGSKIN;② **N16** `classaudit` 增第 9 闸 BP(断点五判据机器对账),NEX 子仓库补 `04-layout-system.md` §8.1「命名断点登记出口」;③ **D17/N7** <768 导航改 `AppNavDrawer`(kit `Drawer` 加 `placement`/`flushBody`,侧栏撤 `breakpoint="md"`,菜单本体 `AppNavMenu` 两处共用),430 顶栏胶囊溢出归零、正文 366→430,`visualcheck` 的菜单断言补窄屏抽屉路径并顺手修掉 `NAV_ROUTES` 模板失配(覆盖 3 → 10 条路由)。`UI规范.md` §4 `insp-sm` 理由同步、§6 外壳表加抽屉行、§15 第 3 条改口径;`nex.config.yaml` shell 段加 `sidebar_narrow: drawer` | Codex(阶段 8) |
|
||||
| 2026-11-07 | 阶段 7 断点归一:`styles/index.css` 增设 5 把**登记断点**(1400/1240/1080/720/620,一名一使用者),`Storyboard.tsx` 4 处 + `AgentConsole.tsx` 10 处裸 `max-[...]` 全部改名,px 与媒体查询一字未动(`@media not all and (width>=…)` 逐条比对);`UI规范.md` §4 新增「登记断点」表 + R9 补登记出口;`visualcheck.py` 断点表同步 | Codex |
|
||||
| 2026-11-07 | 阶段 6 拆 kit 与清死代码:`ui/Panel.tsx` 拆出 `ui/State.tsx`(ProgressBar/Empty/SkeletonBlock/Spinner/Notice)与 `ui/Info.tsx`(Value/LineHint/Mono/ExtLink/Info/Count),`ui/Controls.tsx` 拆成 `ui/Ctlbar.tsx` 与 `ui/Fields.tsx` 后删除原文件,`ROW_STEPS` 移进 `grid.tsx`;`components/ui/index.ts` 出口扩到 5 个模块,业务页 0 改动;删 7 个 0 调用导出与 2 个死 hook 文件;R8 承认 `app/` 为外壳层(解本文件 §6 第一条漂移),`UI规范.md`/`工程规范.md`/`app.css`/`App.tsx`/`Status.tsx` 五处实现路径同步 |
|
||||
| 2026-11-07 | 阶段 5 定反馈预算(N10):`UI规范.md` §13.3 新增 ⑤「一次操作的反馈预算」(实测三页 notify 计数 + 每操作链颗数、两条预算、判据「吐司说成了,页面说成什么样」);`pages/ModelCenter.tsx` 的 `patchRow` 补一颗结果吐司(启用/停用/设为默认此前零反馈),`save`/`remove` 的页头 `Notice` 改 `notify({title,desc})` 并删除 `notice` state(页内 `Notice` 只留 `error` 与故障注入两处持续状态);`pages/project/Library.tsx` 5 处裸 `confirm()` → `await confirmAction({title,desc,tone,confirmIcon})`,`onRecord` / `recordGenerationReference` 经新增的 `speak`/`joinLines` 合成一颗;`lib/versions.ts::keepOrRestoreCurrent` 新增第三形参 `sink`(默认 `notify`,平台资产库两个调用点未改);`scripts/ui/classaudit.mjs` 第 6 闸正则从只匹配 `window.confirm(` 放宽为 `/(?<![\w.$])(?:window\.)?(?:confirm|alert)\s*\(/` 并写入十一例自查(阶段 5 曾把可选前缀写在 lookbehind 之前,导致 `window.confirm(` 反向漏检);`pages/Dashboard.tsx` 统计卡 `steps={[{at:'lg',cols:2}]}` 只改 xs 一档 | Codex(阶段 5) |
|
||||
| 2026-11-07 | 阶段 3 建立层级表:新增 `lib/layers.ts::LAYER`(header 20 / toolbar 40 / scrim 55 / sheet 60 / antd 1000 / preview 1020 / recorder 1030 / confirm 1190 / toast 1200),7 处浮层改为引用 `LAYER.*`(AppHeader 顶栏 / Page 粘性工具条 / Overlay 遮罩 / Storyboard 检查器 / MediaLightbox 灯箱 / RecordAudio 录音面板 / Confirm 确认框,`Overlay::Modal` 并新增可选 `zIndex` 形参),另有 2 条必须贴在 antd 节点上的 CSS 值(`app.css` 1100 / 1200)保持原数并加注释指回层级表;修掉两条**实测存在**的遮挡(抽屉里点开灯箱看不见、声线抽屉里录音面板点不着),并给确认框第一次显式层级以免灯箱抬升后压不住;`UI规范.md` §10 重写(层级表 + 修正过时的「挂载点」口径 + 两条「不进表」例外) | Codex(阶段 3) |
|
||||
| 2026-11-07 | 阶段 8·N16 断点治理:`classaudit.mjs` 新增**第 9 闸 BP**——以 `styles/index.css` 的 `--breakpoint-*` 为唯一真相,向「页面用词 / `UI规范.md` §4 登记表 / `visualcheck.py` 的 `BP`·`BPORDER` / `.css` 里的 `@media` 像素」四处对账(五条判据,含「登记尺子必须只有一个使用者」「探针表缺名会静默跳过断言」两条隐性失配);闸本身按 §15.1 口径反证过 10 例(`reports/ui_evidence/nex-p8/n16/scripts/gate_bp_proof.py`:写坏→红且点名→还原复绿);NEX 侧 `04-layout-system.md` 新增 §8.1 命名断点登记出口 / §8.2 专业工作区窄屏降级范式(子仓库提交,见实施报告 §2);`UI规范.md` §4 复核口径从「grep 必须为 0」改为机器闸、§15.1 闸表 8→9;`nex.config.yaml` 补 `breakpoints_registered` 与 9 道子闸注释 | Codex(阶段 8·N16) |
|
||||
| 2026-11-07 | 阶段 8·D16 修 `Tag` 吞 className:`components/ui/Status.tsx` 把 `className` 并进 `cn()` 末位(此前 10 处站点空转);顺带查实「utility 大面积失效」的两半真相——`index.css:55` 未层 `@import` 使 `.nex-tag.ant-tag` 独占 13 族属性 + `.ant-tag` 的 `transition: all .2s` 让改类后首帧读到起始值;`ModelCenter.tsx:973` 皮肤类改 `font-bold`、`Review.tsx:363` 改 `tone="mono"`、`Storyboard.tsx` 撤 flex-none wrapper、`PipelineConsole.tsx` wrapper 保留并注明只服务 display 族;`UI规范.md` 新增 §1.1.1(能力矩阵 + 200ms 坑);`classaudit.mjs` 新增第 8 闸 TAGSKIN;932 颗标签逐站点 diff,46 处差异全落在预期站点 | Codex(阶段 8·D16) |
|
||||
| 2026-11-07 | 阶段 8·N14 分镜排序的键盘替代:`pages/project/Storyboard.tsx` 的 `move()` 改为回传`Promise<boolean>`(越界 `false`,三个 `void move(...)` 调用点一字未改),新增 `moveByKey()` —— 越界时报「已经在第 N 位,无法继续前移/后移」、成功时报「已后移到第 M 位」并把焦点还给同一张卡(`refocusShotCard()`:rAF 最多 8 帧找回 `[data-shot-card]`,拿不到就不抢焦点,否则第二下按键没有落点);`ShotCard` 的 `onKeyDown` 先接 `Alt+↑/↓`(`preventDefault + stopPropagation`,卡片就在 window 那条「方向键切镜」监听的冒泡路径上,不拦会一次按键既移镜又切镜),window 侧同步加 `if (ev.altKey && Arrow) return` 兜底;可达性用 `aria-keyshortcuts="Alt+ArrowUp Alt+ArrowDown"` + 全站一份 `sr-only` 说明(`aria-describedby` 指过去),**不新增卡脚按钮**(224 档实测会劈行);`pages/Help.tsx` 快捷键清单与分镜步骤同步 `⌥↑` / `⌥↓`。口径落 `UI规范.md` §13.3 ⑤ 第 3 条(键盘路径必须播报、拖拽路径不播报的不对称)与 G3(热区不是按钮时快捷键挂在哪);NEX 侧 `08-accessibility-responsive.md` §2 新增「可排序列表必须提供键盘移动方式」(子仓库提交)。专项探针 `reports/ui_evidence/nex-p8/n14/scripts/sortcheck.py`:Light/Dark 各跑「顺序变了 / 焦点没丢 / 有播报 / 边界会说话 / 不 Alt 的方向键行为不变 / Enter 仍打开检查器」,PASS 0 条;对 HEAD 反证 FAIL 14 条 | Codex(阶段 8·N14) |
|
||||
|
||||
**维护约定**
|
||||
1. 新增/修改一条 E:必须同时给代码证据位置,否则视为未登记。
|
||||
|
|
|
|||
16
docs/UI规范.md
16
docs/UI规范.md
|
|
@ -1441,8 +1441,17 @@ antd 的 `Tag.CheckableTag` 未选中态是**完全透明**的。铺进等宽格
|
|||
2. **需要被阅读、会被复述的内容不许只活在吐司里。** 版本号、被跳过的数量、可复制的标识、
|
||||
下一步动作,落在页内 `Notice` / 表格行上;吐司只回答「刚才那一下成了没」(本表 ③ 行)。
|
||||
反过来也成立:页内已经有 `Notice` 说过的事,不再补一颗吐司。
|
||||
3. **结果播报跟着「用户能不能自己看见落点」判,不跟着「输入方式统一」判**
|
||||
(2026-11-07 · 阶段 8 · N14)。同一个动作换了输入方式,反馈预算可以不一样,这不是不一致:
|
||||
鼠标拖动分镜卡时卡片跟着指针走,落点它自己就说清楚了,再补一颗「已移到第 3 位」是第 ③ 句废话;
|
||||
键盘 `⌥↑` / `⌥↓` 移动同一张卡时手没在版面上,读屏用户更是只剩列表闪一下,
|
||||
「它刚从第 4 位来到第 3 位」必须由文字说出来(`pages/project/Storyboard.tsx::moveByKey`)。
|
||||
**到头了也要说话**(「镜头 3 已经在第 1 位,无法继续前移」)——静默不动会被当成快捷键没生效,
|
||||
这条对鼠标同样成立,只是拖到边界时指针本身给了阻力。
|
||||
播报一律走 `notify()`:`components/ui/Toast.tsx` 的容器本身就是常驻 `aria-live="polite"`,
|
||||
给键盘操作另起一条 live region 就是全站第二个播报通道。
|
||||
|
||||
判据一句话:**吐司说「成了」,页面说「成什么样」。**
|
||||
判据一句话:**吐司说「成了」,页面说「成什么样」;看不见落点的那只手,吐司还得说「成到哪」。**
|
||||
|
||||
同一条改动顺手收掉一个静默漏洞:裸调用 `confirm(...)` / `alert(...)` 与 `window.confirm(...)`
|
||||
是同一个原生对话框,而 `classaudit` 第 6 闸原本只匹配字面量 `window.confirm(`,
|
||||
|
|
@ -1707,6 +1716,11 @@ URL 没变,effect 不再触发。
|
|||
### G3 · 快捷键 / 图标含义只在 hover
|
||||
纯图标或符号按钮必须有 `title` 或 `aria-label`(R11);快捷键(`⌘S` / `J`/`K` / `Esc`)
|
||||
写在相关按钮的 `title` 里,不再单独占一行文字。
|
||||
**热区不是按钮时没有 `title` 可挂**(看板分镜卡是整块 `<article>` 热区,见 N14 的 `⌥↑` / `⌥↓`):
|
||||
键位用 `aria-keyshortcuts` 声明,说明文字全站只写**一份** `sr-only` 节点、每张卡用
|
||||
`aria-describedby` 指过去(一份而不是每张卡一句:30 张卡念 30 遍同样是要清掉的冗余),
|
||||
页面级快捷键清单以「使用说明」页为唯一登记处。**不许**为了这条给整块热区补 `title`——
|
||||
原生 tooltip 会盖住卡内每一处,鼠标划过就是一片浮字。
|
||||
|
||||
### G4 · 表单内的「增 / 删」:写法见 §5.1,这里只管摆位
|
||||
自造 `variant` 方言已废(`mapVariant` 也删了),按钮的语义 → antd 轴映射**只在 §5.1 写一次**。
|
||||
|
|
|
|||
|
|
@ -472,7 +472,7 @@ export default function Help() {
|
|||
用搜索框和状态 / 模式 / 排序筛选定位镜头,或点“仅看阻塞”“仅看缺关键帧”直接清理预检问题。
|
||||
</li>
|
||||
<li>
|
||||
拖动卡片即可改镜序(分镜表视图也可拖行或用 ↑↓);勾选多个镜头后可批量复制、移到最前、统一改参数或删除。
|
||||
拖动卡片即可改镜序(不用鼠标也行:Tab 走到卡片上,按 <Code>⌥↑</Code> / <Code>⌥↓</Code> 前移后移,分镜表视图也可拖行或用 ↑↓);勾选多个镜头后可批量复制、移到最前、统一改参数或删除。
|
||||
</li>
|
||||
<li>
|
||||
选中镜头后在检查器编辑参数与绑定;提示词页可切换“自动组装 / 人工覆盖”,并回填任意历史版本。
|
||||
|
|
@ -484,7 +484,7 @@ export default function Help() {
|
|||
需要交给编剧或外部工具时,用右上角导出 Markdown / CSV / JSON,导出的 Markdown 可以直接再导回来。
|
||||
</li>
|
||||
</ol>
|
||||
<Notice type="info"><b>快捷键:</b> <Code>J</Code> / <Code>K</Code> 或 <Code>↑</Code> <Code>↓</Code> 切换镜头,<Code>X</Code> 勾选当前镜头, <Code>⌘S</Code> 保存检查器改动,<Code>Esc</Code> 关闭检查器或导入面板。首屏只拉轻量看板数据, 几十上百镜也不会拖慢页面。</Notice>
|
||||
<Notice type="info"><b>快捷键:</b> <Code>J</Code> / <Code>K</Code> 或 <Code>↑</Code> <Code>↓</Code> 切换镜头,<Code>X</Code> 勾选当前镜头, <Code>⌥↑</Code> / <Code>⌥↓</Code> 把当前卡片前移或后移一镜(等同拖动,Windows / Linux 用 <Code>Alt</Code>), <Code>⌘S</Code> 保存检查器改动,<Code>Esc</Code> 关闭检查器或导入面板。首屏只拉轻量看板数据, 几十上百镜也不会拖慢页面。</Notice>
|
||||
</section>
|
||||
<section id="dispatch" className={SECTION}>
|
||||
<Heading level={2}>05 · 任务调度</Heading>
|
||||
|
|
|
|||
|
|
@ -841,18 +841,44 @@ export default function Storyboard() {
|
|||
}))
|
||||
}
|
||||
/** 上移/下移按镜头 id 定位:筛选或排序后可见序号 ≠ 全量序号,用行号会移动错镜头 */
|
||||
async function move(shot: any, delta: number) {
|
||||
async function move(shot: any, delta: number): Promise<boolean> {
|
||||
const rows = live.current.shots
|
||||
const at = rows.findIndex((s) => s.id === shot.id)
|
||||
const target = at + delta
|
||||
if (at < 0 || target < 0 || target >= rows.length) return
|
||||
await run('调整顺序', () => api.post(`/api/projects/${projectId}/shots/bulk`,
|
||||
if (at < 0 || target < 0 || target >= rows.length) return false
|
||||
return run('调整顺序', () => api.post(`/api/projects/${projectId}/shots/bulk`,
|
||||
{ action: 'move', shot_ids: [shot.id], index: target + 1 }))
|
||||
}
|
||||
function canMove(shot: any, delta: number) {
|
||||
const at = shots.findIndex((s) => s.id === shot.id)
|
||||
return at >= 0 && at + delta >= 0 && at + delta < shots.length
|
||||
}
|
||||
/**
|
||||
* 键盘排序(NEX 08 §2 / N14):卡片能聚焦了,还得能**移动**,
|
||||
* 否则「键盘可达」只到「点得开」为止,改镜序这件事仍然是鼠标专属。
|
||||
*
|
||||
* 只有键盘路径报结果,拖拽不报:拖的那张卡自己会跟着手走,落点它已经看见了;
|
||||
* 键盘用户看不见「它刚从第 4 位来到第 3 位」这件事,得由文字说出来。
|
||||
* 反馈走 notify() 而不是新的 live region——components/ui/Toast.tsx 的容器
|
||||
* 本身就是常驻 aria-live="polite",再造一个就是全站第二条播报通道(R19)。
|
||||
* 到头了也要说话:静默不动会被当成「快捷键没生效」。
|
||||
*/
|
||||
async function moveByKey(shot: any, delta: number) {
|
||||
if (busy) return
|
||||
const rows = live.current.shots
|
||||
const at = rows.findIndex((s) => s.id === shot.id)
|
||||
const to = at + delta
|
||||
const name = `镜头 ${shot.code || shot.order_index}`
|
||||
const dir = delta < 0 ? '前移' : '后移'
|
||||
if (at < 0 || to < 0 || to >= rows.length) {
|
||||
notify(`${name} 已经在第 ${at + 1} 位,无法继续${dir}`)
|
||||
return
|
||||
}
|
||||
if (await move(shot, delta)) {
|
||||
notify(`${name} 已${dir}到第 ${to + 1} 位`)
|
||||
refocusShotCard(shot.id)
|
||||
}
|
||||
}
|
||||
/** 卡片上的「⧉」只复制当前镜头,不跟着勾选集走 */
|
||||
async function duplicateOne(shot: any) {
|
||||
await run('复制镜头', () => api.post(`/api/projects/${projectId}/shots/bulk`,
|
||||
|
|
@ -1094,6 +1120,9 @@ export default function Storyboard() {
|
|||
return
|
||||
}
|
||||
if (typing) return
|
||||
// Alt+↑/↓ 是卡片自己的排序键(N14):焦点不在卡上时什么都不做,
|
||||
// 更不能落到下面那两行「方向键 = 切镜」上,否则一次按键同时改镜序又换选中。
|
||||
if (ev.altKey && (ev.key === 'ArrowUp' || ev.key === 'ArrowDown')) return
|
||||
if ((ev.metaKey || ev.ctrlKey) && ev.key.toLowerCase() === 's') {
|
||||
ev.preventDefault()
|
||||
if (live.current.selectedId || live.current.creating) void fns.current.saveShot()
|
||||
|
|
@ -1326,34 +1355,44 @@ export default function Storyboard() {
|
|||
</div>
|
||||
</Empty>
|
||||
) : view === 'grid' ? (
|
||||
/* 258px 是「缩略图 + 两行说明 + 脚注三个按钮」不塌的地板;
|
||||
降档用登记断点 board=1240(UI规范.md §4):主阶梯的 xl=1200 太晚,
|
||||
实测 1204–1239(1200px 笔记本的可视宽度)靠 224 的地板排得下 4 列,
|
||||
按 258 排只剩 3 列;邻居 2xl=1600 又太早:1280 会从实测 3 列 328px
|
||||
变 4 列 243px、1440 从 4 列 283px 变 5 列 224px,每张卡缩掉 59–85px。 */
|
||||
<div className="grid min-w-0 grid-cols-[repeat(auto-fill,minmax(258px,1fr))] gap-3 max-board:grid-cols-[repeat(auto-fill,minmax(224px,1fr))]">
|
||||
{filtered.map((s) => (
|
||||
<ShotCard
|
||||
key={s.id}
|
||||
shot={s}
|
||||
projectId={projectId}
|
||||
selected={s.id === selectedId}
|
||||
draggedOver={dragOver === s.id}
|
||||
picked={checked.has(s.id)}
|
||||
busy={!!busy}
|
||||
onSelect={() => void select(s.id)}
|
||||
onCheck={(shift) => toggleCheck(s.id, shift)}
|
||||
onDragStart={() => startDrag(s.id)}
|
||||
onDragOverItem={() => overDrag(s.id)}
|
||||
onDragEnd={() => { setDragOver(null); setDragging(null) }}
|
||||
onDropItem={() => void dropOn(s.id)}
|
||||
onPreview={(which) => previewShot(s, which)}
|
||||
onText={() => void focusText(s)}
|
||||
onDuplicate={() => void duplicateOne(s)}
|
||||
onRemove={() => void removeShot(s)}
|
||||
/>
|
||||
))}
|
||||
</div>
|
||||
<>
|
||||
{/* 排序快捷键的读屏版(N14):一张卡一句太吵,全站就写这一份,
|
||||
每张卡用 aria-describedby 指过来。放 grid 外面而不是里面:
|
||||
放进去它就是第一个网格子项,会被列宽探针算进列数。 */}
|
||||
<p id={SHOT_MOVE_HINT_ID} className="sr-only">
|
||||
聚焦卡片后按住 Alt(macOS 键盘上标的是 Option)加上下方向键,可以把这一镜前移或后移;
|
||||
分镜表视图里也有「前移 / 后移」按钮。
|
||||
</p>
|
||||
{/* 258px 是「缩略图 + 两行说明 + 脚注三个按钮」不塌的地板;
|
||||
降档用登记断点 board=1240(UI规范.md §4):主阶梯的 xl=1200 太晚,
|
||||
实测 1204–1239(1200px 笔记本的可视宽度)靠 224 的地板排得下 4 列,
|
||||
按 258 排只剩 3 列;邻居 2xl=1600 又太早:1280 会从实测 3 列 328px
|
||||
变 4 列 243px、1440 从 4 列 283px 变 5 列 224px,每张卡缩掉 59–85px。 */}
|
||||
<div className="grid min-w-0 grid-cols-[repeat(auto-fill,minmax(258px,1fr))] gap-3 max-board:grid-cols-[repeat(auto-fill,minmax(224px,1fr))]">
|
||||
{filtered.map((s) => (
|
||||
<ShotCard
|
||||
key={s.id}
|
||||
shot={s}
|
||||
projectId={projectId}
|
||||
selected={s.id === selectedId}
|
||||
draggedOver={dragOver === s.id}
|
||||
picked={checked.has(s.id)}
|
||||
busy={!!busy}
|
||||
onSelect={() => void select(s.id)}
|
||||
onCheck={(shift) => toggleCheck(s.id, shift)}
|
||||
onDragStart={() => startDrag(s.id)}
|
||||
onDragOverItem={() => overDrag(s.id)}
|
||||
onDragEnd={() => { setDragOver(null); setDragging(null) }}
|
||||
onDropItem={() => void dropOn(s.id)}
|
||||
onPreview={(which) => previewShot(s, which)}
|
||||
onText={() => void focusText(s)}
|
||||
onDuplicate={() => void duplicateOne(s)}
|
||||
onRemove={() => void removeShot(s)}
|
||||
onMove={(d) => void moveByKey(s, d)}
|
||||
/>
|
||||
))}
|
||||
</div>
|
||||
</>
|
||||
) : (
|
||||
<Panel>
|
||||
{/* 分镜表:antd Table。
|
||||
|
|
@ -1889,6 +1928,30 @@ export default function Storyboard() {
|
|||
它们的类名是从旧站逐条抄来的,脱离这一页就没有第二个使用者,
|
||||
提前抽成通用组件只会让 ui 目录变成「什么都往里扔」。 */
|
||||
|
||||
/* N14 键盘排序用的三个标识:id 是页面级唯一的说明文字,卡片用 aria-describedby 指它 */
|
||||
const SHOT_MOVE_HINT_ID = 'shot-move-hint'
|
||||
const SHOT_MOVE_KEYSHORTCUTS = 'Alt+ArrowUp Alt+ArrowDown'
|
||||
|
||||
/**
|
||||
* 排序之后把焦点还给同一张卡。
|
||||
*
|
||||
* 不这么做的话:move() 里 load() 会整表换掉 rows,卡片重挂,焦点掉回 <body>,
|
||||
* 键盘用户按第二下 Alt+↓ 时已经没有落点,等于「只能移一格」。
|
||||
* 为什么 rAF 重试而不是同步 focus:数据是 await load() 之后才 setState 的,
|
||||
* 本函数返回时新列表通常还没画完,同步 focus 会作用在旧节点上。
|
||||
* 最多 8 帧(约 130ms):拿不到就算了(比如这镜正被筛选条件挡住),
|
||||
* 不去抢 body 之外的焦点,免得把用户本来就放好的焦点弄丢。
|
||||
*/
|
||||
function refocusShotCard(id: number) {
|
||||
let tries = 0
|
||||
const step = () => {
|
||||
const el = document.querySelector<HTMLElement>(`[data-shot-card="${id}"]`)
|
||||
if (el) { el.focus(); return }
|
||||
if (++tries < 8) requestAnimationFrame(step)
|
||||
}
|
||||
requestAnimationFrame(step)
|
||||
}
|
||||
|
||||
/**
|
||||
* 看板卡(.card):整张卡就是镜头入口,
|
||||
* 所以缩略图预览、勾选框、脚注三处都要各自拦下冒泡,否则点一下会变成「选中镜头 + 打开预览」。
|
||||
|
|
@ -1910,12 +1973,14 @@ type ShotCardProps = {
|
|||
onText: () => void
|
||||
onDuplicate: () => void
|
||||
onRemove: () => void
|
||||
/** ±1 = 前移 / 后移一镜(Alt/Option + ↑↓,与拖拽同一个动作) */
|
||||
onMove: (delta: number) => void
|
||||
}
|
||||
|
||||
function ShotCard({
|
||||
shot: s, projectId, selected, draggedOver, picked, busy,
|
||||
onSelect, onCheck, onDragStart, onDragOverItem, onDragEnd, onDropItem,
|
||||
onPreview, onText, onDuplicate, onRemove
|
||||
onPreview, onText, onDuplicate, onRemove, onMove
|
||||
}: ShotCardProps) {
|
||||
const badge = reviewBadge(s)
|
||||
return (
|
||||
|
|
@ -1937,8 +2002,21 @@ function ShotCard({
|
|||
tabIndex={0}
|
||||
aria-label={'打开分镜详情:镜头 ' + (s.code || s.order_index)}
|
||||
aria-current={selected ? 'true' : undefined}
|
||||
/* N14:快捷键既要用 aria-keyshortcuts 声明(读屏软件可查询),
|
||||
也要在聚焦时真的念出来(不是所有读屏都会念 keyshortcuts),
|
||||
所以再挂一条 sr-only 说明。两者说的是同一串键,不另起名字。 */
|
||||
aria-keyshortcuts={SHOT_MOVE_KEYSHORTCUTS}
|
||||
aria-describedby={SHOT_MOVE_HINT_ID}
|
||||
onKeyDown={(ev) => {
|
||||
if (ev.target !== ev.currentTarget) return
|
||||
/* Alt+↑/↓ = 移动这一镜。必须 stopPropagation:卡片在 window 那条
|
||||
「方向键切镜」监听的冒泡路径上,不拦的话一次按键既移镜又切镜。 */
|
||||
if (ev.altKey && (ev.key === 'ArrowUp' || ev.key === 'ArrowDown')) {
|
||||
ev.preventDefault()
|
||||
ev.stopPropagation()
|
||||
onMove(ev.key === 'ArrowUp' ? -1 : 1)
|
||||
return
|
||||
}
|
||||
if (ev.key !== 'Enter' && ev.key !== ' ') return
|
||||
ev.preventDefault()
|
||||
onSelect()
|
||||
|
|
|
|||
Loading…
Reference in New Issue