nex_animation/docs
mula.liu 687bf5a64d 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 新增「可排序条目的键盘移动方式」五条(子仓库单独提交)。
2026-11-08 00:16:30 +08:00
..
MiniMaxH3_Spark_性能诊断与优化方案.md v 0.1.0 2026-11-01 16:18:07 +08:00
NEX-对照与例外.md NEX 阶段 8·N14:分镜排序补上键盘替代 ⌥↑/⌥↓,改镜序不再是鼠标专属 2026-11-08 00:16:30 +08:00
UI规范.md NEX 阶段 8·N14:分镜排序补上键盘替代 ⌥↑/⌥↓,改镜序不再是鼠标专属 2026-11-08 00:16:30 +08:00
会话工作流整理.md 文档与脚本同步 React+Tailwind:UI 规范增加词汇→原语对照,工程规范补 frontend/src 分层与扩展点,README 目录/构建口径更新 2026-11-01 19:01:03 +08:00
工程规范.md NEX 阶段 6 拆 kit 与清死代码:Panel/Controls 按职责分成五份、删 7 个 0 调用导出与 2 个死 hook、R8 承认 app 为外壳层 2026-11-07 18:21:47 +08:00