页面导航

在应用程序中加载 Power BI 报表时,可以使用 Power BI 客户端 API 在其报表页之间导航。 例如,可以设置默认页面或更改页面。 这样,就可以创建自己的自定义页面导航来匹配品牌。 还可以根据设置条件自动更改页面,以显示用户特定的视觉对象和信息。

报表中的每个页面都由 Page 对象表示。 若要返回报表中的所有页面,请调用报表 getPages 的方法,该方法将页面作为对象集合 Page 返回。 页面集合按报表中的顺序返回。

Report 类定义getPages方法,如下所示:

getPages(): Promise<Page[]>

例如:

let pages = await report.getPages();

如何在报表页之间导航

使用应用程序中的 PageReport 对象在报表页之间导航,如以下部分中的代码示例所示。

设置活动页

使用 setPage 对象的方法 Report 使现有页面成为报表的活动页。

Report 类定义setPage方法,如下所示:

setPage(pageName: string): Promise<void>

例如:

await report.setPage("page2");

使当前页处于活动状态

使用 setActive 对象的方法 Page 确保页面始终对给定报表有效。 若要获取 Page 对象,请调用 getPages 对象 Report

Page 类定义setActive方法,如下所示:

setActive(): Promise<void>

例如:

await page.setActive();

添加事件处理程序

在报表中监视用户的页面导航时,用户更改页面时需要注意。 为此,请为 pageChanged 事件添加事件处理程序。 例如:

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

有关事件的详细信息,请参阅 如何处理事件

后续步骤