Изучение API JavaScript для Office с помощью Script Lab
Script Lab — это бесплатное средство для всех, кто сможет научиться разрабатывать надстройки Office. Script Lab позволяет кодировать и запускать API JavaScript для Office вместе с документом в Excel, Outlook, PowerPoint и Word. Используйте это удобное средство для создания прототипа и проверки нужных функций в собственной надстройке.
См. Script Lab в действии в этом поминутном видео на YouTube.
Что такое Script Lab?
Script Lab — это надстройка для создания прототипов надстроек. Он использует API JavaScript для Office в Excel, Outlook, Word и PowerPoint и размещается в области задач в документе, электронной таблице или электронной почте. Он имеет редактор кода с поддержкой IntelliSense, построенный на той же платформе, которая используется Visual Studio Code. С помощью Script Lab вы можете получить доступ к библиотеке примеров, чтобы быстро опробовать функции или использовать эти примеры в качестве отправной точки для собственного кода. Вы даже можете попробовать предстоящие API в Script Lab, которые по-прежнему находятся в предварительной версии для разработчиков.
Основные возможности
В 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 предварительной версии доступны только в том случае, если вы зарегистрировались в программе предварительной оценки Microsoft 365 и используете сборку Office для предварительной оценки.
Сохранение фрагментов кода и общий доступ к ним
Фрагменты кода, которые вы открываете в Script Lab, по умолчанию сохраняются в кэше браузера. Чтобы навсегда сохранить фрагмент кода, можно экспортировать его в gist GitHub. Можно создать секретный gist, чтобы сохранить фрагмент кода только для собственного использования, или создать общедоступный gist, если вы планируете поделиться этим фрагментом кода с другими пользователями.
Импорт фрагментов кода
Можно импортировать фрагмент кода в Script Lab, указав URL-адрес общедоступного gist GitHub, в котором хранится YAML этого фрагмента кода, или вставить полный код YAML этого фрагмента кода. Эта функция может оказаться полезной в случае, если кто-то другой поделился с вами своим фрагментом кода, опубликовав его в gist GitHub или предоставив YAML этого фрагмента кода.
Поддерживаемые клиенты
Script Lab поддерживается для Excel, Word и PowerPoint в следующих клиентах.
- Office в Windows*
- Office для Mac
- Office в Интернете
Приложение Script Lab для Outlook доступно в следующих клиентах.
Outlook в Windows*
Outlook для Mac
Outlook в Интернете при использовании браузеров Chrome, Microsoft EDGE или Safari
Примечание.
Начиная с версии 115 для браузеров на основе Chromium, таких как Chrome и Edge, выполняется тестирование секционирования хранилища, чтобы предотвратить отслеживание между сайтами по боковому каналу (см. также политики браузера Microsoft Edge). Это изменение предотвращает запуск фрагментов Script Lab в Outlook в Интернете. Чтобы обойти эту проблему, перейдите в раздел chrome://flags или edge://flags в браузере, а затем установите для флага Секционирование стороннего хранилища (#third-party-storage-partitioning) значение Отключено.
Подробнее см. в соответствующей записи блога.
Важно!
* Script Lab больше не работает с сочетаниями платформы и версии Office, которые используют веб-представление Trident (интернет-Обозреватель) для размещения надстроек. Сюда входят бессрочные версии Office до Office 2019. Дополнительные сведения см. в статье Браузеры и элементы управления webview, используемые надстройками Office.
Дальнейшие действия
После создания прототипа кода в Script Lab преобразуйте его в реальную надстройку, выполнив действия, описанные в разделе Создание автономной надстройки Office на основе кода Script Lab.
См. также
Office Add-ins
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе:Отправить и просмотреть отзыв по