Sdílet prostřednictvím

Přístupnost pro vložené řešení

  • Článek

Při práci s Power BI zvažte zpřístupnění vložených sestav různým typům uživatelů, kteří s nimi můžou pracovat. Několik snadných způsobů, jak sestavy zpřístupnit, je použít title a tabindex atributy, klávesové zkratky a režim vysokého kontrastu.

Jak používat atributy title a tabindex

Po volání powerbi.embed nebo metody powerbi.bootstrap získáte komponentu typu, který jste vloženého.

Atribut nadpisu

Atribut title umožňuje přidat text do prvku, do něhož patří. Pokud někdo používá čtečku obrazovky, přečte další informace o prvku pro něj. Chcete-li nastavit atribut title součásti pro vložení, použijte setComponentTitle.

setComponentTitle(title: string): void

Příklad atributu nadpisu

let component = powerbi.embed(…);
component.setComponentTitle(“Analytics report”);

Další informace o atributu najdete v článkuweb docs MDN.

Atribut Tabindex

Uživatelé můžou pomocí klávesnice procházet vložené sestavy. Pomocí atributu tabindex můžete přidat fokus na záložky do prvků v sestavě, které by jinak byly vynechány, když uživatel stiskne tab. Chcete-li nastavit tabindex atribut součásti pro vložení, použijte setComponentTabIndex.

setComponentTabIndex(tabIndex?: number): void

Atribut tabindex můžete odebrat pomocí removeComponentTabIndex

removeComponentTabIndex(tabIndex?: number): void

Příklad atributu Tabindex

let component = powerbi.embed(...);
component.setComponentTabIndex(0);

Další informace o atributu tabindex najdete v článku MDN Web Docstabindex.

Klávesové zkratky ve vložených sestavách Power BI

Pro lidi, kteří používají své klávesnice k prozkoumání vložených sestav, je seznam klávesových zkratek neocenitelným nástrojem. Pokud chcete zobrazit klávesové zkratky, zaměřte se na vloženou sestavu a stiskněte Shift+?.

Další informace najdete v tématu Klávesové zkratky v Power BI Desktopu.

Režim vysokého kontrastu ve vložených sestavách Power BI

Abyste uživatelům s vadami zraku nebo fyzického postižení pomohli využívat vložené sestavy, můžete je nastavit tak, aby používali motiv s vysokým kontrastem.

Režim vysokého kontrastu můžete nastavit přidáním jednoho parametru do konfigurace vložení aplikace.

let embedConfig = {
    …
    contrastMode: models.ContrastMode.HighContrast1
};

Dostupné režimy kontrastu jsou:

enum ContrastMode {
    None = 0,
    HighContrast1 = 1,
    HighContrast2 = 2,
    HighContrastBlack = 3,
    HighContrastWhite = 4
}

Výchozí hodnota je None = 0.

Důležitý

Pokud zadáte režim vysokého kontrastu i motiv, Power BI použije režim vysokého kontrastu. Nemůže použít oba současně.

Úprava úrovně přiblížení pro sestavy Power BI

Abyste uživatelům s vadami zraku nebo fyzického postižení pomohli využívat vložené sestavy, můžete upravit úroveň přiblížení sestavy tak, aby byla vyšší nebo nižší než výchozí úroveň.

Úroveň přiblížení sestavy můžete nastavit přidáním jednoho parametru do nastavení pro vložení nebo použitím rozhraní API setZoom po načtení sestavy.

Úroveň přiblížení se vypočítá na základě skutečné velikosti sestavy. Další informace o možnostech zobrazení sestavy najdete v tématu Změna zobrazení stránky sestavy.

let embedConfig = {
    …
    settings: {
        zoomLevel: 2 // 200% zoom
    }
};

Pokud chcete získat aktuální úroveň přiblížení nebo ji změnit po načtení sestavy, můžete použít getZoom a setZoom rozhraní API.

let currentZoom = await report.getZoom();
await report.setZoom(0.5); // 50% zoom

Poznámka

Úroveň přiblížení musí být v rozmezí od 0,25 (25%) do čtyř (400%).

Související obsah