次の方法で共有


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

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

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

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

重要

Internet Explorer と Microsoft Edge レガシからの Web ビューは、Office アドインで引き続き使用されます

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

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

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

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

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

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

これらのプラットフォームでは、使用されるブラウザーがプラットフォームによって決定されます。

OS Office のバージョン ブラウザー
any Office on the web Office が開かれているブラウザー。
(ただし、Web 上の Office は Internet Explorer で開かないことに注意してください。
これを行おうとすると、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 レガシによって提供されます。
  • Internet Explorer 11 によって提供される Trident+。 最後の "+" は、Office アドインが、Trident 自体に組み込まれていない Internet Explorer 11 の追加機能を使用することを示します。

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

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

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

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

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

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

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

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

サブスクリプション Office on Windows の場合、使用されるブラウザーは、オペレーティング システム、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 AND< 16.0.13530.204241 かまいません EdgeHTML (Microsoft Edge レガシ)3、4
Windows 11、
Windows 10 バージョン  >= 1903
Microsoft 365 ver.  < 16.0.116291 かまいません Trident+ (Internet Explorer 11)
Windows 10 バージョン  < 1903,
Windows 8.1
Microsoft 365 いいえ Trident+ (Internet Explorer 11)
Windows 7 Microsoft 365 かまいません Trident+ (Internet Explorer 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 アドインで XML マニフェストを使用し、マニフェストに <Runtimes> 要素を含める場合、または統合マニフェストを使用し、"extensions.runtimes.lifetime" プロパティが含まれている場合、EdgeHTML は使用されません。 WebView2 を使用する条件が満たされている場合、アドインは WebView2 を使用します。 それ以外の場合は、Trident+ を使用します。 詳細については、「 ランタイム 」および「 イベント ベースのアクティブ化のために Outlook アドインを構成する」を参照してください。

Trident+ の操作 (Internet Explorer 11)

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

  • ECMAScript 2015 (ES6 とも呼ばれます) 以降の JavaScript または TypeScript でコードを記述し、 babeltsc などのコンパイラを使用してコードを 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 レガシ) です。

関連項目