Main Content

web

在浏览器中打开网页或文件

说明

web 打开一个空的 MATLAB® Web 浏览器。

注意

安全注意事项:避免使用 MATLAB Web 浏览器进行普通的 Web 浏览。请改用您的系统浏览器。

示例

web(url) 在 MATLAB Web 浏览器中打开 url 指定的网页。如果 url 是外部网站,web(url) 将在您的系统浏览器中打开该网页。如果打开了多个浏览器,该网页将显示于最近使用的浏览器中。

示例

web(url,opt) 使用指定的浏览器选项(例如 '-new')打开网页以创建一个新浏览器实例,或使用选项 '-browser' 来使用系统浏览器。

在 Microsoft® Windows®Apple Macintosh 平台上,操作系统决定系统 Web 浏览器。在其他系统上,默认浏览器为 Mozilla® Firefox® 浏览器,但您可以使用 MATLAB Web 预设更改默认值。

示例

web(url,opt1,...,optN) 使用一个或多个浏览器选项打开网页。

stat = web(___) 返回操作状态:如果成功,返回 0;如果失败,返回 12。您可以包括先前语法中的任何输入参数。

[stat,h] = web(___) 返回 MATLAB Web 浏览器的句柄,该句柄允许您使用命令 close(h) 关闭该浏览器。如果该网页在系统浏览器中打开,web 将返回一个空句柄。

如果未指定 web 函数(例如 [stat,h] = web)的任何输入,则该句柄对应于最近使用的 MATLAB Web 浏览器。

[stat,h,url] = web(___) 返回 MATLAB Web 浏览器中当前网页的 URL。如果该网页在系统浏览器中打开,web 将返回一个空 URL。

示例

全部折叠

在系统浏览器中打开 MathWorks® 网站主页。

url = 'https://www.mathworks.com';
web(url)

查看位于系统上的 HTML 文件。

通过发布示例程序文件创建 HTML 文件。将程序文件复制到当前文件夹,以便代码可以在发布过程中运行。

program = fullfile(matlabroot,'help','techdoc',...
          'matlab_env','examples','fourier_demo2.m');
copyfile(program);
htmlFile = publish('fourier_demo2.m');

通过指定文件名查看文件。

web(htmlFile)

在不包含工具栏的新浏览器实例中查看文件。

web(htmlFile,'-new','-notoolbar')

或者,可以使用 file:/// URL 方案(只要包括完整路径即可)。publish 函数在 htmlFile 输出中返回该路径。

url = ['file:///',htmlFile];
web(url)

使用 mailto: URL 方案从系统浏览器的默认邮件应用程序发送电子邮件。

要运行此示例,请将 email 的值替换为有效的电子邮件地址。

email = 'myaddress@provider.ext';
url = ['mailto:',email];
web(url)

查看使用 text:// URL 方案的格式化文本。

web('text://<html><h1>Hello World</h1></html>')

输入参数

全部折叠

网页地址或文件位置,指定为字符向量或字符串。文件位置可以包括绝对或相对路径。

如果 url 是外部网站,则该网页将在您的系统浏览器中打开。如果 url 对应于已安装产品文档中的文件,则网页将显示于 MATLAB 帮助浏览器而不是 Web 浏览器中。

示例: 'https:\\www.mathworks.com'

示例: "myfolder/myfile.html"

浏览器选项,指定为下列各项之一。选项可以按任意顺序显示。

'-browser'

在系统浏览器窗口而不是 MATLAB Web 浏览器中打开网页。在 Microsoft Windows 和 Apple Macintosh 平台上,操作系统决定系统 Web 浏览器。在其他系统上,默认浏览器为 Mozilla Firefox 浏览器,但您可以使用 MATLAB Web 预设更改默认值。

'-new'

在一个 MATLAB Web 浏览器的新实例中打开网页。当网页在系统浏览器中打开时不适用。

'-noaddressbox'

在未显示地址框的浏览器中打开网页。仅适用于 MATLAB Web 浏览器的新实例。

'-notoolbar'

在未显示工具栏或地址框的浏览器中打开网页。仅适用于 MATLAB Web 浏览器的新实例。

示例: '-new','-noaddressbox'

输出参数

全部折叠

浏览器状态,返回为以下值之一的整数:

0

已发现并启动系统浏览器。

1

找不到系统浏览器。

2

已发现系统浏览器,但不能启动。

最近使用的 MATLAB Web 浏览器的句柄,返回为关联的 Java® 类的标量实例。如果网页在系统浏览器中打开,h 为空,即 []

如果打开页面时未请求句柄,则此句柄可能不与最近使用的 web 函数对应。其他 MATLAB 功能也使用 web 函数,例如从帮助浏览器指向外部网站的链接。

最近使用的 MATLAB Web 浏览器中的当前网页地址,以字符向量或字符串形式返回。url 的数据类型与输入参数 url 相同。如果网页在系统浏览器中打开,url 为空,即 ''

局限性

  • MATLAB Online™ 仅支持 web(url) 语法。在 MATLAB Online 中调用 web(url) 将在您的 Web 浏览器(而不是 MATLAB Web 浏览器)中打开 url 指定的页面。

  • 在系统浏览器中或从已部署的应用程序中打开页面时,web 函数不支持 text:// URL 方案。

提示

  • 要在 MATLAB 浏览器(而不是默认的系统浏览器)中打开外部网站,请转至主页选项卡,并在环境部分中,点击预设。选择 MATLAB > 网页,在系统 Web 浏览器部分中,清除打开外部网站链接时使用系统 Web 浏览器(推荐)。打开外部网站时建议使用系统浏览器。

  • 如果计划部署一个应用程序以使用 MATLAB Compiler™ 产品调用 web 函数,请使用 '-browser' 选项在系统浏览器中打开所有页面。

  • 如果在 MATLAB Web 浏览器中显示日文流文本,请指定包括 charset 属性的标头。例如:

    web(['text://<html><head><meta http-equiv="content-type" ' ...
         'content="text/html;charset=utf-8"></head><body>TEXT</body></html>']) 

版本历史记录

在 R2006a 之前推出

全部展开