Поделиться через

Навигация по страницам

  • Статья

При загрузке отчета Power BI в приложении можно использовать API клиента Power BI для перехода между страницами отчета. Например, можно задать страницу по умолчанию или динамически изменить страницу. Это позволяет создавать собственную настраиваемую навигацию по страницам, чтобы соответствовать бренду. Вы также можете автоматически изменять страницы на основе заданных условий для отображения определенных визуальных элементов и сведений пользователя.

Каждая страница отчета представлена объектом страницы . Чтобы вернуть все страницы отчета, вызовите метод getPages отчета, который возвращает страницы в виде коллекции объектов Page. Коллекция страниц возвращается в том же порядке, что и в отчете.

Класс Report определяет метод getPages следующим образом:

getPages(): Promise<Page[]>

Например:

let pages = await report.getPages();

Переход между страницами отчета

Используйте страницы и объекты отчета в приложении для перехода между страницами отчета, как показано в примерах кода в следующих разделах.

Настройка активной страницы

Используйте метод setPage объекта Report для создания существующей страницы активной страницы отчета.

Класс Report определяет метод setPage следующим образом:

setPage(pageName: string): Promise<void>

Например:

await report.setPage("page2");

Активная текущая страница

Используйте метод setActive объекта Page, чтобы убедиться, что страница всегда действительна для данного отчета. Чтобы получить объекты Page, вызовите getPages в объекте Report.

Класс page определяет метод следующим образом:

setActive(): Promise<void>

Например:

await page.setActive();

Добавление обработчика событий

При мониторинге навигации по страницам пользователя в отчете необходимо учитывать, когда пользователь изменяет страницы. Для этого добавьте обработчик событий для события pageChanged. Например:

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

Дополнительные сведения о событиях см. в разделе Обработка событий.

Связанное содержимое