Udostępnij za pośrednictwem

Obsługa nawigacji za pomocą klawiatury w wizualizacji niestandardowej

  • Artykuł

W tym artykule wyjaśniono, jak obsługiwać nawigację za pośrednictwem wizualizacji usługi Power BI przy użyciu klawiatury. Nawigacja za pomocą klawiatury sprawia, że usługa Power BI jest bardziej dostępna dla osób niepełnosprawnych i udostępnia więcej opcji interakcji z raportami.

Funkcja supportsKeyboardFocus umożliwia nawigowanie po punktach danych wizualizacji przy użyciu tylko klawiatury.

Podstawowe funkcje ułatwień dostępu klawiatury

Wszystkie wizualizacje mają następujące podstawowe ułatwienia dostępu do klawiatury:

  • Naciśnij klawisz Esc , aby przenieść fokus z wewnątrz wizualizacji do kontenera wizualizacji.
  • Naciśnij klawisz Tab wewnątrz wizualizacji niestandardowej, aby nawigować po elementach z możliwością tabulacji w wizualizacji. Naciśnięcie klawisza Tab po ostatnim elembacie tababble przenosi fokus z powrotem poza wizualizację.

Ulepszone ułatwienia dostępu klawiatury

Aby zwiększyć dostępność wizualizacji niestandardowej, dodaj supportsKeyboardFocus możliwość do wizualizacji, dodając następujący wiersz do pliku "capabilities.json":

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

Ta funkcja dodaje następujące funkcje do wizualizacji niestandardowej:

  • Naciśnij klawisz Enter, gdy fokus znajduje się na kontenerze wizualizacji, aby przenieść fokus do wewnątrz wizualizacji niestandardowej.
  • Naciśnij klawisz Tab wewnątrz wizualizacji niestandardowej, aby przejść przez elementy z możliwością tabulacji. Fokus pozostaje w wizualizacji do momentu naciśnięcia klawisza Esc.

Uwaga

Nie wszystkie elementy HTML są domyślnie tabulatorami (na przykład div i span). Rozważ dodanie odpowiedniego atrybutu (np. tabindex) do tych elementów, aby uczynić je tabulatorami.

Rozważania i ograniczenia

  • Ta funkcja wymaga interfejsu API w wersji 2.1.0 lub nowszej.

  • Tej funkcji nie można zastosować do wizualizacji obrazów.

  • Naciśnięcie klawisza Enter w kontenerze wizualizacji nie zawsze będzie znajdować się w pierwszym elemercie, który można skupić na wizualizacji. Aby zacząć od pierwszego elementu, skoncentruj ją programowo po przejściu fokusu do wizualizacji.

  • Po naciśnięciu klawisza Enter w kontenerze wizualizacji i naciśnięciu klawisza Tab na ostatnim elemercie z możliwością koncentracji uwagi użytkownik może mieć możliwość naciśnięcia klawisza Tab więcej niż raz, aby przejść do pierwszego elementu.

Powiązana zawartość