Seitennavigation
Wenn Sie einen Power BI-Bericht in einer Anwendung laden, können Sie die Power BI-Client-APIs verwenden, um zwischen den Berichtsseiten zu navigieren. Sie können beispielsweise die Standardseite festlegen oder eine Seite dynamisch ändern. Auf diese Weise können Sie ihre eigene benutzerdefinierte Seitennavigation erstellen, um Ihrer Marke zu entsprechen. Sie können seiten auch basierend auf einem festgelegten Kriterium automatisch ändern, um einem Benutzer bestimmte Visuelle und Informationen anzuzeigen.
Jede Seite in einem Bericht wird durch ein Page-Objekt dargestellt. Um alle Seiten in einem Bericht zurückzugeben, rufen Sie die Methode des getPages Berichts auf, die die Seiten als Auflistung von Page Objekten zurückgibt. Die Sammlung von Seiten wird in derselben Reihenfolge wie im Bericht zurückgegeben.
Die Report-Klasse definiert die getPages Methode wie folgt:
getPages(): Promise<Page[]>
Beispiel:
let pages = await report.getPages();
So navigieren Sie zwischen Berichtsseiten
Verwenden Sie die Seiten- und Berichtsobjekte in Ihrer Anwendung, um zwischen Berichtsseiten zu navigieren, wie in den Codebeispielen in den folgenden Abschnitten gezeigt.
Festlegen der aktiven Seite
Verwenden Sie die setPage Methode eines Report Objekts, um eine vorhandene Seite zur aktiven Seite eines Berichts zu machen.
Die Report-Klasse definiert die setPage Methode wie folgt:
setPage(pageName: string): Promise<void>
Beispiel:
await report.setPage("page2");
Die aktuelle Seite aktiv machen
Verwenden Sie die setActive Methode eines Page Objekts, um sicherzustellen, dass die Seite für einen bestimmten Bericht immer gültig ist. Rufen Sie zum Abrufen Page von Objekten ein Report Objekt aufgetPages.
Die Page-Klasse definiert die setActive Methode wie folgt:
setActive(): Promise<void>
Beispiel:
await page.setActive();
Hinzufügen eines Ereignishandlers
Wenn Sie die Seitennavigation eines Benutzers in einem Bericht überwachen, müssen Sie sich bewusst sein, wenn ein Benutzer Seiten ändert. Fügen Sie dazu einen Ereignishandler für das pageChanged Ereignis hinzu. Beispiel:
report.on('pageChanged', event => {
const page = event.detail.newPage;
console.log(page.name);
});
Weitere Informationen zu Ereignissen finden Sie unter Behandeln von Ereignissen.