在 MATLAB Online 中使用屏幕阅读器

在 MATLAB^® Online™ 中，您可以使用屏幕阅读器和键盘与命令行窗口交互，在编辑器和实时编辑器中创建和编辑脚本与函数，浏览绘图数据以及浏览 MATLAB 桌面工具。MATLAB Online 经过测试，支持在运行 MATLAB Online 的 Windows^® 10 上的 Google Chrome^® 浏览器中使用 NVDA 屏幕阅读器。有关 NVDA 的详细信息，请参阅 NV Access 网站的 Get Help 部分。

要开始使用 MATLAB Online，请转至 https://matlab.mathworks.com/ 并点击打开 MATLAB Online 按钮。

屏幕阅读器技巧

减少输出中的空行

要改进在命令行窗口中工作时的屏幕阅读器体验，请使用 format 命令隐藏当前会话输出中多余的空行。

format compact;

要在以后的所有会话中保持紧凑格式，请使用设置来设定个人的输出显示行距值。

s = settings;
s.matlab.commandwindow.DisplayLineSpacing.PersonalValue = "compact";

修改图形对象

使用图形对象时，以编程方式或使用属性检查器查看和修改属性。例如，plot 函数返回图形线条对象。您可以使用圆点表示法查看和设置属性。

p = plot(1:10,1:10);
p.LineWidth = 3;

您也可以在创建对象时使用名称-值参量设置属性，例如 plot(1:10,1:10,"LineWidth",3)。

有关查看和修改图形对象属性的详细信息，请参阅修改图形对象。

访问 MathWorks 文档

为了在使用屏幕阅读器查看和搜索文档时获得最佳体验，请访问 https://www.mathworks.com/help/ 并在单独的浏览器标签页或窗口中打开文档。

使用以 `-nodesktop` 选项启动的 MATLAB

如果您使用 -nodesktop 启动选项在没有桌面的情况下运行 MATLAB，这些提示有助于改进您的屏幕阅读器体验：

使用 format 函数隐藏输出中多余的空行，使导航 diary 文件更容易。有关详细信息，请参阅减少输出中的空行。
当调用 diary 函数以将命令行窗口文本保存到单独的文件时，请包含文件名。在 MATLAB 会话期间，您可以使用不同文件名多次调用 diary 函数以将不同文本集保存到不同文件中。

将 MATLAB 与 -nodesktop 选项结合使用的一种更易访问的替代方法是改用 MATLAB Online 中的“仅命令行窗口”布局。使用 MATLAB Online 中的“仅命令行窗口”布局，您可以访问更多键盘快捷方式，并使用 MATLAB 桌面的全部功能。要在 MATLAB Online 中选择“仅命令行窗口”布局，请转至主页选项卡，在环境部分中，点击布局按钮，然后选择仅命令行窗口。

使用屏幕阅读器导航 MATLAB

当您第一次启动 MATLAB Online 时，光标位于命令行窗口中。

要向前移动至 MATLAB Online 桌面的不同区域，请按 Ctrl+F6（或在 macOS 系统上按 Command+F6）。要向后移动，请按 Ctrl+Shift+F6（或在 macOS 系统上按 Command+Shift+F6）。您也可以使用键盘快捷方式直接导航到一些打开的工具。

下表描述 MATLAB Online 桌面的不同区域及其默认位置。

区域	位置	描述
工具条	桌面顶部	默认情况下，工具条包括三个选项卡：主页、绘图和 App。要在工具条选项卡之间导航，请使用箭头键。要进入工具条选项卡和在其中导航，请使用 Tab 键。
当前文件夹工具栏	桌面顶部，工具条下方	查看和更改当前文件夹。
文件面板	桌面左侧	管理 MATLAB 中的文件和文件夹。操作包括查看、创建、打开、移动和重命名当前文件夹下的文件和文件夹。
工作区面板	桌面左侧，文件面板下方	查看和管理 MATLAB 中工作区的内容。
命令行窗口	桌面中下部	在命令行中输入单个语句并查看生成的输出。
编辑器和实时编辑器	桌面中间，命令行窗口上方	编辑或创建文件。
停靠的图窗	桌面中间，命令行窗口上方	在嵌入式图窗中绘制数据。

