Bagikan melalui

Navigasi halaman

  • Artikel

Saat Memuat laporan Power BI dalam aplikasi, Anda bisa menggunakan API Klien Power BI untuk menavigasi di antara halaman laporannya. Misalnya, Anda dapat mengatur halaman default atau mengubah halaman secara dinamis. Melakukannya memungkinkan Anda membuat navigasi halaman kustom Anda sendiri agar sesuai dengan merek Anda. Anda juga dapat mengubah halaman secara otomatis berdasarkan kriteria yang ditetapkan untuk menampilkan visual dan informasi tertentu kepada pengguna.

Setiap halaman dalam laporan diwakili oleh objek Halaman . Untuk mengembalikan semua halaman dalam laporan, panggil metode getPages laporan, yang mengembalikan halaman sebagai kumpulan objek Page. Kumpulan halaman dikembalikan dalam urutan yang sama seperti dalam laporan.

Kelas Laporan menentukan metode sebagai berikut:

getPages(): Promise<Page[]>

Misalnya:

let pages = await report.getPages();

Cara menavigasi antar halaman laporan

Gunakan Halaman dan objek Laporan di aplikasi Anda untuk menavigasi antar halaman laporan, seperti yang ditunjukkan oleh contoh kode di bagian berikut.

Mengatur halaman aktif

Gunakan metode setPage objek Report untuk membuat halaman yang sudah ada menjadi halaman aktif laporan.

Kelas Laporan menentukan metode sebagai berikut:

setPage(pageName: string): Promise<void>

Misalnya:

await report.setPage("page2");

Aktifkan halaman saat ini

Gunakan metode setActive objek Page untuk memastikan halaman selalu valid untuk laporan tertentu. Untuk mendapatkan objek Page, panggil getPages pada objek Report.

Kelas Halaman menentukan metode sebagai berikut:

setActive(): Promise<void>

Misalnya:

await page.setActive();

Menambahkan penanganan aktivitas

Saat Memantau navigasi halaman pengguna dalam laporan, Anda perlu mengetahui kapan pengguna mengubah halaman. Untuk melakukannya, tambahkan penanganan aktivitas untuk peristiwa pageChanged. Misalnya:

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

Untuk informasi selengkapnya tentang peristiwa, lihat Cara menangani peristiwa.

Konten terkait