次の方法で共有


カスタム視覚エフェクトでキーボード ナビゲーションをサポートする

この記事では、キーボードを使って 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] キーを複数回押す必要がある場合があります。