Contribute to this guide

指南辅助功能支持

CKEditor 5 结合了各种辅助功能,包括键盘导航、屏幕阅读器支持(ARIA属性)和强大的语义输出标记。本指南提供了详细的概述,并介绍了编辑器辅助功能的当前状态。

# 符合 WCAG 2.x 和第 508 条款

CKEditor 5 符合 Web 内容无障碍指南 2.2WCAG) 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.2WCAG) 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 上找到 当前的无障碍性问题列表。了解如何 报告问题