Sdílet prostřednictvím

Navigace na stránce

  • Článek

Při načítání sestavy Power BI v aplikaci můžete pomocí klientských rozhraní API Power BI přecházet mezi stránkami sestavy. Můžete například nastavit výchozí stránku nebo stránku dynamicky změnit. Díky tomu můžete vytvořit vlastní navigaci na stránce tak, aby odpovídala vaší značce. Můžete také automaticky změnit stránky na základě nastavených kritérií, aby se zobrazily určité vizuály a informace uživatele.

Každá stránka v sestavě je reprezentována objektem Page. Pokud chcete vrátit všechny stránky v sestavě, zavolejte metodu getPages sestavy, která vrátí stránky jako kolekci Page objektů. Kolekce stránek se vrátí ve stejném pořadí jako v sestavě.

Třída sestavy definuje metodu následujícím způsobem:

getPages(): Promise<Page[]>

Například:

let pages = await report.getPages();

Navigace mezi stránkami sestavy

Pomocí stránky a sestavy objekty v aplikaci můžete přecházet mezi stránkami sestavy, jak je znázorněno příklady kódu v následujících částech.

Nastavení aktivní stránky

Pomocí setPage metody objektu Report vytvořte existující stránku aktivní stránkou sestavy.

Třída sestavy definuje metodu následujícím způsobem:

setPage(pageName: string): Promise<void>

Například:

await report.setPage("page2");

Nastavení aktivní aktuální stránky

Pomocí setActive metody objektu Page zajistěte, aby stránka byla vždy platná pro danou sestavu. Pokud chcete získat Page objekty, zavolejte getPages objektu Report.

Třída Page definuje metodu setActive následujícím způsobem:

setActive(): Promise<void>

Například:

await page.setActive();

Přidání obslužné rutiny události

Když v sestavě monitorujete navigaci na stránce uživatele, musíte vědět, kdy uživatel změní stránky. Uděláte to tak, že přidáte obslužnou rutinu události pro pageChanged událost. Například:

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

Další informace o událostech naleznete v tématu Zpracování událostí.

Související obsah