次の方法で共有


埋め込みソリューションのアクセシビリティ

Power BI を使用する場合は、埋め込みレポートをさまざまな種類のユーザーが操作できるようにすることを検討してください。 レポートのアクセシビリティを高めるいくつかの簡単な方法は、titletabindex 属性、キーボード ショートカット、ハイ コントラスト モードを使用することです。

タイトル属性と 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 属性

ユーザーはキーボードを使用して、埋め込みレポート内を移動できます。 属性を使用すると、タブ付きフォーカスをレポート内の要素に追加できます。それ以外の場合は、ユーザーが Tab押したときにスキップされます。埋め込みコンポーネントの 属性を設定するには、を使用します。

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%) の間である必要があります。