Script Lab を使用して Office JavaScript API を探索する

Script Labは、Office アドインを開発する方法を誰でも学ぶ無料のツールです。Script Labを使用すると、Excel、Outlook、PowerPoint、Word でドキュメントと共に Office JavaScript API をコーディングして実行できます。 この便利なツールを使用して、独自のアドインで必要な機能をプロトタイプ化して検証します。

この 1 分間の YouTube ビデオでは、Script Labの動作をご覧ください。 Excel、Word、PowerPoint で実行されているScript Labを示すプレビュー ビデオ。

Script Lab とは

Script Labは、アドインのプロトタイプ作成用のアドインです。Excel、Outlook、Word、PowerPoint の Office JavaScript API を使用し、ドキュメント、スプレッドシート、またはメール内の作業ウィンドウに配置されます。 Visual Studio Code で使用されるのと同じフレームワークに基づいて構築された IntelliSense 対応のコード エディターがあります。 Script Labを通じて、サンプルのライブラリにアクセスして、機能をすばやく試したり、それらのサンプルを独自のコードの出発点として使用したりできます。 開発者プレビュー段階のScript Labで、今後の API を試すことさえできます。

主な機能

Script Lab には、Office JavaScript API およびプロトタイプ アドインの機能の調査に役立つ機能が多数用意されています。

サンプルの確認

API を使用してタスクを完了する方法を示す組み込みのサンプル スニペットのコレクションを使用してすぐに開始できます。 サンプルを実行すると、作業ウィンドウまたはドキュメントですばやく結果を表示したり、API のしくみをサンプルで確認して学んだり、独自のアドインのプロトタイプにサンプルを使用したりもできます。

サンプル。

コードとスタイル

Office JS API を呼び出す JavaScript または TypeScript コードに加えて、各スニペットには、作業ウィンドウのコンテンツを定義する HTML マークアップと、作業ウィンドウの外観を定義する CSS も含まれています。 HTML マークアップと CSS をカスタマイズして、独自のアドインの作業ウィンドウ デザインのプロトタイプを作成する際に、要素の配置とスタイル設定を試すことができます。

ヒント

スニペット内でプレビュー API を呼び出すには、スニペットのライブラリを更新して、ベータ コンテンツ ネットワーク (CDN) (https://appsforoffice.microsoft.com/lib/beta/hosted/office.js) とプレビューの種類の定義 @types/office-js-preview を使用する必要があります。 また、一部のプレビュー API は、Office Insider プログラムにサインアップして、Insider ビルドの Office を実行している場合にのみアクセスできます。

スニペットの保存と共有

既定では、Script Lab で開いたスニペットはブラウザーのキャッシュに保存されます。 スニペットを完全に保存するには、そのスニペットを GitHub の Gist にエクスポートします。 自分専用にスニペットを保存するには、秘密の Gist を作成するか、他のユーザーと共有する予定がある場合はパブリックの Gist を作成します。

共有オプション。

スニペットのインポート

スニペット YAML が保存されているパブリック GitHub の Gist に URL を指定するか、スニペットの完全な YAML を貼り付けて、スニペットを Script Lab にインポートできます。 この機能は、GitHub の Gist にスニペットを公開するか、スニペットの YAML を提供すると、他のユーザーがスニペットを自分と共有しているシナリオで役立ちます。

スニペットのインポート オプション。

サポートされるクライアント

Script Lab は、次のクライアント上の Excel、Word、PowerPoint でサポートされています。

  • Office on Windows*
  • Office on Mac
  • Office on the web

Outlook 用 Script Lab は、次のクライアントで使用できます。

  • Outlook on Windows*
  • Outlook on Mac
  • Chrome、Microsoft Edge、または Safari ブラウザーを使用している場合の Outlook on the web

Outlook 用 Script Lab の詳細については、関連するブログの投稿を参照してください。

重要

* Script Labは、Internet Explorer を使用してアドインをホストするプラットフォームと Office バージョンの組み合わせでは機能しなくなりました。これには、Office 2019 を通じた Office の永続的なバージョンが含まれます。 詳細については、「Office アドインによって使用されるブラウザー」を参照してください。

次の手順

Excel、Word、または PowerPoint で Script Lab を使用するには、AppSource から Script Lab アドインをインストールします。

Outlook 用 Script Lab を使用するには、AppSource から Outlook 用 Script Lab のアドインをインストールします。

新しいスニペットを office-js-snippets GitHub リポジトリに投稿し、Script Lab のサンプル ライブラリを拡張してください。

最初の Office アドインを作成する準備ができたら、ExcelOutlookWordOneNote PowerPoint、または Project のクイック スタートを試してください。

関連項目