在 Power BI Embedded 中分階段載入內嵌內容

在 2018年3月15日 上貼文

 

您可以透過包含內嵌設定物件的 embed 呼叫,以及包含 iframe<div> 項目,在 Power BI Embedded 中載入內嵌成品。呼叫內嵌物件之後,它會在使用者之前載入。

為了改善使用者體驗並提供更多工具給開發人員,我們已透過更多 JavaScript 呼叫將階段新增至內嵌程序來擴充此流程:

  1. 預先載入powerbi.preload() 呼叫會先使用瀏覽器的快取並下載指令碼,再顯示內嵌物件本身。這對裝載數個內嵌報表的應用程式而言可能很有用。預先載入完成後會觸發就緒事件。
  2. 載入中繼資料powerbi.load() 呼叫可協助擷取內嵌物件的相關資訊,並在背景動態變更設定或 <div> 項目,再向使用者顯示物件。例如,您可以使用此函式來取得頁面,然後決定要向使用者顯示的頁面。或者,您可以使用取得視覺效果,然後決定您要顯示或隱藏的視覺效果。如果您使用此函式,則需要呼叫 render() 函式來顯示內嵌物件。 載入完成後會觸發已載入事件。
  3. 轉譯物件。如果您實作 powerbi.load() 函式,則最後一個呼叫是 render()。它會完成轉譯及向使用者顯示內嵌物件所需的最後一個動作。轉譯完成後會觸發已轉譯事件。

雖然 loadrender 函式必須搭配使用,但 preload 則獨立於這些函式。您可以在預先載入之後,使用 embed 函式來顯示內嵌物件。 您也可以分別呼叫 preloadloadrender,來使用完整的階段程序。

Related feedback