Ссылки на библиотеку API JavaScript для Office

Библиотека API Office JavaScript предоставляет API, которые ваша надстройка может использовать для взаимодействия с Office приложением. Самый простой способ ссылки на библиотеку — использовать сеть доставки контента (CDN) путем добавления следующего тега в разделе <script> <head> вашей HTML-страницы.

<head>
    ...
    <script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script>
</head>

При первом загрузке надстройки и кэшировании Office API JavaScript, чтобы убедиться, что она использует самые последние реализации Office.js и связанных с ними файлов для указанной версии.

Важно!

Необходимо ссылаться на Office API JavaScript из раздела страницы, чтобы убедиться, что API полностью инициализирован перед <head> любыми элементами тела.

Версия API и обратная совместимость

В предыдущем фрагменте HTML перед URL-адресом CDN указывается последний дополнительный выпуск в версии /1/ office.js 1 Office.js. Поскольку API Office JavaScript поддерживает обратную совместимость, последний выпуск будет по-прежнему поддерживать членов API, которые были представлены ранее в версии 1. Если вам необходимо обновить существующий проект, см. в статью Обновление версии API javaScript Office JavaScript и файлы схемы манифеста.

Если вы планируете опубликовать свою надстройку Office из AppSource, необходимо использовать эту ссылку на сеть CDN. Локальные ссылки подходят только для внутренних сценариев, а также сценариев разработки и отладки.

Примечание

Чтобы использовать API предварительных версий, требуется указать ссылку на предварительную версию библиотеки API JavaScript для Office в сети CDN: https://appsforoffice.microsoft.com/lib/beta/hosted/office.js.

Включение IntelliSense для проекта TypeScript

В дополнение к ссылке на API Office JavaScript, как описано выше, вы также можете включить IntelliSense для проекта надстройки TypeScript с помощью определений типа из DefinitelyTyped. Для этого запустите следующую команду в системном запросе с поддержкой узла (или в окне баш git) из корневой папки проекта. У вас должен быть установлен Node.js (содержащий npm).

npm install --save-dev @types/office-js

Предварительные API

Новые API JavaScript сначала вводятся в "предварительную версию", а затем становятся частью определенного набора требований с номерами после достаточного тестирования и необходимости отзыва пользователей.

Примечание

API предварительной версии могут быть изменены и не предназначены для использования в рабочей среде. Рекомендуется использовать их только в тестовой среде и среде разработки. Не используйте API предварительной версии в рабочей среде или в важных деловых документах.

Чтобы использовать API предварительного просмотра:

Дополнительные материалы