(資料圖片僅供參考)

在運行自己的自定義邏輯之前，外接程序必須確保加載 DOM 和 Office 外接程序??運行時??環境。

啟動內容或任務窗格加載項

下圖顯示了在 Excel、PowerPoint、Project 或 Word 中啟動內容或任務窗格加載項所涉及的事件流。

當內容或任務窗格加載項啟動時，會發生以下事件。

用戶打開已包含加載項的文檔，或在文檔中插入加載項。Office 客戶端應用程序從 AppSource、SharePoint 上的應用程序目錄或其源自的共享文件夾目錄讀取加載項的 XML 清單。Office 客戶端應用程序在瀏覽器控件中打開加載項的 HTML 頁。后面的兩個步驟第 4 步和第 5 步以異步方式并行發生。 因此，您的加載項代碼必須在繼續之前確保 DOM 和加載項運行時環境已加載完。瀏覽器控件加載 DOM 和 HTML 正文，并調用事件的事件處理程序window.onload。Office 客戶端應用程序加載運行時環境，該環境從內容分發網絡 (CDN) 服務器下載和緩存 Office JavaScript API 庫文件，然后調用外接程序的事件處理程序作為Office對象的initialize事件（如果已分配給它）。 此時，它還會檢查是否有任何回調 (或鏈接then()的方法) 傳遞到處理程序 (或鏈接)Office.onReady。 有關 和Office.onReady之間的區別Office.initialize的詳細信息，請參閱初始化外接程序。當 DOM 和 HTML 正文加載完畢并且加載項完成初始化后，加載項的主函數就可以繼續進行。

啟動 Outlook 外接程序

下圖顯示了啟動在臺式機、平板電腦或智能手機上運行的 Outlook 外接程序所涉及的事件流。

Outlook 加載項啟動時會發生以下事件。

當 Outlook 啟動時，Outlook 讀取已為用戶的電子郵件帳戶安裝的 Outlook 外接程序的 XML 清單。用戶選擇 Outlook 中的一個項目。如果所選項目滿足某個 Outlook 外接程序的激活條件，則 Outlook 將激活該外接程序，并使其按鈕在 UI 中可見。如果用戶單擊該按鈕以啟動 Outlook 外接程序，Outlook 將在瀏覽器控件中打開 HTML 頁面。 下面兩個步驟（步驟 5 和 6）并行發生。瀏覽器控件加載 DOM 和 HTML 正文，并調用事件的事件處理程序onload。Outlook 加載運行時環境，這將從內容分發網絡 (CDN) 服務器中為 JavaScript 庫文件下載并緩存 JavaScript API，然后為Office加載項對象的initialize事件調用事件處理程序（如果已為其分配處理程序）。 此時，它還會檢查是否有任何回調 (或鏈接then()的方法) 傳遞到處理程序 (或鏈接)Office.onReady。 有關 和Office.onReady之間的區別Office.initialize的詳細信息，請參閱初始化外接程序。當 DOM 和 HTML 正文加載完畢并且加載項完成初始化后，加載項的主函數就可以繼續進行。