Compartir a través de

Navegación por páginas

  • Artículo

Al cargar un informe de Power BI en una aplicación, puede usar las API de cliente de Power BI para navegar entre sus páginas de informe. Por ejemplo, puede establecer la página predeterminada o cambiar una página dinámicamente. Si lo hace, puede crear su propia navegación de página personalizada para que coincida con su marca. También puede cambiar automáticamente las páginas en función de un criterio establecido para mostrar a un usuario determinados objetos visuales e información.

Cada página de un informe se representa mediante un objeto Page. Para devolver todas las páginas de un informe, llame al método getPages del informe, que devuelve las páginas como una colección de objetos Page. La colección de páginas se devuelve en el mismo orden que en el informe.

La clase Report define el método de la siguiente manera:

getPages(): Promise<Page[]>

Por ejemplo:

let pages = await report.getPages();

Cómo navegar entre páginas de informe

Use los objetos Page y Report de la aplicación para navegar entre páginas de informe, como se muestra en los ejemplos de código de las secciones siguientes.

Establecer la página activa

Use el método setPage de un objeto Report para convertir una página existente en la página activa de un informe.

La clase Report define el método de la siguiente manera:

setPage(pageName: string): Promise<void>

Por ejemplo:

await report.setPage("page2");

Activar la página actual

Use el método setActive de un objeto Page para asegurarse de que la página siempre es válida para un informe determinado. Para obtener Page objetos, llame a getPages en un objeto Report.

La clase Page define el método de la siguiente manera:

setActive(): Promise<void>

Por ejemplo:

await page.setActive();

Adición de un controlador de eventos

Al supervisar la navegación de páginas de un usuario en un informe, debe tener en cuenta cuándo cambia una página. Para ello, agregue un controlador de eventos para el evento pageChanged. Por ejemplo:

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

Para obtener más información sobre los eventos, vea Cómo controlar eventos.

Contenido relacionado