例如，您可以使用工具条发送关于当前版本的反馈：

在运行 NVDA 屏幕阅读器的 Windows 系统上，打开 Google Chrome 浏览器并启动 MATLAB Online。
将光标放在命令行窗口中，按 Ctrl+F6 导航到工具条。您会听到：
```
Toolstrip region 
Toolstrip tab control 
Home tab selected one of three
```
按 Tab 键进入 Home 选项卡，然后继续按 Tab 键，直到到达 Feedback 按钮。您会听到：
```
Feedback button
Send us feedback or report a bug
```
按 Enter。“发送反馈”对话框将打开。
按 Esc 键两次以关闭对话框而不发送反馈。

有关 MATLAB 桌面的详细信息，请参阅Change Desktop Layout。

使用屏幕阅读器在命令行窗口中输入语句

在 MATLAB 中工作时，您可以使用屏幕阅读器和键盘在命令行窗口中输入语句。

例如：

在运行 NVDA 屏幕阅读器的 Windows 系统上，打开 Google Chrome 浏览器并启动 MATLAB Online。
将光标放在命令行窗口中，通过在命令行窗口中输入以下语句来创建名为 x 的变量。
```
x = 1
```
MATLAB 将 x 添加到工作区并在命令行窗口中显示结果。您会听到：
```
x equals one
Ready prompt
One variable added to workspace
```
当您听到就绪提示符时，命令行窗口已准备就绪，可以开始在命令提示符下执行下一条语句 (>>)。

通过在命令行窗口中输入以下语句创建另一个变量 y。

y = cos(x)

您会听到：

y equals zero point five four zero three
Ready prompt
One variable added to workspace

通过在命令行窗口中输入以下语句，将 x 的值设置为 y 的值。
```
x = y
```
您会听到：
```
x equals zero point five four zero three
Ready prompt
```
通过按 Shift+Tab 将光标移至命令行窗口滚动缓冲区，再次收听最后一次输出。您会听到：
```
Scroll buffer region
x equals zero point five four zero three
```
通过按 Shift+Tab 将光标移回命令提示符。您会听到：
```
Ready prompt
```
通过在命令行窗口中输入以下语句，将当前工作区中的变量保存在文件 test.mat 中。
```
save test.mat
```
MATLAB 将文件保存在当前文件夹中。您会听到：
```
Ready prompt
```
通过在命令行窗口中输入以下语句，从工作区中删除变量。
```
clear
```
您会听到：
```
All variables removed from workspace
Ready prompt
```
通过在命令行窗口中输入以下语句，清除命令行窗口中的所有文本。
```
clc
```
您会听到：
```
Ready prompt
```
命令行窗口已准备好执行下一条语句。

有关在命令行窗口中输入语句的详细信息，请参阅在命令行窗口中输入语句。

使用屏幕阅读器创建脚本

脚本是最简单的程序文件类型，因为它们没有输入或输出参量。它们可用于自动执行一系列 MATLAB 命令，例如您要从命令行重复执行的计算或要引用的一系列命令。

例如，创建、运行和编辑脚本 myrandom.m：

在运行 NVDA 屏幕阅读器的 Windows 系统上，打开 Google Chrome 浏览器并启动 MATLAB Online。

通过按 Ctrl+F6 导航到工具条，直到您听到：

Toolstrip region
Toolstrip tab control
Home tab selected one of three

按 Tab 键进入 Home 选项卡。New Script 按钮处于选中状态。您会听到：

Home property page
File grouping
New script button 
Create a new script in the current folder

