次の方法で共有

Office アドインで使用されるブラウザーと Webview コントロール

  • [アーティクル]

Office アドインは、Office on the webで実行するときに iframe を使用して表示される Web アプリケーションです。 Office for デスクトップおよびモバイル クライアントでは、Office アドインは埋め込みブラウザー コントロール (Webview とも呼ばれます) を使用します。 アドインには JavaScript を実行するための JavaScript エンジンも必要です。 埋め込みブラウザーとエンジンの両方が、ユーザーのコンピューターにインストールされているブラウザーによって提供されます。 この記事では、"webview" とは、Webview コントロールと JavaScript エンジンの組み合わせを指します。

使用される Web ビューは、次によって異なります。

  • コンピューターのオペレーティング システム。
  • アドインがOffice on the web、Microsoft 365 サブスクリプションからダウンロードされた Office、または永続的な Office 2016 以降で実行されているかどうか。
  • Windows 上の Office の永続的なバージョン内で、アドインが "リテール" または "ボリューム ライセンス" のバリエーションで実行されているかどうか。

重要

インターネット エクスプローラーとMicrosoft Edge 従来版からの Web ビューは、Office アドインで引き続き使用されます

この記事で説明するように、Office 2019 を通じてボリューム ライセンスの永続的なバージョンを含む、プラットフォームと Office バージョンの組み合わせによっては、インターネット エクスプローラー 11 ("Trident" と呼ばれます) と Microsoft Edge 従来版 ("EdgeHTML" と呼ばれる) に付属する Webview コントロールを使用してアドインをホストします。 インターネット エクスプローラー 11 は、2023 年 2 月にWindows 10とWindows 11で無効になり、起動するための UI は削除されましたが、これらのオペレーティング システムには引き続きインストールされています。 そのため、Trident やその他のインターネット エクスプローラーの機能は、引き続き Office からプログラムで呼び出すことができます。

これらの Web ビューのいずれかでアドインを起動したときに、アドインのユーザーに正常なエラー メッセージを提供することで、少なくとも最小限の方法で、これらの組み合わせを引き続きサポートすることをお勧めします (ただし、必要ありません)。 次の点に注意してください。

  • インターネット エクスプローラーまたはMicrosoft Edge 従来版で開かなくなったOffice on the web。 そのため、 AppSource はこれらの Web ブラウザーで Office のアドインをテストしません。
  • AppSource では、Trident または EdgeHTML を使用するプラットフォームと Office デスクトップ バージョンの組み合わせが引き続きテストされます。 ただし、アドインでこれらの Web ビューがサポートされていない場合にのみ警告が発行されます。アドインは AppSource によって拒否されません。
  • Script Lab ツールは Trident をサポートしなくなりました。

アドインでの正常なエラー メッセージの構成など、Trident または EdgeHTML のサポートの詳細については、「 以前の Microsoft Webview と Office バージョンをサポートする」を参照してください。

次のセクションでは、さまざまなプラットフォームとオペレーティング システムに使用されるブラウザーを指定します。

Windows 以外のプラットフォーム

これらのプラットフォームの場合、使用されるブラウザーはプラットフォームだけで決まります。

OS Office のバージョン ブラウザー
any Office on the web Office が開かれているブラウザー。
(ただし、インターネット エクスプローラーではOffice on the webが開かないことに注意してください。
これを行おうとすると、Edge でOffice on the webが開きます)。
Mac any WKWebView を使用した Safari
iOS any WKWebView を使用した Safari
Android any Chrome

重要

条件付きアクセス は、iOS または Android の Office アドインではサポートされていません。 これらのアドインでは、Edge ベースのブラウザー コントロールではなく、Safari ベースの WKWebView または Android ベースの WebView が使用されます。

Windows

