다음을 통해 공유

사용자 지정 시각적 개체에서 키보드 탐색 지원

  • 아티클

이 문서에서는 키보드를 사용하여 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을 두 번 이상 눌러야 할 수 있습니다.

관련 콘텐츠