ZacharyZhang-NYandClaude Opus 5.5
52f8b84270
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
32 lines
3.7 KiB
Markdown
32 lines
3.7 KiB
Markdown
# 无障碍与国际化复核
|
||
|
||
首版六个应用，2026-10-08，macOS 27.0。每条写依据；做不到或未验证的写明。
|
||
|
||
## 键盘
|
||
|
||
| 要求 | 依据 | 缺口 |
|
||
| --- | --- | --- |
|
||
| 键盘完成打开、编辑、保存、搜索与主要工具 | 共用命令（`ely_ui::commands`：新建、打开、保存、另存为、导出、打印、关闭标签 Cmd+W、命令面板、设置），各应用的查找（Cmd+F）与模式键；`shell.sh`、`doc-shell.sh` 以按键驱动；ElyMark 的块以 Enter、空格打开，由组件库的 gpui 窗口测试覆盖；查找与编辑工具随 C14.9 原生重做 | 拖动类操作（图片手柄、透视表字段、PDF 区域标记）没有键盘替代 |
|
||
| 焦点框不依赖悬停 | 组件库可按元素都是 Tab 停靠点并带 `focus_ring`（7fab072 起 git 行带透明边框使焦点框可见） | — |
|
||
| 内容区与界面间焦点可预测 | Tab 顺序导航→内容→属性→状态（C05.4，`shell.sh`）；浮层关闭后焦点回到打开前之处（组件库 8658999）；文档（LOK 视图）把 Tab 留给自己（制表符、跳单元格、缩进），F6 与 Shift+F6 照 Tab 的次序移出与移回（组件库 029632b；原先没有键盘出口） | ElyMark 原生组件的焦点次序待 C14.16 核对 |
|
||
| 对比度 4.5:1 | 主题与 Omarchy 色板按组件库 `A11yChecker` 规则收口（正文、状态色 4.5:1，焦点与图表色 3:1），核对不过的主题整套不用（C05.1） | 文档内容的颜色取自文件，照原样显示 |
|
||
|
||
## 辅助技术
|
||
|
||
| 要求 | 依据 | 缺口 |
|
||
| --- | --- | --- |
|
||
| 控件有角色与名称 | 组件库核心控件、对话框、列表、树、提交与差异行、设置行（组与说明）、提示（Toast 有角色与名称）；真窗口测试都经 AX 树操作（`ax-values`、`ax-press`） | `lists::Outline` 与 `feedback::Alert` 无角色（上游待办）；gpui 无 aria-disabled，以说明文字表达 |
|
||
| 文档内容可达 | LOK 视图把当前段落（Calc 为当前单元格与输入行）以 `MultilineTextInput` 交给 AX（`lokview.sh` 读到键入后的段落） | gpui 没有文本选区与插入点的 AX：选区、插入点、整篇文档到不了辅助技术；ElyMark 原生组件的 AX 待 C14.16 核对；PDF 页面文字未接 AX |
|
||
| 编辑状态可达 | 保存状态、风险、引擎停止以提示条与状态栏文字表达 | 状态栏文字是否进 AX 树未逐项核对 |
|
||
|
||
## 国际化
|
||
|
||
| 要求 | 依据 | 缺口 |
|
||
| --- | --- | --- |
|
||
| 简中与英文界面 | `ely_ui::i18n` 缺键即失败；组件库面板族、对话框、批注栏等内建中英目录；设置可切语言（下次启动生效） | 组件库 `SortBuilder`、`FilterBuilder`、欢迎页等文案仍为英文（上游待办）；ElyTable 选区统计以外的内核文字为英文 |
|
||
| 中英文输入、组合输入、标点 | LOK 视图与 ElyMark 的编辑器都经输入法回调处理组字（`lokview.sh` 组“你好”；组件库的文档测试）；往返用例含中文（`independent.rs`） | 系统拼音输入法实机只做过人工检查，测试以输入法回调模拟 |
|
||
| 混合字体 | 内核按字体回退排版；缺失字体在 ElyDoc 页面上方列出 | 字体缺失环境的分页对照未做（见 `docs/compatibility.md`） |
|
||
| 非 ASCII 路径 | `paths_keep_spaces_cjk_and_case`（保存）；启动参数按当前目录取绝对路径（C20.1 修） | — |
|
||
| 日期、数字、纸张用显式区域 | 内核载入选项固定 `Language=en-US`（`ely-lok/src/worker.rs` 的 `LOAD_OPTIONS`），公式为 Excel A1 语法；纸张取自文档本身并原样打印（C19.2） | — |
|
||
| 改界面语言不重解释已存数值 | 同上：内核的数字区域不随界面语言，界面语言只改 Ely 的文案与选区统计的名称 | — |
|