共用方式為

頁面導覽

  • 發行項

當您在應用程式中載入 Power BI 報表時，您可以使用 Power BI 用戶端 API 在其報表頁面之間巡覽。 例如，您可以設定預設頁面，或動態變更頁面。 這樣做可讓您建立自己的自定義頁面導覽，以符合您的品牌。 您也可以根據設定準則自動變更頁面，以顯示使用者特定的視覺效果和資訊。

報表中的每個頁面都會以 Page 對象來表示。 若要傳回報表中的所有頁面，請呼叫報表的 getPages 方法，此方法會將頁面當做 Page 物件的集合傳回。 頁面的集合會以與報表中的相同順序傳回。

Report 類別會定義 getPages 方法，如下所示：

getPages(): Promise<Page[]>

例如：

let pages = await report.getPages();

如何在報表頁面之間巡覽

使用應用程式中的 Page 和 Report 物件，在報表頁面之間巡覽，如下列各節的程式代碼範例所示。

設定使用中頁面

使用 Report 物件的 setPage 方法，將現有頁面設為報表的使用中頁面。

Report 類別會定義 setPage 方法，如下所示：

setPage(pageName: string): Promise<void>

例如：

await report.setPage("page2");

讓目前的頁面成為使用中

使用 Page 物件的 setActive 方法，以確保頁面對指定的報表一律有效。 若要取得 Page 物件，請在 Report 物件上呼叫 getPages。

Page 類別會定義 setActive 方法，如下所示：

setActive(): Promise<void>

例如：

await page.setActive();

新增事件處理程式

當您在報表中監視使用者的頁面流覽時，您必須在使用者變更頁面時注意。 若要這樣做，請新增 pageChanged 事件的事件處理程式。 例如：

report.on('pageChanged', event => {
    const page = event.detail.newPage;
    console.log(page.name);
});

如需事件的詳細資訊，請參閱 如何處理事件。

相關內容