无障碍功能
Visual Studio Code 具有许多功能,可以帮助所有用户访问编辑器。 缩放级别和高对比度颜色可以提高编辑器的可见性,仅键盘导航支持在没有鼠标的情况下使用,编辑器经过优化以适应屏幕阅读器。
缩放
您可以使用 **视图** > **外观** > **缩放** 命令调整 VS Code 中的缩放级别。 每个 **缩放** 命令将缩放级别增加或减少 20%。
- **视图** > **外观** > **放大** (⌘= (Windows、Linux Ctrl+=)) - 增加缩放级别。
- **视图** > **外观** > **缩小** (⌘- (Windows、Linux Ctrl+-)) - 减少缩放级别。
- **视图** > **外观** > **重置缩放** (⌘Numpad0 (Windows、Linux Ctrl+Numpad0)) - 将缩放级别重置为 0。
**注意**:如果您使用放大镜,请在查看悬停时按住 Alt 键,将光标移动到悬停处。
持久化的缩放级别
当您使用 **视图** > **外观** > **放大/缩小** 命令调整缩放级别时,缩放级别将保存在 window.zoomLevel 设置 中。 默认值为 0,每次增量/减量都会将缩放级别更改 20%。
无障碍功能帮助
命令 **打开无障碍功能帮助** ⌥F1 (Windows Alt+F1、Linux Shift+Alt+F1) 将根据当前上下文打开一个帮助菜单。 它目前适用于编辑器、终端、笔记本、聊天视图和内联聊天功能。
您可以关闭无障碍功能帮助菜单,或从帮助菜单中打开其他文档。
高对比度主题
VS Code 支持所有平台上的高对比度颜色主题。 使用 文件 > 首选项 > 主题 > 颜色主题 (⌘K ⌘T (Windows、Linux Ctrl+K Ctrl+T)) 显示 **选择颜色主题** 下拉列表,并选择 **高对比度** 主题。
色觉障碍无障碍功能
您可以在 **Visual Studio Marketplace** 中搜索与色觉障碍兼容的扩展。 使用扩展视图 ⇧⌘X (Windows、Linux Ctrl+Shift+X) 并搜索 “色盲” 以填充相关选项。
安装完来自 Marketplace 的颜色主题后,您可以使用 文件 > 首选项 > 主题 > 颜色主题 ⌘K ⌘T (Windows、Linux Ctrl+K Ctrl+T) 更改 颜色主题。
推荐用于色觉障碍无障碍功能的主题
- GitHub - 适用于大多数色盲形式,并与 GitHub 设置中的主题相匹配。
- Gotthard - 针对大约 20 种编程语言进行了优化。
- Blinds - 为患有红绿色盲的人创建,具有高对比度颜色比率。
- Greative - 同时考虑了色觉障碍和光敏感。
- Pitaya Smoothie - 适用于大多数色盲形式,并符合 WCAG 2.1 颜色对比度标准。
自定义警告颜色
VS Code 的默认颜色主题是 **Dark+**。 但是,您可以自定义用户界面中的主题和属性颜色。
**注意**:请转到 自定义颜色主题,了解有关覆盖当前主题中的颜色的更多信息。
要自定义错误和警告波浪线,请转到 文件 > 首选项 > 设置 以查看用户设置。 搜索 “颜色自定义” 以查找 **工作区:颜色自定义** 设置,然后通过选择 **在 settings.json 中编辑** 打开您的用户 settings.json
文件。
在你的 settings.json
文件中,在最外层的括号内嵌套以下代码。你可以通过输入十六进制代码为每个对象分配颜色。
"workbench.colorCustomizations": {
"editorError.foreground": "#ffef0f",
"editorWarning.foreground": "#3777ff"
}
在以下示例中,当 JSON 项目后缺少逗号时,将应用警告颜色。
editorError.foreground
- 覆盖错误下方波浪线。editorWarning.foreground
- 覆盖警告下方波浪线。editorError.background
- 覆盖错误的突出显示颜色。editorWarning.background
- 覆盖警告的突出显示颜色。
为 editorError
和 editorWarning
的背景分配颜色也有助于识别潜在的问题。你选择的颜色将突出显示相应的错误或警告。前面示例中显示的颜色,#ffef0f
(黄色) 和 #37777ff
(蓝色),对患有常见色觉障碍的人来说更易于识别。
选择无障碍颜色
颜色的无障碍性取决于异常三色视觉 (色盲) 的类型。严重程度因人而异,可分为四种类型。
情况 | 类型 |
---|---|
绿弱 | 对绿光的敏感度降低。它是最常见的色盲类型。 |
红弱 | 对红光的敏感度降低。 |
蓝弱 | 对蓝光的敏感度降低。这种情况非常罕见。 |
单色视觉 | 无法看到所有颜色,也称为全色盲。关于最罕见的色盲类型的更多信息:对抗失明基金会. |
选择特定情况下的最佳颜色的最佳方法之一是使用互补色。这些颜色位于色轮上的相对位置。
注意:有关查找互补色的更多信息,请访问 Adobe Color 上的色盲模拟器和交互式色轮。
使未聚焦的编辑器和终端变暗
可以将未聚焦视图调暗,以便更清楚地显示输入的类型。当使用多个编辑器组或终端时,这尤其有用。通过设置 "accessibility.dimUnfocused.enabled": true
来启用此功能。你可以使用 accessibility.dimUnfocused.opacity 控制暗淡程度,该设置从 0.2 到 1 (默认 0.75) 获取不透明度分数。
键盘导航
VS Code 在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中提供了详尽的命令列表,以便你无需鼠标即可使用 VS Code。按下 ⇧⌘P (Windows, Linux Ctrl+Shift+P),然后键入命令名称 (例如“git”) 以筛选命令列表。
VS Code 还为命令提供了许多预设键盘快捷键。
你也可以设置自己的键盘快捷键。 文件 > 首选项 > 键盘快捷键 (⌘K ⌘S (Windows, Linux Ctrl+K Ctrl+S)) 打开键盘快捷键编辑器,你可以在其中发现和修改 VS Code 操作的键绑定。有关自定义或添加自己的键盘快捷键的更多详细信息,请参阅 键绑定。
为了更方便地在工作台中进行导航,我们建议使用聚焦下一个部分 (F6) 和聚焦上一个部分 (⇧F6 (Windows, Linux Shift+F6)) 命令。
锚定选择
为了更方便地使用键盘开始和结束选择,有四个命令:设置选择锚点 (⌘K ⌘B (Windows, Linux Ctrl+K Ctrl+B))、从锚点选择到光标 (⌘K ⌘K (Windows, Linux Ctrl+K Ctrl+K))、取消选择锚点 (Escape) 和转到选择锚点。
制表符导航
你可以在 VS Code 中使用 Tab 键在 UI 控件之间导航。使用 Shift+Tab 以反向顺序进行制表。当你使用 Tab 键遍历 UI 控件时,每个 UI 元素获得焦点时,其周围会出现一个指示器。
工作台中的所有元素都支持 Tab 键导航。为了避免出现过多的 Tab 键停靠点,工作台工具栏和选项卡列表每个只有一个。工具栏或选项卡列表获得焦点后,可以使用箭头键在其中导航。
注意:Tab 键导航以视觉上的自然顺序进行,Web 视图 (如 Markdown 预览) 除外。对于 Web 视图,我们建议使用 F6 和 ⇧F6 (Windows, Linux Shift+F6) 命令在 Web 视图和工作台的其余部分之间导航。或者,你可以使用许多 Focus Editor 命令。
制表符捕获
默认情况下,在源代码文件中按下 Tab 键会插入 Tab 字符 (或根据你的缩进设置插入空格),并且不会离开打开的文件。你可以使用 ⌃⇧M (Windows, Linux Ctrl+M) 切换 Tab 键捕获,后续的 Tab 键会将焦点移出文件。当默认的 Tab 键捕获关闭时,你会在状态栏中看到Tab 键移动焦点指示器。
Tab 键捕获也存在于集成终端中。可以使用 editor.tabFocusMode 配置该功能的默认行为。
你也可以使用命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中的切换 Tab 键移动焦点操作,在打开和关闭 Tab 键捕获之间切换。
只读文件永远不会捕获 Tab 键。集成终端 面板会尊重 Tab 键捕获模式,可以使用 ⌃⇧M (Windows, Linux Ctrl+M) 进行切换。
屏幕阅读器
VS Code 使用基于文本分页的策略,在编辑器中支持屏幕阅读器。以下屏幕阅读器已通过测试
对于 NVDA,我们建议你保持在焦点模式,并使用热键进行导航,而不是使用浏览模式。
转到下一个/上一个错误或警告 操作 (F8 和 ⇧F8 (Windows, Linux Shift+F8)) 允许屏幕阅读器宣布错误和警告消息。
当建议弹出时,会向屏幕阅读器宣布它们。使用 Ctrl+Up 和 Ctrl+Down 导航建议,使用 Shift+Escape 撤消它们。如果建议妨碍了你,可以使用 editor.quickSuggestions 设置关闭它们。
在 diff 视图窗格中,转到下一个/上一个差异 操作 (F7 和 ⇧F7 (Windows, Linux Shift+F7)) 会显示无障碍 Diff 视图,其中差异以统一补丁格式呈现。使用 Up 和 Down 导航未更改、插入或删除的行。按下 Enter 键将焦点返回到 diff 编辑器中所选行号的已修改窗格 (或如果选择了已删除的行,则返回到仍然存在的最近行号)。使用 Escape 或 Shift+Escape 撤消无障碍 Diff 视图。
屏幕阅读器模式
当 VS Code 检测到正在使用屏幕阅读器时,它会进入针对 UI (如编辑器和集成终端) 的优化屏幕阅读器模式。状态栏将在右下方显示屏幕阅读器优化。你可以通过单击显示文本或使用切换屏幕阅读器无障碍模式命令退出屏幕阅读器模式。
在屏幕阅读器模式下,某些功能 (如折叠和迷你地图 (代码概述)) 会被禁用。你可以使用编辑器:无障碍支持设置 (editor.accessibilitySupport) 和值 (on
、off
或默认的 auto
,该值会通过查询平台自动检测屏幕阅读器) 来控制 VS Code 是否使用屏幕阅读器模式。
通过键盘调整表格列大小
list.resizeColumn
命令使你能够使用键盘调整列的大小。你可以分配键盘快捷键来触发此命令。
触发此命令后,选择要调整大小的列,并提供要设置的宽度百分比。以下视频演示了如何将此应用于调整键盘快捷键编辑器中列的大小。
无障碍视图
运行打开无障碍视图命令 ⌥F2 (Windows Alt+F2,Linux Shift+Alt+F2) 以显示无障碍视图,并逐字符、逐行地检查内容。无障碍视图目前可用于悬停、通知、注释、笔记本输出、终端输出、聊天回复、内联完成、调试控制台输出等等。
输入控件和结果导航
在扩展视图、键盘快捷键编辑器以及注释、问题和调试控制台面板中,在输入控件(例如搜索或筛选输入)与其结果之间导航是一致的,使用 (⌘↓ (Windows, Linux Ctrl+Down)) 和 (⌘↑ (Windows, Linux Ctrl+Up)).
终端无障碍功能
您可以通过 ⌥F1 (Windows Alt+F1, Linux Shift+Alt+F1) 显示终端辅助功能帮助,其中描述了使用屏幕阅读器时的有用技巧。一个技巧是使用 ⌥F2 (Windows Alt+F2, Linux Shift+Alt+F2) 访问终端中的缓冲区。这将自动进入屏幕阅读器的浏览模式,具体取决于您的屏幕阅读器,以提供整个终端缓冲区的可访问视图。
使用 editor.tabFocusMode 控制终端是否接收 Tab 键而不是工作台,类似于编辑器。
Shell 集成
终端有一个名为 shell 集成 的功能,它可以启用许多其他终端中没有的功能。在使用屏幕阅读器时,运行最近的命令 和 转到最近的目录 功能特别有用。
另一个 shell 集成驱动的命令,在可访问视图中转到符号 (⇧⌘O (Windows, Linux Ctrl+Shift+O)),可以让您在终端命令之间导航,类似于编辑器中的在编辑器中转到符号... 导航。
最小对比度比
设置 terminal.integrated.minimumContrastRatio 为 1 到 21 之间的数字,以调整文本颜色亮度,直到达到所需的对比度比或纯白色 (#FFFFFF
) 黑色 (#000000
) 为止。
请注意,terminal.integrated.minimumContrastRatio 设置将不适用于 powerline
字符。
状态栏无障碍功能
一旦焦点通过 聚焦下一个部分 (F6) 进入状态栏,您可以使用箭头导航在状态栏条目之间移动焦点。
差异编辑器辅助功能
差异编辑器中有一个可访问的差异查看器,它以统一的补丁格式显示更改。您可以使用 转到下一个差异 (F7) 和 转到上一个差异 (⇧F7 (Windows, Linux Shift+F7)) 在更改之间导航。使用箭头键导航行,然后按 Enter 跳回差异编辑器和选定行。
调试器无障碍功能
VS Code 调试器 UI 可供用户访问,并具有以下功能
- 调试状态更改将被读出(例如,“已启动”、“命中断点”、“已终止”等等)。
- 所有调试操作都可通过键盘访问。
- 运行和调试视图以及调试控制台都支持 Tab 导航。
- 调试悬停可通过键盘访问 (⌘K ⌘I (Windows, Linux Ctrl+K Ctrl+I)).
- 可以创建键盘快捷键将焦点设置到每个调试器区域。
- 在调试期间,并且焦点在编辑器中,调用 调试:添加到监视 命令会宣布变量的值。
无障碍功能信号
辅助功能信号指示当前行是否具有某些标记,例如:错误、警告、断点、折叠的文本区域或内联建议。
当主光标更改其行或第一次将标记添加到当前行时,它们将播放。当附加屏幕阅读器时,辅助功能信号声音和公告可能会自动启用,并且可以通过设置 accessibility.signals.*
进行控制。
命令 帮助:列出信号声音 列出所有可用声音,让您在浏览列表时听到每个声音,并允许配置其启用/禁用状态。
Aria 公告还会告知屏幕阅读器和盲文用户某些标记已被命中。命令 帮助:列出信号公告 会通知用户哪些可用,并允许配置其启用/禁用状态。
悬停无障碍功能
某些悬停不能正常悬停,这使得它们难以使用屏幕放大镜。要解决此问题,请在悬停处于活动状态时按住 Alt 或 Option 键以将其“锁定”在适当位置,这样在悬停时它就不会隐藏。释放键以解锁悬停。
当前已知问题
VS Code 存在一些已知的辅助功能问题,具体取决于平台。有关完整列表,请访问 VS Code 辅助功能问题。
macOS
编辑器包含对 VoiceOver 的屏幕阅读器支持。
Linux
VS Code 与 Orca 屏幕阅读器配合良好。如果您的 Linux 发行版中的 Orca 无法读取编辑器内容
- 请确保在 VS Code 中设置
"editor.accessibilitySupport": "on"
。您可以使用设置或运行 显示辅助功能帮助 命令并按 Ctrl+E 来打开 accessibilitySupport。 - 如果 Orca 仍然静音,请尝试将
ACCESSIBILITY_ENABLED=1
设置为环境变量。
启用该设置后,VS Code 应该可以与 Orca 屏幕阅读器配合使用。
后续步骤
继续阅读以了解
- 语音交互 - 了解如何在 VS Code 中使用语音命令。
- Visual Studio Code 用户界面 - VS Code 的快速入门指南。
- 基本编辑 - 了解强大的 VS Code 编辑器。
- 代码导航 - 在源代码中快速移动。