无障碍 · 2026 年 4 月更新

无障碍声明

Name: RichTextEditor
Price: 129 USD
Author: Richscripts Inc.

Richscripts Inc. 致力于让每个人都能使用 RichTextEditor，无论他们在撰写和审阅文档时使用哪种辅助技术。本页说明我们的目标、目前可以正常工作的部分，以及我们已知尚未达标的地方。

合规目标

RichTextEditor 以符合Web 内容无障碍指南（WCAG）2.2 AA 级为目标。编辑器基于原生 contenteditable 和标准语义化 HTML 构建，在仅靠语义化 HTML 不够的地方使用 ARIA 角色/属性。

第三方无障碍审核报告和正式的 VPAT 尚未发布。在获得独立证据之前，本页属于自我评估，并明确列出了我们已知的不足。

工具栏只占一个 Tab 停留点，遵循 ARIA 创作实践中的工具栏模式：按一次 Tab 进入工具栏，然后用 ← / → 在按钮之间移动，用 Home / End 跳到两端。焦点会回到您上次使用的按钮。在 RTL 中，方向键的方向遵循文档的阅读方向。
没有键盘陷阱（2.1.2）。在内容中，Tab 保留其编辑含义——缩进列表、移到下一个表格单元格——因此退出方式是另一个有文档说明的按键：Esc 离开编辑区域并把焦点放到工具栏上，之后 Tab 会像平常一样继续在页面中移动。这一退出方式会作为编辑区域可访问名称的一部分被读出，因此屏幕阅读器在进入时就会读到它，而不必让用户去猜。如果有菜单或对话框打开，Esc 会先关闭它们。
所有工具栏命令都有键盘快捷键。
对话框会捕获焦点；Esc 关闭对话框并把焦点返回到触发它的控件。
表格支持用 Tab 在单元格之间导航，并用 Shift+Tab 反向导航。
斜杠命令、@提及和 AI 对话框完全可以用键盘操作——不需要鼠标。

工具栏按钮通过 aria-label 提供可访问名称。切换类命令——粗体、斜体、下划线、对齐、列表、修订跟踪和视图模式——提供 aria-pressed，其值与编辑器自身的活动状态同步，因此读出的值永远不会与高亮的按钮不一致。菜单按钮提供 aria-haspopup，并在菜单打开和关闭时保持 aria-expanded 准确。
对话框提供 role="dialog"，并带有为对话框命名的 aria-label；焦点保持在对话框内，按 Esc 会关闭对话框并把焦点返回到原来的位置。在 2.6.12 中，有两个面板没有被标记为模态：从工具栏打开的 Insert Link 面板没有 aria-modal，而 Find and Replace 设置的是 aria-modal="false"。请开启对话框无障碍插件，让 Insert Link 面板获得 role="dialog"，并为其中的字段提供名称。
AI Review 抽屉提供带有实时标签的 region 角色；新建议通过 aria-live="polite" 读出。
批注和修订建议提供按作者区分的标签，因此屏幕阅读器会读出 "Comment by Maya Patel"（Maya Patel 的批注）。
编辑器内容中的标题保留 h1–h6 语义；列表保留 ul/ol/li。

图片可以通过 Image 对话框添加替代文本；从 Word、Excel 和 Google Docs 粘贴时会保留 alt。
链接保留可读的文字——不会自动生成“点击这里”。
导出的 HTML 和 DOCX 保留标题级别和列表结构；下游的屏幕阅读器看到的结构与编辑器中一致。
PDF 导出带有标签。可选中的文本并不等于无障碍文档——未加标签的 PDF 只会给辅助技术一串平铺的文字，没有标题、列表语义、表格关系，也无法保证阅读顺序。矢量导出器会写入完整的结构树（H1–H6、P、L/LI、带列范围的 Table/TH/TD、带 /Alt 的 Figure），并把分隔线、边框和页眉页脚标记为伪影，使它们不进入阅读顺序。请参阅为什么可搜索的 PDF 和无障碍的 PDF 是两种不同的功能，以及如何手工编写 PDF，让文本始终保持为文本。

我们相信，信任建立在诚实之上，而不是一份听起来完美的声明。以下是我们已知尚未达到目标的方面，以及我们针对每一项正在做的工作：

第三方审核报告尚未发布。本声明仅反映自我评估。需要正式 VPAT 的企业采购团队，应把它视为一项尚未满足的要求，并联系我们获取当前的无障碍证据材料包。
表格表头只会被标记，不会被推断。编辑器不会猜测第一行就是表头行——猜错会把数据重新标记为标题，这比不做处理还糟。它的做法是标记表格：无障碍检查器会对任何没有表头单元格的表格提出 table-missing-header，并提供一键修复，把第一行提升为 <th scope="col">，同时保留单元格内容和属性。这个 scope 会一直带到带标签的 PDF（带列范围的 TH）和 .docx（重复的 tblHeader 行）中，因此一次修复就能在所有导出格式中纠正该表格。剩下的不足是：随手创建的表格在有人运行检查器之前，一直是不可访问的。
图片编辑器（tui.image-editor）是第三方依赖；它的工具面板无法完全用键盘操作。我们提供了一个普通的 Upload 备选方式，用户可以跳过图片编辑器，仍然插入带替代文本的图片。
移动端工具栏是响应式的，但没有针对 VoiceOver / TalkBack 的转子导航进行优化。这项工作与专门的移动端工具栏模式一起列在 2026 年的路线图中。

每次发布之前，我们都会针对以下组合进行测试。任一组合中出现问题都会阻止发布。

最终用户指南中有完整的快捷键参考。要点如下：

如果您使用辅助技术时遇到无法正常工作的地方，我们希望了解。请提供：

请发送电子邮件至 accessibility@richtexteditor.com——我们承诺在两个工作日内首次回复。

版本历史。本声明于 2026 年 4 月首次发布，每个季度随发布周期进行审查；重大变更会在产品发布说明中注明。