カスタム視覚エフェクトでキーボード ナビゲーションをサポートする
この記事では、キーボードを使って Power BI 視覚エフェクトのナビゲーションをサポートする方法について説明します。 キーボード ナビゲーションによって、障碍のあるユーザーは Power BI を使いやすくなり、レポートを操作するオプションが増えます。
supportsKeyboardFocus 機能を使うと、キーボードのみを使用して視覚化のデータ ポイント間を移動できます。
基本的なキーボード アクセシビリティ機能
すべての視覚エフェクトは、次の基本的なキーボード アクセシビリティを備えています。
- Esc キーを押すと、視覚エフェクト内から視覚エフェクト コンテナーにフォーカスが移動します。
- カスタム視覚エフェクト内から Tab キーを押すと、視覚エフェクト内のタブ移動可能な要素間でフォーカスが移動します。 最後のタブ移動可能な要素の後に Tab キーを押すと、フォーカスは視覚エフェクトの外に戻ります。
強化されたキーボード アクセシビリティ
カスタム視覚エフェクトのアクセシビリティをさらに高めるには、"capabilities.json" ファイルに以下の行を追加して視覚エフェクトに supportsKeyboardFocus 機能を追加します。
{
...
"supportsKeyboardFocus": true
...
}
この機能により、カスタム視覚エフェクトに次の機能が追加されます。
- 視覚エフェクト コンテナーにフォーカスがあるときに Enter キーを押すと、カスタム視覚エフェクト内にフォーカスが移動します。
- カスタム視覚エフェクト内から Tab キーを押すと、タブ移動可能な要素間でフォーカスが移動します。 Esc キーを押すまで、フォーカスは視覚エフェクト内に留まります。
注意
既定でタブ移動可能ではない HTML 要素もあります (div、span など)。 このような要素には正しい属性 (tabindex など) を追加してタブ移動可能にすることを検討してください。
考慮事項と制限事項
この機能には、API v2.1.0 以上が必要です。
この機能を画像ビジュアルに適用することはできません。
ビジュアル コンテナーで [Enter] キーを押しても、常にビジュアルの最初のフォーカス可能な要素に移動するとは限りません。 最初の要素から始めるようにするには、フォーカスがビジュアルに入った後にプログラムでフォーカスします。
ビジュアル コンテナーで [Enter] キーを押し、最後にフォーカス可能な要素で [Tab] キー を押した後、ユーザーが最初の要素に到達するには [Tab] キーを複数回押す必要がある場合があります。