Windows で実行されているアドインでは、次の 3 つの異なる Web ビューのいずれかを使用できます。

  • WebView2。これは Microsoft Edge (Chromium ベース) によって提供されます。
  • EdgeHTML。これは、Microsoft Edge 従来版によって提供されます。
  • Trident+ は、インターネット エクスプローラー 11 によって提供されます。 最後の "+" は、Office アドインが、Trident 自体に組み込まれていないインターネット エクスプローラー 11 の追加機能を使用することを示します。

Windows 上の Office の永続的なバージョン

Windows 上の Office の永続的なバージョンの場合、使用されるブラウザーは、Office のバージョン、ライセンスが製品版かボリューム ライセンスか、Edge WebView2 (Chromium ベース) がインストールされているかどうかによって決まります。 Windows のバージョンは関係ありませんが、Office アドインは Windows 7 より前のバージョンではサポートされておらず、Office 2021以降はWindows 10より前のバージョンではサポートされていないことに注意してください。

Office 2016 または Office 2019 がリテール版かボリューム ライセンス版かを判断するには、Office のバージョンとビルド番号の形式を使用します。 (Office 2021以降の場合、ボリューム ライセンスと小売りの区別は関係ありません)。

  • リテール: Office 2016 と 2019 の両方の形式は YYMM (xxxxx.xxxxxx)で、5 桁の 2 ブロックで終わるです。たとえば です 2206 (Build 15330.20264)。
  • ボリューム ライセンス:
    • Office 2016 の場合、形式は です。末尾は 16.0.xxxx.xxxxx4 桁の 2 ブロックです(例: 16.0.5197.1000)。
    • Office 2019 の場合、形式は です。末尾は 1808 (xxxxx.xxxxxx)5 桁の 2 ブロックです(例: 1808 (Build 10388.20027))。 年と月は常に であることに注意してください 1808。
Office のバージョン リテールライセンスとボリュームライセンス WebView2 がインストールされていますか? ブラウザー
Office 2024 かまいません はい1 WebView2 (Microsoft Edge2 Chromium ベース)
Office 2021 かまいません はい1 WebView2 (Microsoft Edge2 Chromium ベース)
Office 2019 小売 はい1 WebView2 (Microsoft Edge2 Chromium ベース)
Office 2019 小売 いいえ EdgeHTML (Microsoft Edge 従来版)2,3
Edge がインストールされていない場合は、Trident+ (インターネット エクスプローラー 11) が使用されます。
Office 2019 ボリューム ライセンス かまいません Trident+ (インターネット エクスプローラー 11)
Office 2016 小売 はい1 WebView2 (Microsoft Edge2 Chromium ベース)
Office 2016 小売 いいえ EdgeHTML (Microsoft Edge 従来版)2,3
Edge がインストールされていない場合は、Trident+ (インターネット エクスプローラー 11) が使用されます。
Office 2016 ボリューム ライセンス かまいません Trident+ (インターネット エクスプローラー 11)

1 Windows 11より前の Windows バージョンでは、Office が埋め込むことができるように WebView2 コントロールをインストールする必要があります。 永続的なOffice 2021以降でインストールされますが、Microsoft Edge では自動的にインストールされません。 以前のバージョンの永続的な Office がある場合は、 Microsoft Edge WebView2/ Embed Web コンテンツ ... にコントロールをインストールする手順を使用します。Microsoft Edge WebView2 を使用します。

2 EdgeHTML または WebView2 を使用すると、Windows ナレーター ("スクリーン リーダー" とも呼ばれます) は、作業ウィンドウで開くページのタグを読み取 <title> ります。 Trident+ では、ナレーターは作業ウィンドウのタイトル バーを読み取ります。これは、アドインのマニフェストで指定されているアドイン名から取得されます。

3 アドインがアドインのみのマニフェストを使用し、マニフェストに Runtimes> 要素を含める<場合、または統合マニフェストを使用し、"extensions.runtimes.lifetime" プロパティが含まれている場合、EdgeHTML は使用されません。 WebView2 を使用する条件が満たされている場合、アドインは WebView2 を使用します。 それ以外の場合は、Trident+ を使用します。 詳細については、「 ランタイム 」および「 イベント ベースのアクティブ化のために Outlook アドインを構成する」を参照してください。

