web

Web ページまたはファイルのブラウザー表示

ページ内をすべて折りたたむ

構文

web(url)
web(url,opt)
web(url,opt1,...,optN)
web
stat = web(___)
[stat,h] = web(___)
[stat,h,url] = web(___)

説明

web(url) は、url で指定されたページを Web ブラウザーで開きます。url が外部サイトまたはドキュメンテーション ページ (カスタム ドキュメンテーション ページを含む) の場合、web(url) はシステムの Web ブラウザーでページを開きます。それ以外の場合、ページは HTML ビューアーで開きます。複数のブラウザーが開かれている場合、ページは最も直近に使用されたブラウザーに表示されます。

例

web(url,opt) は、新しい Web ブラウザー インスタンスを作成する '-new' やシステムの Web ブラウザーを使用する '-browser' などのブラウザー オプションの指定によりページを開きます。

Microsoft® Windows® および Apple Macintosh のプラットフォームでは、オペレーティング システムがシステムの Web ブラウザーを決定します。その他のシステムでは、Mozilla® Firefox® が既定のブラウザーですが、MATLAB® の Web 設定を使用して既定を変更することができます。

例

web(url,opt1,...,optN) は、1 つ以上のブラウザー オプションを使用してページを開きます。

例

web は、空の [HTML ビューアー] タブを開きます。[HTML ビューアー] タブが既に開いている場合、web は何も行いません。

stat = web(___) は、動作のステータスとして、正常に完了した場合は 0、失敗した場合は 1 または 2 を返します。前述の構文のいずれかの入力引数を含めることができます。

[stat,h] = web(___) は、[HTML ビューアー] タブへのハンドルを返します。これにより、close(h) コマンドを使用してそのタブを閉じることができます。ページがシステムの Web ブラウザーで開いた場合、web は空のハンドルを返します。

[stat,h] = web のように web 関数に入力を指定しない場合、ハンドルは前回使用された HTML ビューアーに対応します。

[stat,h,url] = web(___) は、HTML ビューアー内の現在のページの URL を返します。ページがシステムの Web ブラウザーで開いた場合、web は空の URL を返します。

例

すべて折りたたむ

スクリプトを開く

システムの Web ブラウザーで MathWorks® Web サイトのホーム ページを開きます。

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)
スクリプトを開く

システムの Web ブラウザーの既定のメール アプリケーションから、mailto: URL スキームを使用して電子メールを送信します。

この例を実行するには、email の値を有効な電子メール アドレスで置き換えてください。

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

text:// URL スキームを使用して書式設定済みのテキストを表示します。 

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

入力引数

すべて折りたたむ

Web ページのアドレスまたはファイルの場所。文字ベクトルまたは string として指定します。ファイルの場所には絶対パスまたは相対パスのどちらも含めることができます。

url が外部サイトまたはドキュメンテーション ページ (カスタム ドキュメンテーション ページを含む) の場合、ページはシステムの Web ブラウザーで開きます。それ以外の場合、ページは HTML ビューアーで開きます。

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

例: "myfolder/myfile.html"

ブラウザーのオプション。以下のいずれかとして指定します。オプションの順番は任意です。

'-browser'

HTML ビューアーではなく、システムの Web ブラウザーでページを開きます。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 ビューアー] タブ内の現在のページ アドレス。文字ベクトルまたは string として返されます。url のデータ型は入力引数 url と同じです。ページがシステムの Web ブラウザーで開いた場合、url は空 ('') になります。

制限

  • MATLAB Online™ では、web(url) の構文のみがサポートされます。MATLAB Online で web(url) を呼び出すと、url で指定したページが Web ブラウザーで開きます。

  • 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 より前に導入

すべて展開する

参考

関数

クラス

トピック