Изучение API JavaScript для Office с помощью сценария LabExplore Office JavaScript API using Script Lab

Надстройка " Лаборатория скриптов", доступная бесплатно из AppSource, позволяет изучать API JavaScript для Office при работе с программами Office, такими как Excel или Word.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 — удобное средство для добавления в набор средств разработки в качестве прототипа и проверки функциональных возможностей, которые должны быть в надстройке.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?

Script Lab — это средство для тех, кто хочет научиться разрабатывать надстройки Office с помощью API JavaScript для Office в Excel, Word или PowerPoint.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. С помощью сценария Lab вы можете получить доступ к библиотеке образцов, чтобы быстро испытать функции, или вы можете использовать пример в качестве отправной точки для собственного кода.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? Просмотрите этот видеоролик в виде одной минуты, чтобы увидеть Лаборатория сценариев в действии.Take a look at this one-minute video to see Script Lab in action.

![Предварительный просмотр видео, в котором показана Лаборатория скриптов, работающая в Excel, Word и PowerPoint.] (../images/screenshot-wide-youtube.png 'Видеоролик о предварительном просмотре в лаборатории сценариев')Preview video showing Script Lab running in Excel, Word, and PowerPoint.

Основные возможностиKey features

В разделе script Lab предусмотрен ряд функций, которые помогут вам изучить функциональные возможности API JavaScript для Office и прототипа надстройки.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

В дополнение к коду JavaScript или TypeScript, вызывающему API Office JS, каждый фрагмент также содержит HTML-разметку, определяющую содержимое области задач и CSS, определяющую внешний вид области задач.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 предварительного просмотра внутри фрагмента, вам потребуется обновить библиотеки фрагментов кода, чтобы использовать бета-версию CDNhttps://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 и у вас установлена сборка Office для участников.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.To save a snippet permanently, you can export it to a GitHub 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

Вы можете импортировать фрагмент в тестовый сценарий, указав URL-адрес общедоступного GitHub , в котором ХРАНИТСЯ фрагмент ямл, или ВСТАВИВ полный ямл для фрагмента.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 или предоставляя свой фрагмент кода ЯМЛ.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 или более поздней версии в WindowsOffice 2013 or later on Windows
  • Office 2016 или более поздней версии на компьютерах MacOffice 2016 or later on Mac
  • Office в ИнтернетеOffice 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.

Вы можете развернуть учебную библиотеку в лаборатории сценариев, дополнив новые фрагменты кода в репозиторий GitHub для Office – JS: Snippets .You're welcome to expand the sample library in Script Lab by contributing new snippets to the office-js-snippets GitHub repository.

Когда вы будете готовы создать свою первую надстройку Office, ознакомьтесь с кратким руководством для Excel, Outlook, Word, OneNote, PowerPointили 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