Windows 上の Office の Microsoft 365 サブスクリプション バージョン

Windows 上のサブスクリプション Office の場合、使用されるブラウザーは、オペレーティング システム、Office のバージョン、および WebView2 コントロールがインストールされているかどうかによって決まります。

OS Office のバージョン WebView2 がインストールされていますか? ブラウザー
  • Windows 11
  • Windows 10
  • Windows 8.1
  • Windows Server 2022
  • Windows Server 2019
  • Windows Server 2016
 Microsoft 365 ver.  >= 16.0.13530.204241 はい2 WebView2 (Microsoft Edge3 Chromium ベース)
  • ウィンドウ 11
  • Windows 10 バージョン  >= 1903
 Microsoft 365 ver.  >= 16.0.13530.204241 いいえ EdgeHTML (Microsoft Edge 従来版)3,4
  • Windows 11
  • Windows 10 バージョン  >= 1903
 Microsoft 365 ver.  >= 16.0.11629 および< 16.0.13530.204241 かまいません EdgeHTML (Microsoft Edge 従来版)3,4
  • Windows 11
  • Windows 10 バージョン  >= 1903
 Microsoft 365 ver.  < 16.0.116291 かまいません Trident+ (インターネット エクスプローラー 11)
  • Windows 10 バージョン  < 1903
  • Windows 8.1
 Microsoft 365 いいえ Trident+ (インターネット エクスプローラー 11)
  • Windows 7
 Microsoft 365 かまいません Trident+ (インターネット エクスプローラー 11)

1 詳細については、 更新履歴ページ と 、Office クライアントのバージョンと更新チャネルを見つける 方法を参照してください。

2 Windows 11より前の Windows バージョンでは、Office が埋め込むことができるように WebView2 コントロールをインストールする必要があります。 Microsoft 365 バージョン 2101 以降でインストールされますが、Microsoft Edge では自動的にインストールされません。 以前のバージョンの Microsoft 365 をお持ちの場合は、 Microsoft Edge WebView2 /埋め込み Web コンテンツ ... にコントロールをインストールする手順を使用します。Microsoft Edge WebView2 を使用します。 16.0.14326.xxxxx より前の Microsoft 365 ビルドでは、レジストリ キー HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\Win32WebView2 を作成し、その値を に設定する dword:00000001必要もあります。

3 EdgeHTML または WebView2 を使用すると、Windows ナレーター ("スクリーン リーダー" とも呼ばれます) は、作業ウィンドウで開くページのタグを読み取 <title> ります。 Trident+ では、ナレーターは作業ウィンドウのタイトル バーを読み取ります。これは、アドインのマニフェストで指定されているアドイン名から取得されます。

4 アドインがアドインのみのマニフェストを使用し、マニフェストに Runtimes> 要素を含める<場合、または統合マニフェストを使用し、"extensions.runtimes.lifetime" プロパティが含まれている場合、EdgeHTML は使用されません。 WebView2 を使用する条件が満たされている場合、アドインは WebView2 を使用します。 それ以外の場合は、Trident+ を使用します。 詳細については、「 ランタイム 」および「 イベント ベースのアクティブ化のために Outlook アドインを構成する」を参照してください。

Trident+ の操作 (インターネット エクスプローラー 11)

Trident+ では、ES5 より後の JavaScript バージョンはサポートされていません。 アドインのユーザーに Trident+ を使用するプラットフォームがある場合、ECMAScript 2015 以降の構文と機能を使用するには、2 つのオプションがあります。

  • ECMAScript 2015 (ES6 とも呼ばれます) 以降の JavaScript または TypeScript でコードを記述し、 babel や tsc などのコンパイラを使用してコードを ES5 JavaScript にコンパイルします。
  • ECMAScript 2015 以降の JavaScript で記述しますが、CORE-js などのポリフィル ライブラリも読み込み、IE でコードを実行できるようにします。

これらのオプションの詳細については、「以前の Microsoft Webview と Office バージョンをサポートする」を参照してください。

