主要内容

本页翻译不是最新的。点击此处可查看最新英文版本。

web

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

说明

web(url) 在 Web 浏览器中打开由 url 指定的网页。如果 url 是外部网站或文档页(包括自定义文档页),web(url) 会在您的系统 Web 浏览器中打开该页。否则,该页会在 HTML 查看器中打开。如果打开了多个浏览器,该网页将显示于最近使用的浏览器中。

示例

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

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

示例

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

示例

web 打开空的 HTML 查看器选项卡。如果 HTML 查看器选项卡已打开,web 不会执行任何操作。

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

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

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

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

示例

全部折叠

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

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

通过发布一个示例程序文件来创建一个本地 HTML 文件。

htmlFile = publish("penny.m",outputDir=pwd);

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

web(htmlFile)

在不包括工具栏的 HTML 查看器的新选项卡中查看文件。

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

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

url = "file:///" + htmlFile;
web(url)

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

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

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

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

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

输入参数

全部折叠

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

如果 url 是外部网站或文档页(包括自定义文档页),则该页会在您的系统 Web 浏览器中打开。否则,该页会在 HTML 查看器中打开。

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

示例: "myfolder/myfile.html"

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

'-browser'

在您的系统 Web 浏览器(而不是 HTML 查看器)中打开网页。如果 url 是外部网站,web 将始终在您的系统 Web 浏览器中打开该网页。

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

'-new'

在新的 HTML 查看器选项卡中打开该页。当网页在系统 Web 浏览器中打开时不适用。

'-noaddressbox'

在未显示地址框的浏览器中打开网页。仅适用于新 HTML 查看器选项卡。

'-notoolbar'

在未显示工具栏或地址框的浏览器中打开网页。仅适用于新 HTML 查看器选项卡。

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

输出参量

全部折叠

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

0

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

1

找不到系统 Web 浏览器。

2

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

最近使用的 HTML 查看器选项卡的句柄,以 matlab.htmlviewer.HTMLViewer 类的标量实例形式返回。如果网页在系统 Web 浏览器中打开,则 h 为空,即 []

如果打开页面时未请求句柄,则此句柄可能不与最近使用的 web 函数对应,因为 MATLAB 使用 web 函数实现其他功能。

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

限制

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

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

提示

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

  • 如果在 HTML 查看器中显示日文流文本,请指定包括 charset 属性的标头。例如:

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

版本历史记录

在 R2006a 之前推出

全部展开