页面导航
在应用程序中加载 Power BI 报表时,可以使用 Power BI 客户端 API 在其报表页之间导航。 例如,可以设置默认页面或更改页面。 这样,就可以创建自己的自定义页面导航来匹配品牌。 还可以根据设置条件自动更改页面,以显示用户特定的视觉对象和信息。
报表中的每个页面都由 Page 对象表示。 若要返回报表中的所有页面,请调用报表 getPages
的方法,该方法将页面作为对象集合 Page
返回。 页面集合按报表中的顺序返回。
Report 类定义getPages
方法,如下所示:
getPages(): Promise<Page[]>
例如:
let pages = await report.getPages();
如何在报表页之间导航
使用应用程序中的 Page 和 Report 对象在报表页之间导航,如以下部分中的代码示例所示。
设置活动页
使用 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);
});
有关事件的详细信息,请参阅 如何处理事件。