ZacharyZhang-NYandClaude Opus 5.5
8a942e6d80
PRD and agents.md name the native route; ElyMail's body will not use CEF or Electron. ElyMark's package carries the KaTeX fonts' OFL. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
3.6 KiB
3.6 KiB
无障碍与国际化复核
首版六个应用，2026-10-08，macOS 27.0。每条写依据；做不到或未验证的写明。
键盘
| 要求 | 依据 | 缺口 |
|---|---|---|
| 键盘完成打开、编辑、保存、搜索与主要工具 | 共用命令（ely_ui::commands：新建、打开、保存、另存为、导出、打印、关闭标签 Cmd+W、命令面板、设置），各应用的查找（Cmd+F）与模式键；shell.sh、doc-shell.sh、mark-tools.sh 以按键驱动 |
拖动类操作（图片手柄、透视表字段、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 的文案与选区统计的名称 | — |