Загрузка DOM и среды выполнения

  • Статья

Перед запуском собственной пользовательской логики надстройка должна убедиться, что среда выполнения DOM и надстройки Office загружены.

Запуск контентной надстройки или надстройки области задач

На рисунке ниже приведен поток событий, происходящих при запуске контентной надстройки или надстройки области задач в Excel, PowerPoint, Project или Word.

Поток событий при запуске контентной надстройки или надстройки области задач.

При запуске контентной надстройки или надстройки области задач происходят следующие события.

  1. Пользователь открывает документ, который уже содержит надстройку, или вставляет надстройку в документ.

  2. Клиентское приложение Office считывает XML-манифест надстройки из AppSource, каталога приложений в SharePoint или каталога общих папок, из которого он исходит.

  3. Клиентское приложение Office открывает HTML-страницу надстройки в элементе управления webview.

    The next two steps, steps 4 and 5, occur asynchronously and in parallel. For this reason, your add-in's code must make sure that both the DOM and the add-in runtime environment have finished loading before proceeding.

  4. Элемент управления webview загружает DOM и текст HTML и вызывает обработчик событий для window.onload события.

  5. Клиентское приложение Office загружает среду выполнения, которая скачивает и кэширует файлы библиотеки API JavaScript для Office с сервера сети распространения содержимого (CDN), а затем вызывает обработчик событий надстройки для события инициализации объекта Office , если ему назначен обработчик. В настоящее время он также проверяет, были ли переданы (или цепочкиthen()) в обработчик какие-либо обратные вызовы (или связанные методы).Office.onReady Дополнительные сведения о различии между Office.initialize и Office.onReadyсм. в разделе Инициализация надстройки.

  6. После завершения загрузки DOM и основного текста HTML и инициализации надстройки запускается основная функция надстройки.

Запуск надстройки Outlook

На рисунке ниже приведен поток событий при запуске надстройки Outlook на настольном компьютере, планшетном ПК или смартфоне.

Поток событий при запуске надстройки Outlook.

При запуске надстройки Outlook происходят следующие события.

  1. При запуске Outlook считывает XML-манифесты надстроек Outlook, установленных для учетной записи пользователя.

  2. Пользователь выбирает элемент в Outlook.

  3. Если выбранный элемент удовлетворяет условиям активации надстройки Outlook, то Outlook активирует надстройку и делает соответствующую кнопку видимой в пользовательском интерфейсе.

  4. Если пользователь нажимает кнопку для запуска надстройки Outlook, Outlook открывает HTML-страницу в элементе управления webview. Следующие два шага, шаг 5 и шаг 6, выполняются одновременно.

  5. Элемент управления webview загружает DOM и текст HTML и вызывает обработчик событий для onload события.

  6. Outlook загружает среду выполнения, которая загружает и кэширует API JavaScript для файлов библиотеки JavaScript с сервера сети доставки содержимого, а затем вызывает обработчик события инициализации объекта Office надстройки, если ему назначен обработчик. В настоящее время он также проверяет, были ли переданы (или сцечены) какие-либо обратные вызовы (или связанные then() методы) обработчику Office.onReady . Дополнительные сведения о различии между Office.initialize и Office.onReadyсм. в разделе Инициализация надстройки.

  7. После завершения загрузки DOM и основного текста HTML и инициализации надстройки запускается основная функция надстройки.

См. также