また、Trident+ では、メディア、記録、場所などの一部の HTML5 機能はサポートされていません。 詳細については、「 アドインが実行時に実行されている Web ビューを決定する」を参照してください。

EdgeHTML と WebView2 (Microsoft Edge) の問題のトラブルシューティング

Service Worker が機能していない

Office アドインでは、EdgeHTML が使用されている場合、Service Worker はサポートされません。 WebView2 でサポートされています。

作業ウィンドウにスクロール バーが表示されない

既定では、EdgeHTML と WebView2 のスクロール バーは、マウス ポインターを合わせるまで非表示になります。 スクロールバーが常に表示されるようにするには、作業ウィンドウのページの<body>要素に適用される CSS スタイルに -ms-overflow-style プロパティを含め、scrollbarに設定する必要があります。

Microsoft Edge DevTools を使用してデバッグすると、アドインがクラッシュまたは再読み込みされる

Microsoft Edge DevTools for EdgeHTML でブレークポイントを設定すると、Office はアドインがハングしていると考える可能性があります。 これが発生すると、アドインが自動的に再読み込みされます。 これを防ぐには、開発用コンピューターに以下のレジストリ キーと値を追加します: [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\16.0\Wef]"AlertInterval"=dword:00000000。

アドインを開こうとすると、"アドイン エラー localhost からこのアドインを開けません" というエラーが表示される

既知の原因の 1 つは、EdgeHTML では、開発用コンピューターで localhost にループバックの除外を与える必要があるということです。 Cannot open add-in from localhost (localhostからアドインを開くことができません)の指示に従ってください。

PDF ファイルのダウンロード中にエラーが発生する

アドインで BLOB を PDF ファイルとして直接ダウンロードすることは、EdgeHTML または WebView2 ではサポートされていません。 回避策は、BLOB を PDF ファイルとしてダウンロードする単純な Web アプリケーションを作成することです。 アドインで、 メソッドを Office.context.ui.openBrowserWindow(url) 呼び出し、Web アプリケーションの URL を渡します。 これにより、Office の外部のブラウザー ウィンドウで Web アプリケーションが開きます。

WIP で保護されたドキュメント

WIP (Windows Information Protection) を使用してドキュメント内でアドインを実行し、WebView2 (Microsoft Edge Chromium ベース) を使用するには、追加の手順が必要です。 WebView2 プロセス (msedgewebview2.exe) を、企業の WIP ポリシーの保護されたアプリの一覧に追加します。 管理者は、次の値を使用してIntuneを通じてこの WIP ポリシーを追加します。

  • 名前: Webview2
  • 発行元: O=MICROSOFT CORPORATION、L=REDMOND、S=WASHINGTON、C=US
  • 製品名: MICROSOFT EDGE WEBVIEW2
  • ファイル: MSEDGEWEBVIEW2.EXE
  • 最小バージョン: *
  • 最大バージョン: *

WIP ポリシーが追加されていない場合、アドインは既定で古いランタイムになります。 この記事の「Windows 上の Office の永続的なバージョン」および「Windows 上の Office の Microsoft 365 サブスクリプション バージョン」セクションでは、EdgeHTML (Microsoft Edge 従来版) を WebView2 (Microsoft Edge Chromium ベース) に置き換えます。

ドキュメントが WIP で保護されているかどうかを判断するには、次の手順に従います。

  1. ファイルを開きます。
  2. リボンの [ ファイル ] タブを選択します。
  3. [ 情報] を選択します。
  4. [情報] ページの上部にあるファイル名のすぐ下に、WIP が有効なドキュメントに、ブリーフケース アイコンが続き、[Managed by Work (...)] が続きます。

注:

WIP 対応ドキュメントでの WebView2 のサポートは、ビルド 16.0.16626.20132 で追加されました。 古いビルドの場合、ポリシーに関係なく、ランタイムの既定値は EdgeHTML (Microsoft Edge 従来版) です。

関連項目