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

Надстройки Script Lab и Script Lab для Outlook, которые можно бесплатно получить в AppSource, дают возможность изучать API JavaScript для Office при работе в приложениях Office, таких как Excel или Outlook. Script Lab — удобный инструмент, который пополнит ваш инструментарий разработки для прототипирования и проверки нужной функциональности собственных надстроек.

Что такое Script Lab?

Script Lab — это инструмент для всех, кто хочет научиться разрабатывать надстройки Office с помощью API JavaScript для Office в Excel, Outlook, Word и PowerPoint. Благодаря поддержке IntelliSense можно видеть доступные возможности. Этот инструмент построен на платформе Monaco, которая используется решением Visual Studio Code. С помощью Script Lab можно получить доступ к библиотеке примеров, чтобы быстро опробовать доступные функции. Также можно использовать пример в качестве отправной точки для разработки собственного кода. Можно даже использовать Script Lab для предварительного ознакомления с API.

Звучит неплохо? Посмотрите этот минутный видеоролик, чтобы увидеть Script Lab в действии.

Ознакомительное видео, демонстрирующее работу Script Lab в Excel, Word и PowerPoint.

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

В Script Lab доступен ряд функций, которые помогут изучить API JavaScript для Office и функциональность прототипов надстроек.

Изучите примеры

Встроенные примеры фрагментов кода, демонстрирующие выполнение задач с помощью API, помогут быстро начать работу. Можно запускать примеры, чтобы сразу видеть результат в области задач или документе, изучать примеры, чтобы понять принципы действия API, и даже использовать примеры для создания прототипов собственных надстроек.

Примеры.

Код и стиль

В дополнение к коду JavaScript или TypeScript, который вызывает API JS для Office, каждый фрагмент также содержит разметку HTML, определяющую содержимое области задач, и таблицы стилей CSS, определяющие внешний вид области задач. Можно настроить разметку HTML и CSS, чтобы поэкспериментировать с размещением и стилем элементов при создании прототипа дизайна панели задач для вашей собственной надстройки.

Совет

Чтобы вызвать API предварительной версии во фрагменте кода, потребуется обновить библиотеки фрагмента кода для использования бета-версии сети доставки содержимого (CDN) (https://appsforoffice.microsoft.com/lib/beta/hosted/office.js) и определений типов предварительной версии @types/office-js-preview. Кроме того, некоторые API предварительной версии доступны только при наличии регистрации в программе предварительной оценки Office и используете сборку Office, предназначенную для участников этой программы.

Сохранение фрагментов кода и общий доступ к ним

Фрагменты кода, которые вы открываете в Script Lab, по умолчанию сохраняются в кэше браузера. Чтобы навсегда сохранить фрагмент кода, можно экспортировать его в gist GitHub. Можно создать секретный gist, чтобы сохранить фрагмент кода только для собственного использования, или создать общедоступный gist, если вы планируете поделиться этим фрагментом кода с другими пользователями.

Возможности общего доступа.

Импорт фрагментов кода

Можно импортировать фрагмент кода в Script Lab, указав URL-адрес общедоступного gist GitHub, в котором хранится YAML этого фрагмента кода, или вставить полный код YAML этого фрагмента кода. Эта функция может оказаться полезной в случае, если кто-то другой поделился с вами своим фрагментом кода, опубликовав его в gist GitHub или предоставив YAML этого фрагмента кода.

Возможность импорта фрагментов кода.

Поддерживаемые клиенты

Script Lab поддерживается для Excel, Word и PowerPoint в следующих клиентах.

  • Подписка на Microsoft 365 Office
  • Office 2016 или более поздней версии для Mac
  • Office в Интернете

Приложение Script Lab для Outlook доступно в следующих клиентах.

  • Подписка на Microsoft 365 Office
  • Outlook 2016 или более поздней версии для Mac
  • Outlook в Интернете при использовании браузеров Chrome, Microsoft EDGE или Safari

Подробнее см. в соответствующей записи блога.

Важно!

Script Lab больше не работает в сочетаниях платформ и версий Office, где для размещения надстроек используется Internet Explorer. К ним относятся единовременно приобретенные версии Office до Office 2019. Дополнительные сведения см. в статье Браузеры, используемые надстройками Office.

Дальнейшие действия

Чтобы использовать Script Lab в Excel, Word или PowerPoint, установите надстройку Script Lab из AppSource.

Чтобы использовать Script Lab для Outlook, установите надстройку Script Lab для Outlook из AppSource.

Вы можете пополнить библиотеку примеров в Script Lab, добавив новые фрагменты кода в репозиторий GitHub office-js-snippets.

Когда вы будете готовы приступить к созданию своей первой надстройки Office, ознакомьтесь с кратким руководством для Excel, Outlook, Word, OneNote, PowerPoint или Project.

См. также