埋め込みソリューションのアクセシビリティ
Power BI を使用する場合は、埋め込みレポートをさまざまな種類のユーザーが操作できるようにすることを検討してください。 レポートのアクセシビリティを高めるいくつかの簡単な方法は、title と tabindex 属性、キーボード ショートカット、ハイ コントラスト モードを使用することです。
タイトル属性と tabindex 属性を使用する方法
powerbi.embed または powerbi.bootstrap メソッドを呼び出すと、埋め込んだ型のコンポーネントが取得されます。
Title 属性
title 属性を使用すると、属する要素にテキストを追加できます。 スクリーン リーダーを使用しているユーザーは、その要素に関する追加情報を読み取ります。 埋め込みコンポーネントの title 属性を設定するには、setComponentTitleを使用します。
setComponentTitle(title: string): void
Title 属性の例
let component = powerbi.embed(…);
component.setComponentTitle(“Analytics report”);
title 属性の詳細については、MDN Web Docsタイトル 記事を参照してください。
Tabindex 属性
ユーザーはキーボードを使用して、埋め込みレポート内を移動できます。
setComponentTabIndex(tabIndex?: number): void
removeComponentTabIndex を使用して、tabindex 属性を削除できます。
removeComponentTabIndex(tabIndex?: number): void
Tabindex 属性の例
let component = powerbi.embed(...);
component.setComponentTabIndex(0);
tabindex 属性の詳細については、MDN Web Docstabindex 記事を参照してください。
埋め込み Power BI レポートのキーボード ショートカット
キーボードを使用して埋め込みレポートを調べるユーザーにとって、キーボード ショートカットの一覧は非常に重要なツールです。 キーボード ショートカットを表示する場合は、埋め込みレポートにフォーカスを合わせ、Shift
詳細については、「Power BI Desktopのキーボード ショートカットを
埋め込み Power BI レポートのハイ コントラスト モード
視覚障害や身体障害を持つユーザーが埋め込みレポートの恩恵を受けるのを助けるために、ハイ コントラスト テーマを使用するように設定できます。
ハイ コントラスト モードを設定するには、アプリケーションの埋め込み構成に 1 つのパラメーターを追加します。
let embedConfig = {
…
contrastMode: models.ContrastMode.HighContrast1
};
使用できるコントラスト モードは次のとおりです。
enum ContrastMode {
None = 0,
HighContrast1 = 1,
HighContrast2 = 2,
HighContrastBlack = 3,
HighContrastWhite = 4
}
既定値は None = 0です。
大事な
ハイ コントラスト モードとテーマの両方を指定した場合、Power BI ではハイ コントラスト モードのみが適用されます。 両方を同時に適用することはできません。
Power BI レポートのズーム レベルを調整する
埋め込みレポートの視覚障害または身体障害を持つユーザーを支援するために、レポートのズーム レベルを既定のレベルより高くまたは低く調整できます。
レポートのズーム レベルを設定するには、埋め込み設定に 1 つのパラメーターを追加するか、レポートの読み込み後に setZoom API を使用します。
ズーム レベルは、レポートの実際のサイズに基づいて計算されます。 レポート表示オプションの詳細については、「レポート ページの表示 を変更する」を参照してください。
let embedConfig = {
…
settings: {
zoomLevel: 2 // 200% zoom
}
};
現在のズーム レベルを取得したり、レポートの読み込み後に変更したりするには、getZoom API と setZoom API を使用できます。
let currentZoom = await report.getZoom();
await report.setZoom(0.5); // 50% zoom
手記
ズーム レベルは、0.25 (25%) ~ 4 (400%) の間である必要があります。
関連コンテンツ
- Power BI Desktop でのキーボード ショートカットの
- アクセシビリティ 用の Power BI レポートを設計する
- レポート設定の構成
- レポート テーマの適用