支持自定义视觉对象中的键盘导航

本文介绍如何支持使用键盘导航 Power BI 视觉对象。 键盘导航使 Power BI 更易于残障人士访问,并提供更多与报表交互的选项。

supportsKeyboardFocus 功能允许仅使用键盘浏览视觉对象的数据点。

基本键盘辅助功能

所有视觉对象都具有以下基本键盘辅助功能:

  • Esc 键将焦点从视觉对象内部移动到视觉对象容器。
  • Tab 键在自定义视觉对象内部浏览视觉对象中可通过 Tab 键访问的元素。 在最后一个可通过 Tab 键访问的元素后按 Tab 会将焦点移回到视觉对象之外。

增强的键盘辅助功能

若要使自定义视觉对象更易于访问,请将以下行添加到“capabilities.json”文件,以将 supportsKeyboardFocus 功能添加到视觉对象:

    {   
        ...
        "supportsKeyboardFocus": true
        ...
    }

此功能将以下功能添加到自定义视觉对象:

  • 当焦点位于视觉对象容器上时,按 Enter 将焦点移动到自定义视觉对象内部。
  • Tab 键在自定义视觉对象内部浏览可通过 Tab 键访问的元素。 焦点一直保留在视觉对象内,直到按下 Esc

注意

默认情况下,并非所有 HTML 元素都可以通过 Tab 访问(例如 div 和 span)。 请考虑向这些元素添加正确的属性(例如 tabindex),使其可通过 Tab 键访问。

注意事项和限制

  • 此功能需要 API v2.1.0 或更高版本。

  • 此功能不适用于图像视觉对象。

  • 在视觉对象容器上按 Enter 并不总是会停留在视觉对象的第一个可聚焦元素上。 要确保从第一个元素开始,请在焦点进入视觉对象后以编程方式将其聚焦。

  • 在视觉对象容器上按 Enter 并在最后一个可聚焦元素上按 Tab 后,用户可能需要多次按 Tab 才能到达第一个元素。