通过

页面导航

  • 项目

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

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

Report 类定义 getPages 方法，如下所示：

getPages(): Promise<Page[]>

例如：

let pages = await report.getPages();

如何在报表页之间导航

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

设置活动页

使用 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);
});

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

相关内容