按 Enter 键创建一个新脚本。MATLAB 会创建脚本文件并在编辑器中打开它。您会听到：
```
Untitled property page
Edit multiline
Line one
```
添加以下用于生成一个随机数数组的代码，然后计算该数组的大小和均值。
```
n = 50;
r = rand(n,1);
sz = size(r)
m = mean(r)
```
按 Ctrl+S 键保存文件。MATLAB 将打开“另存为”对话框。您会听到：
```
Save as dialog
```
您也可以使用工具条上的保存按钮打开“另存为”对话框。
输入脚本的名称。例如，输入名称 myrandom.m。按 Enter 键保存文件。
要运行该脚本，请确保焦点在脚本内，然后按 F5 键。如果焦点不在脚本内，按 F5 键会在浏览器中重新加载 MATLAB Online。
MATLAB 运行脚本并在命令行窗口中显示输出。您会听到：
```
Four variables added to workspace
sz equals fifty one
m equals zero point four eight nine nine
Ready prompt
```
您也可以使用工具条上的运行按钮来运行脚本。
使用箭头键浏览脚本中的行并编辑代码。例如，通过按向上箭头键转至代码中的第 1 行，直到您听到：
```
Line one n equals fifty
```
按向右箭头键转至第 1 行的末尾，直到您听到：
```
Line feed
```
删除分号 (;)，并按 Ctrl+S 键保存您的更改。

按 F5 键运行编辑好的脚本。您会听到：

n equals fifty
sz equals fifty one
m equals zero point four five zero four
Ready prompt

有关创建脚本的详细信息，请参阅创建脚本。

使用屏幕阅读器创建实时脚本

实时脚本和实时函数是用于与一系列 MATLAB 命令进行交互的程序文件。实时脚本包含输出和图形以及生成这些输出和图形的代码，它们共同显示在一个称为实时编辑器的交互式环境中。

例如，创建并运行计算球体面积和体积的实时脚本：

在运行 NVDA 屏幕阅读器的 Windows 系统上，打开 Google Chrome 浏览器并启动 MATLAB Online。

通过按 Ctrl+F6 导航到工具条，直到您听到：

Toolstrip region
Toolstrip tab control
Home tab selected one of three

按两次 Tab 键进入主页选项卡，然后选择新建实时脚本按钮。您会听到：
```
New live script button 
Create a new live script in the current folder
```
按 Enter 键创建新实时脚本。MATLAB 创建实时脚本文件并在实时编辑器中打开它。您会听到：
```
Untitled.mlx property page
Edit multiline
Code line one
```
添加以下代码，创建一个半径为 1 的球体，然后计算球体的表面积和体积。
```
[x,y,z] = sphere; 
r = 1;
A = 4*pi*r^2
V = (4/3)*pi*r^3
```
要运行该实时脚本，请确保焦点在脚本内，然后按 F5 键。如果焦点不在脚本内，按 F5 键会在浏览器中重新加载 MATLAB Online。
默认情况下，MATLAB 运行实时脚本并在代码右侧显示输出。您会听到：
```
Six variables added to workspace
Ready prompt
```
您也可以使用工具条上的运行按钮来运行实时脚本。
通过按 Ctrl+Shift+O 将焦点移至输出。您会听到：
```
Variable output 
V equals four point one eight eight eight
```
按向上箭头键移至上一个输出。您会听到：
```
Variable output 
A equals twelve point five six six four
```

通过按 Ctrl+Shift+O 将焦点移回代码。您会听到：

Edit multiline
Code line three has output
A equals four star pi star r two

按向上箭头键转至文档顶部，直到您听到：
```
Code line one
x y z equals sphere
```
按 Alt+Enter 键在第一行代码上方插入一行文本。
将此文本添加到此行：
```
Calculate Volume and Area of Sphere
```
按 Ctrl+Alt+L 键，使文本行成为标题。

有关创建实时脚本的详细信息，请参阅在实时编辑器中创建实时脚本。

使用屏幕阅读器打开和关闭脚本和实时脚本

您可以使用屏幕阅读器和键盘打开和关闭现有 MATLAB 代码文件，包括脚本和实时脚本。

例如，要打开和关闭 myrandom.m，请执行以下操作：

