web

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

全页折叠

语法

web(url)
web(url,opt)
web(url,opt1,...,optN)
web
stat = web(___)
[stat,h] = web(___)
[stat,h,url] = 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；如果失败，返回 1 或 2。您可以包括上述语法中的任何输入参量。

[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 之前推出

全部展开

另请参阅

函数

类

主题