Udostępnij za pośrednictwem

Nawigacja po stronie

Podczas ładowania raportu usługi Power BI w aplikacji można używać interfejsów API klienta usługi Power BI do nawigowania między stronami raportu. Można na przykład ustawić stronę domyślną lub dynamicznie zmienić stronę. Dzięki temu można utworzyć własną nawigację na stronie niestandardowej w celu dopasowania jej do marki. Możesz również automatycznie zmieniać strony na podstawie ustawionych kryteriów, aby wyświetlić użytkownikowi określone wizualizacje i informacje.

Każda strona w raporcie jest reprezentowana przez obiekt Page. Aby zwrócić wszystkie strony w raporcie, wywołaj metodę getPages raportu, która zwraca strony jako kolekcję obiektów Page. Kolekcja stron jest zwracana w tej samej kolejności co w raporcie.

Klasa raportu definiuje metodę w następujący sposób:

getPages(): Promise<Page[]>

Na przykład:

let pages = await report.getPages();

Jak nawigować między stronami raportu

Użyj obiektów Page i Report w aplikacji, aby nawigować między stronami raportu, jak pokazano w przykładach kodu w poniższych sekcjach.

Ustawianie aktywnej strony

Użyj metody setPage obiektu Report, aby utworzyć istniejącą stronę jako aktywną stronę raportu.

Klasa raportu definiuje metodę w następujący sposób:

setPage(pageName: string): Promise<void>

Na przykład:

await report.setPage("page2");

Uaktywnij bieżącą stronę

Użyj metody setActive obiektu Page, aby upewnić się, że strona jest zawsze prawidłowa dla danego raportu. Aby uzyskać obiekty Page, wywołaj metodę getPages w obiekcie Report.

Klasa Page definiuje metodę w następujący sposób:

setActive(): Promise<void>

Na przykład:

await page.setActive();

Dodawanie programu obsługi zdarzeń

Podczas monitorowania nawigacji na stronie użytkownika w raporcie należy pamiętać, kiedy użytkownik zmienia strony. W tym celu dodaj program obsługi zdarzeń dla zdarzenia pageChanged. Na przykład:

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

Aby uzyskać więcej informacji na temat zdarzeń, zobacz Jak obsługiwać zdarzenia.

Powiązana zawartość