在运行 NVDA 屏幕阅读器的 Windows 系统上，打开 Google Chrome 浏览器并启动 MATLAB Online。
将光标置于命令行窗口中，通过在命令行窗口中输入以下语句打开 myrandom.m。
```
open myrandom.m
```
您会听到：
```
Edit multiline 
Start of document
line one n equals 50
```
您也可以使用工具条上的打开按钮打开脚本。
要关闭 myrandom.m，请按 Ctrl+Shift+F6 将光标移出文档。您会听到：
```
Tab control 
myrandom.m tab selected
C MyWork myrandom.m one of one
```

按 Delete 键关闭文档。您会听到：

Command Window region
Command Window edit multiline
Greater greater

有关其他文件操作的详细信息，请参阅管理文件和文件夹。

使用屏幕阅读器浏览绘图数据

在图窗中绘制数据支持数据可视化。您可以使用图窗快速调查数据并显示代码输出。您可以使用屏幕阅读器和键盘浏览图窗。

例如：

在运行 NVDA 屏幕阅读器的 Windows 系统上，打开 Google Chrome 浏览器并启动 MATLAB Online。
将光标放在命令行窗口中，通过在命令行窗口中输入以下语句来创建名为 x 的变量。
```
x = 1:5
```
MATLAB 将 x 添加到工作区并在命令行窗口中显示结果。您会听到：
```
x equals one two three four five
Ready prompt
One variable added to workspace
```
当您听到就绪提示符时，命令行窗口已准备就绪，可以开始在命令提示符下执行下一条语句 (>>)。
通过在命令行窗口中输入以下语句创建另一个变量 y。
```
y = 2*x
```
您会听到：
```
y equals two four six eight ten
Ready prompt
One variable added to workspace
```
通过在命令行窗口中输入以下语句，绘制 y 的数据对 x 的数据的图。
```
plot(x,y)
```
您会听到：
```
Figure 1
The current axes object contains one object of type line
```
通过按 Ctrl+F6 键将光标移回命令行窗口，直到您听到：
```
Command Window button 
heading level two
```

通过按 Tab 键进入命令行窗口。您会听到：

Command Window region
Command Window edit multiline
Greater greater

在图窗中添加标题和图例。

title("My Plot")
legend

您会听到：

Figure 1
The current axes object contains one object of type line

通过按 Ctrl+F6 导航到新图窗选项卡，直到您听到：
```
Tab control
Figure 1 tab selected
Figure 1, one of one
```

按 Tab 键两次，以选择图窗坐标区。

您会听到：

Figure 1
The current axes object contains one object of type line
The axes object with title my plot contains one object of type line

按 NVDA 修改键+Space 以切换到图窗坐标区焦点模式。默认情况下，NVDA 修改键是 Insert 键。
按 Ctrl+向下箭头以选择坐标区内的标题。
您会听到：
```
Text my plot
```
按 Tab 键以选择线条对象。如果坐标区包含多个对象，请按 Tab 键在其中导航。

有关浏览绘图数据的详细信息，请参阅交互式探查绘图数据。

使用屏幕阅读器删除文件

您可以使用屏幕阅读器和键盘删除文件和文件夹。

例如，要删除当前文件夹中的脚本 myrandom.m，请执行下列操作：

在运行 NVDA 屏幕阅读器的 Windows 系统上，打开 Google Chrome 浏览器并启动 MATLAB Online。
将光标置于命令行窗口中，通过在命令行窗口中输入以下语句删除 myrandom.m。
```
delete myrandom.m
```
您会听到：
```
Ready prompt
```

您也可以使用文件面板删除脚本：

通过按 Ctrl+F6 导航到“文件”面板，直到您听到：
```
Complimentary landmark files button heading level two
```
文件面板包含一个表，其中列出了当前文件夹中的文件和文件夹。按 Tab 键选择该表。您会听到：
```
Files region
Table
```
按向上箭头键或向下箭头键选择 myrandom.m，直到您听到：
```
myrandom.m script preview row collapsed level one
```

按 Delete 键。“删除文件”对话框打开，您会听到：

Delete file dialog
Question icon are you sure you want to delete this file?
Clickable yes button delete file
Button yes button no

按 Enter 键删除该文件。

有关其他文件操作的详细信息，请参阅管理文件和文件夹。