辅助功能支持
CKEditor 5 结合了各种辅助功能,包括键盘导航、屏幕阅读器支持(ARIA属性)和强大的语义输出标记。本指南提供了详细的概述,并介绍了编辑器辅助功能的当前状态。
# 符合 WCAG 2.x 和第 508 条款
CKEditor 5 符合 Web 内容无障碍指南 2.2(WCAG) 2.2 A 级和 AA 级以及 《康复法》第 508 条款,除非在 辅助功能符合性报告 中另有说明。
- Web 内容无障碍指南 2.2 (WCAG) 为残疾人提供 Web 内容无障碍的国际标准,确保 Web 应用程序对所有用户而言都是可感知的、可操作的、可理解的和健壮的。
- 《康复法》第 508 条款 规定联邦机构的电子和信息技术必须对残疾人无障碍,为此制定了准则来实现这一目标。
CKEditor 5 努力符合这些标准,我们欢迎您提供有关我们软件辅助功能的 反馈。
# 推荐软件
为了获得最佳的屏幕阅读器体验,我们建议使用 Google Chrome 和NVDA(Windows)或 Safari 和 VoiceOver(macOS)。
# 辅助功能符合性报告 (VPAT)
在我们持续致力于无障碍的承诺下,我们根据 ITI 自愿产品无障碍模板 (VPAT®) 提供一份报告,这是一种评估计算机软件无障碍的标准化格式。这份文档是全面了解 CKEditor 5 辅助功能特征的资源,包括符合无障碍标准和指南:Web 内容无障碍指南 2.2(WCAG) 2.2 A 级和 AA 级以及 《康复法》第 508 条款。
我们不断更新VPAT® 报告以反映任何更改或改进。您可以下载最新版本的VPAT® 文档如下。
# 键盘快捷键
CKEditor 5 支持各种键盘快捷键,可以提高工作效率并为屏幕阅读器用户提供必要的辅助功能。
默认情况下,所有编辑器类型和核心 编辑器功能 均启用了键盘支持。
以下列出了 CKEditor 5 及其功能支持的最重要的键击。
# 内容编辑键击
这些键盘快捷键可快速访问内容编辑功能。
操作 | PC | Mac |
---|---|---|
插入硬换行符(新段落) | Enter | |
插入软换行符(<br> 元素) |
Shift+Enter | ⇧Enter |
复制选定内容 | Ctrl+C | ⌘C |
粘贴内容 | Ctrl+V | ⌘V |
粘贴内容为纯文本 | Ctrl+Shift+V | ⌘⇧V |
撤销 | Ctrl+Z | ⌘Z |
重做 | Ctrl+Y, Ctrl+Shift+Z | ⌘Y, ⌘⇧Z |
加粗文本 | Ctrl+B | ⌘B |
更改文本大小写 | Shift+F3 | ⇧F3(可能需要 Fn) |
创建链接 | Ctrl+K | ⌘K |
移出链接 | ←←, →→ | |
移出内联代码样式 | ←←, →→ | |
全选 | Ctrl+A | ⌘A |
在文档中查找 | Ctrl+F | ⌘F |
复制文本格式 | Ctrl+Shift+C | ⌘⇧C |
粘贴文本格式 | Ctrl+Shift+V | ⌘⇧V |
斜体文本 | Ctrl+I | ⌘I |
删除线文本 | Ctrl+Shift+X | ⌘⇧X |
下划线文本 | Ctrl+U | ⌘U |
撤消自动格式化操作 | Backspace |
# 与注释线程交互的键击(例如,评论、跟踪更改建议)
操作 | PC | Mac |
---|---|---|
当选择锚定在其标记中时,将焦点移到线程 | Ctrl+Shift+E | ⌘⇧E |
退出标注并使焦点回到编辑内容 | Esc | |
浏览聚焦的标注线程或线程评论 | Enter | |
在标注线程内部移动 | ⇥, Shift+⇥ | ⇥, ⇧⇥ |
在写评论时提交回复 | Ctrl+Enter | ⌘Enter |
移动到标注侧边栏或评论存档中的上一个或下一个线程 | ↑, ↓ |
# 当小部件(如图片、表格等)被选中时可以使用哪些按键
操作 | PC | Mac |
---|---|---|
在小部件后插入一个新段落 | Enter | |
在小部件前插入一个新段落 | Shift+Enter | ⇧Enter |
移动光标,允许直接在小部件前键入 | ↑, ← | |
移动光标,允许直接在小部件后键入 | ↓, → | |
在进入嵌套的可编辑区域后,将选择移动到最接近的祖先小部件。例如:从图片说明移动到整个图片小部件。 | Tab 然后 Esc |
# 在列表中可以使用哪些按键
操作 | PC | Mac |
---|---|---|
增加列表项缩进 | ⇥ | |
减少列表项缩进 | Shift+⇥ | ⇧⇥ |
# 用于在文档中导航的按键
操作 | PC | Mac |
---|---|---|
转到上一页(也移动选择) | Shift+Page Up | ⇧Page Up (可能需要 Fn) |
转到下一页(也移动选择) | Shift+Page Down | ⇧Page Down (可能需要 Fn) |
# 在表格单元格中可以使用哪些按键
操作 | PC | Mac |
---|---|---|
将选择移动到下一个单元格 | ⇥ | |
将选择移动到上一个单元格 | Shift+⇥ | ⇧⇥ |
插入一个新的表格行(当位于表格的最后一个单元格时) | ⇥ | |
在表格中导航 | ↑, →, ↓, ← |
# 用户界面和内容导航快捷键
使用以下快捷键,在 CKEditor 5 用户界面中进行更有效的导航。
操作 | PC | Mac |
---|---|---|
关闭上下文气泡、下拉菜单和对话框 | Esc | |
打开无障碍帮助对话框 | Alt+0 | ⌥0 |
在表单字段(输入框、按钮等)之间移动焦点 | ⇥, Shift+⇥ | ⇥, ⇧⇥ |
将焦点移动到工具栏,在工具栏之间导航 | Alt+F10 | ⌥F10 (可能需要 Fn) |
在工具栏或菜单栏中导航 | ↑, →, ↓, ← | |
导航到下一个可聚焦的字段或编辑器外的元素 | Tab, Shift+Tab | |
执行当前聚焦的按钮。执行与编辑器内容交互的按钮会将焦点移回内容。 | Enter, Space | |
将焦点移动到菜单栏,在菜单栏之间导航 | Alt+F9 | ⌥F9 (可能需要 Fn) |
在活动对话框窗口中移动焦点 | Ctrl+F6 | ⌘F6 (可能需要 Fn) |
# 在编辑器中显示键盘快捷键
CKEditor 5 提供了一个专门的 无障碍帮助 插件,可在对话框中显示所有可用键盘快捷键的列表。可以通过按下 Alt + 0 (在 Windows 上) 或 ⌥0 (在 macOS 上) 来打开它。或者,也可以使用工具栏按钮打开对话框。
在编辑时按下 Alt+0 (⌥0 在 Mac 上) 以显示可用键盘快捷键的列表。
无障碍帮助插件由 Essentials 插件启用,该插件来自 @ckeditor/ckeditor5-essentials 包(它还启用了其他常见的编辑功能)。
了解集成者如何 为其功能添加键盘快捷键 以及 为无障碍帮助对话框提供快捷键信息。
# 无障碍反馈和错误
我们欢迎您对 CKEditor 5 的无障碍性提供反馈。您可以在 GitHub 上找到 当前的无障碍性问题列表。了解如何 报告问题。
我们每天都在努力使我们的文档保持完整。您是否发现了过时的信息?是否缺少某些内容?请通过我们的 问题跟踪器 报告。
随着 42.0.0 版本的发布,我们重新编写了大部分文档以反映新的导入路径和功能。感谢您的反馈,帮助我们确保其准确性和完整性。