スクリプトラボを使用して Office JavaScript API を探索するExplore Office JavaScript API using Script Lab

Script Lab アドインは appsource から無料で利用できます。これにより、Excel や Word などの office プログラムで作業しているときに OFFICE JavaScript API を調べることができます。The Script Lab add-in, which is available free from AppSource, enables you to explore the Office JavaScript API while you're working in an Office program such as Excel or Word. スクリプトラボは、アドインに必要な機能を試作して検証する際に開発ツールキットに追加する便利なツールです。Script Lab is a convenient tool to add to your development toolkit as you prototype and verify functionality you want in your add-in.

スクリプトラボとはWhat is Script Lab?

スクリプトラボは、Excel、Word、または PowerPoint で Office JavaScript API を使用して Office アドインを開発する方法について学習する必要があるユーザーのためのツールです。Script Lab is a tool for anyone who wants to learn how to develop Office Add-ins using the Office JavaScript API in Excel, Word, or PowerPoint. これにより IntelliSense が提供され、Visual Studio Code で使用されるのと同じフレームワークである、使用可能なものと、モナコフレームワークに基づいて構築されているものがわかります。It provides IntelliSense so you can see what's available and is built on the Monaco framework, the same framework used by Visual Studio Code. スクリプトラボを使用すると、サンプルのライブラリにアクセスして、機能をすばやく試すことができます。また、サンプルを独自のコードの開始点として使用することもできます。Through Script Lab, you can access a library of samples to quickly try out features or you can use a sample as the starting point for your own code. スクリプトラボを使用してプレビュー Api を試すこともできます。You can even use Script Lab to try preview APIs.

これまでに良好なことがありますか?Sounds good so far? この1分間のビデオを見て、実行中のスクリプトラボを確認してください。Take a look at this one-minute video to see Script Lab in action.

Excel、Word、および PowerPoint で実行されているスクリプトラボを示すビデオをプレビューします。Preview video showing Script Lab running in Excel, Word, and PowerPoint.

主な機能Key features

スクリプトラボ Office JavaScript API と prototype アドインの機能について調べるのに役立つさまざまな機能が用意されています。Script Lab offers a number of features to help you explore the Office JavaScript API and prototype add-in functionality.

サンプルを検索するExplore samples

API を使用してタスクを実行する方法を示す組み込みのサンプルスニペットのコレクションを使用して、すぐに作業を開始できます。Get started quickly with a collection of built-in sample snippets that show how to complete tasks with the API. サンプルを実行すると、作業ウィンドウまたはドキュメントの結果をすぐに確認したり、サンプルを調べて API のしくみを確認したり、サンプルを使用して独自のアドインをプロトタイプしたりすることもできます。You can run the samples to instantly see the result in the task pane or document, examine the samples to learn how the API works, and even use samples to prototype your own add-in.

サンプル

コードとスタイルCode and style

Office JS API を呼び出す JavaScript または TypeScript コードに加えて、各スニペットには、作業ウィンドウの外観を定義する、作業ウィンドウと CSS のコンテンツを定義する HTML マークアップも含まれています。In addition to JavaScript or TypeScript code that calls the Office JS API, each snippet also contains HTML markup that defines content of the task pane and CSS that defines the appearance of the task pane. HTML マークアップと CSS をカスタマイズして、独自のアドインの作業ウィンドウデザインを試作する際に、要素の配置とスタイル設定を試すことができます。You can customize the HTML markup and CSS to experiment with element placement and styling as you prototype task pane design for your own add-in.

ヒント

スニペット内でプレビュー Api を呼び出すには、スニペットのライブラリを更新して、ベータ CDN (https://appsforoffice.microsoft.com/lib/beta/hosted/office.js) とプレビューの種類の定義@types/office-js-previewを使用する必要があります。To call preview APIs within a snippet, you'll need to update the snippet's libraries to use the beta CDN (https://appsforoffice.microsoft.com/lib/beta/hosted/office.js) and the preview type definitions @types/office-js-preview. また、一部のプレビュー Api は、 Office insider プログラムにサインアップし、Office の insider ビルドを実行している場合にのみアクセスできます。Additionally, some preview APIs are only accessible if you've signed up for the Office Insider program and are running an Insider build of Office.

スニペットの保存と共有Save and share snippets

既定では、スクリプトラボで開いたスニペットはブラウザーのキャッシュに保存されます。By default, snippets that you open in Script Lab will be saved to your browser cache. スニペットを完全に保存するには、それをGitHub gistにエクスポートします。To save a snippet permanently, you can export it to a GitHub gist. 独自にスニペットを保存するための secret gist を作成したり、他のユーザーと共有する予定がある場合は、パブリックな gist を作成したりします。Create a secret gist to save a snippet exclusively for your own use, or create a public gist if you plan to share it with others.

共有オプション

スニペットのインポートImport snippets

スニペットをスクリプトラボにインポートするには、スニペット YAML が格納されているパブリックGitHub gistへの URL を指定するか、スニペットの完全な yaml に貼り付けます。You can import a snippet into Script Lab either by specifying the URL to the public GitHub gist where the snippet YAML is stored or by pasting in the complete YAML for the snippet. この機能は、他のユーザーが自分のスニペットを GitHub gist に発行するか、スニペットの YAML を提供することによって、自分のスニペットを共有しているシナリオで役立つことがあります。This feature may be useful in scenarios where someone else has shared their snippet with you by either publishing it to a GitHub gist or providing their snippet's YAML.

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

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

スクリプトラボは、Excel、Word、および PowerPoint の次のクライアントでサポートされています。Script Lab is supported for Excel, Word, and PowerPoint on the following clients.

  • Office 2013 以降 (Windows)Office 2013 or later on Windows
  • Office 2016 以降の MacOffice 2016 or later on Mac
  • Web 上の OfficeOffice on the web

次のステップNext steps

Excel、Word、または PowerPoint でスクリプトラボを使用するには、AppSource からスクリプトラボアドインをインストールします。To use Script Lab in Excel, Word, or PowerPoint, install the Script Lab add-in from AppSource.

Office jsの GitHub リポジトリに新しいスニペットを投稿することによって、スクリプトラボのサンプルライブラリを拡張することをお歓迎します。You're welcome to expand the sample library in Script Lab by contributing new snippets to the office-js-snippets GitHub repository.

最初の Office アドインを作成する準備ができたら、 ExcelOutlookWordOneNotePowerPoint、またはProjectのクイックスタートをお試しください。When you're ready to create your first Office Add-in, try out the quick start for Excel, Outlook, Word, OneNote, PowerPoint, or Project.

関連項目See also