在 Power BI Embedded 中分階段載入內嵌內容
發佈日期： 三月 15, 2018
您可以透過包含內嵌設定物件的 embed 呼叫，以及包含 iframe 的 <div> 項目，在 Power BI Embedded 中載入內嵌成品。呼叫內嵌物件之後，它會在使用者之前載入。
為了改善使用者體驗並提供更多工具給開發人員，我們已透過更多 JavaScript 呼叫將階段新增至內嵌程序來擴充此流程：
- 預先載入。powerbi.preload() 呼叫會先使用瀏覽器的快取並下載指令碼，再顯示內嵌物件本身。這對裝載數個內嵌報表的應用程式而言可能很有用。預先載入完成後會觸發就緒事件。
- 載入中繼資料。powerbi.load() 呼叫可協助擷取內嵌物件的相關資訊，並在背景動態變更設定或 <div> 項目，再向使用者顯示物件。例如，您可以使用此函式來取得頁面，然後決定要向使用者顯示的頁面。或者，您可以使用取得視覺效果，然後決定您要顯示或隱藏的視覺效果。如果您使用此函式，則需要呼叫 render() 函式來顯示內嵌物件。 載入完成後會觸發已載入事件。
- 轉譯物件。如果您實作 powerbi.load() 函式，則最後一個呼叫是 render()。它會完成轉譯及向使用者顯示內嵌物件所需的最後一個動作。轉譯完成後會觸發已轉譯事件。
雖然 load 和 render 函式必須搭配使用，但 preload 則獨立於這些函式。您可以在預先載入之後，使用 embed 函式來顯示內嵌物件。 您也可以分別呼叫 preload、load 和 render，來使用完整的階段程序。