Excel JavaScript API の要件セット

要件セットは、API メンバーの名前付きグループです。 Office アドインでは、マニフェストで指定されている要件セットを使用するか、ランタイム チェックを使用して、Office アプリケーションがアドインに必要な API をサポートしているかどうかを判断します。 詳細については、「 Office のバージョンと要件セット」を参照してください。

要件セットの可用性

Excel アドインは、Windows 上のOffice 2021以降、Office on the web、Mac、iPad など、複数のバージョンの Office で実行されます。 次の表に、Excel 要件セット、サポートされている Office クライアント アプリケーション、および該当する場合はそれらのアプリケーションの 最小 ビルドまたはバージョンを示します。

Office のバージョンとビルド番号

Office のバージョンとビルド番号の詳細については、次を参照してください。

• Microsoft 365 クライアントの更新プログラム チャネル リリースのバージョンとビルド番号
• 使用している Office のバージョンを確認する方法

実行時およびマニフェストで Excel 要件セットを使用する方法

要件セットは、API メンバーの名前付きグループです。 Office アドインはランタイム チェックを実行できます。または、マニフェストで指定されている要件セットを使用して、Office アプリケーションがアドインに必要な API をサポートしているかどうかを確認できます。

実行時に要件セットのサポートを確認する

次のコード サンプルは、アドインが実行されている Office アプリケーションが指定された API の要件セットをサポートしているかどうかを確認する方法を示しています。

if (Office.context.requirements.isSetSupported('ExcelApi', '1.3')) {
  // Perform actions.
}
else {
  // Provide alternate flow/logic.
}

マニフェストで要件セットのサポートを定義する

アドインのマニフェストで Requirements 要素 を使用して、アドインをアクティブにするために必要な最小要件セットや API メソッド (またはその両方) を指定できます。 Office アプリケーションまたはプラットフォームが、マニフェストの Requirements 要素で指定されている要件セットまたは API メソッドをサポートしていない場合、アドインはそのアプリケーションまたはプラットフォームで実行されず、[マイ アドイン] に表示されるアドインのリストに表示されません。アドインが完全な機能のために特定の要件セットを必要とするが、要件セットをサポートしていないプラットフォームのユーザーにも価値を提供できる場合は、マニフェストの要件セットのサポートを定義する代わりに、上記のように実行時に要件サポートを確認することをお勧めします。

次のコード サンプルは、アドインが ExcelApi 要件セットのバージョン 1.3 以上をサポートする Office クライアント アプリケーションのすべてで読み込まれる必要があることを指定する、アドインのマニフェストの Requirements 要素を示しています。

<Requirements>
   <Sets DefaultMinVersion="1.3">
      <Set Name="ExcelApi" MinVersion="1.3"/>
   </Sets>
</Requirements>

関連項目

• Excel JavaScript API リファレンス ドキュメント
• Office アドイン マニフェスト