Teilen über


Unterstützen der Tastaturnavigation in einem benutzerdefinierten visuellen Element

In diesem Artikel wird erläutert, wie Sie die Navigation durch ein visuelles Power BI-Element mithilfe der Tastatur unterstützen. Die Tastaturnavigation macht Power BI für Personen mit Behinderungen barrierefreier und bietet mehr Optionen für die Interaktion mit Berichten.

Durch das Feature supportsKeyboardFocus ist es möglich, mit der Tastatur durch die Datenpunkte des Visuals zu navigieren.

Grundlegende Barrierefreiheitsfeatures mit der Tastatur

Alle visuellen Elemente bieten die folgenden grundlegenden Bedienungshilfen über die Tastatur:

  • Drücken Sie ESC, um den Fokus von innerhalb des visuellen Elements auf den Container des visuellen Elements zu verschieben.
  • Drücken Sie in einem benutzerdefinierten visuellen Element TAB, um durch Elemente in dem visuellen Element zu navigieren, die mit Tabstopps angezeigt werden können. Durch das Drücken von TAB nach dem letzten dieser Elemente wird der Fokus wieder nach außerhalb des visuellen Elements verschoben.

Verbesserte Barrierefreiheit über die Tastatur

Um Ihr benutzerdefiniertes visuelles Element noch barrierefreier zu machen, fügen Sie ihm die Funktion supportsKeyboardFocus hinzu, indem Sie der Datei „capabilities.json“ die folgende Zeile hinzufügen:

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

Diese Funktion fügt Ihrem benutzerdefinierten visuellen Element die folgenden Features hinzu:

  • Drücken Sie EINGABE, wenn sich der Fokus auf dem Container des visuellen Elements befindet, um den Fokus in das benutzerdefinierte visuelle Element zu verschieben.
  • Drücken Sie in dem benutzerdefinierten visuellen Element TAB, um durch Elemente zu navigieren, die mit Tabstopps angezeigt werden können. Der Fokus bleibt innerhalb des visuellen Elements, bis Sie ESC drücken.

Hinweis

Nicht alle HTML-Elemente können standardmäßig mit Tabstopps angezeigt werden (z. B. „div“ und „span“). Sie könnten das richtige Attribut (z. B. „tabindex“) zu diesen Elementen hinzufügen, damit sie mit Tabstopps angezeigt werden können.

Überlegungen und Einschränkungen

  • Diese Feature erfordert mindestens die API-Version 2.1.0.

  • Dieses Feature kann auf Bildvisuals nicht angewendet werden.

  • Durch Drücken der EINGABETASTE im visuellen Container wird nicht immer das erste fokussierbare Element des Visuals angezeigt. Um sicherzustellen, dass Sie beim ersten Element beginnen, fokussieren Sie es programmgesteuert, nachdem der Fokus in das Visual gelangt ist.

  • Nach dem Drücken der EINGABETASTE im visuellen Container und nach dem Drücken von TAB für das letzte fokussierbare Element müssen Sie möglicherweise mehrmals TAB drücken, um zum ersten Element zu gelangen.