支持自定义视觉对象中的键盘导航
本文介绍如何支持使用键盘导航 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 才能到达第一个元素。