Prüfen und Fehler beheben

Prüfen

Es gibt mehrere Tools, mit denen Sie Ihre Inhalte schnell im Hinblick auf Barrierefreiheit prüfen können:

  • Android für Barrierefreiheit: Enthält das Menü „Bedienungshilfen“, die Funktion „Vorlesen“, den Schalterzugriff und TalkBack. Diese Funktionen geben Aufschluss darüber, wie die Semantik Ihrer App für Nutzer dieser Technologien funktioniert. Wir empfehlen Ihnen dringend, Ihre App mit den Hilfstechnologien von Android zu testen. So können Sie am besten nachvollziehen, wie Ihre Nutzer mit Beeinträchtigungen Ihre App erleben.
  • Layout-Inspektor: Hier können Sie die Semantik jedes Composeables prüfen und beheben sowie fehlende oder falsche Informationen identifizieren.
  • Accessibility Scanner App: Scannt Ihren Bildschirm und gibt Empfehlungen zur Verbesserung der Barrierefreiheit, indem häufige Fallstricke erkannt werden.

Fehler beheben

Zwischen Compose, dem Semantiksystem und den Bedienungshilfen von Android können unerwartete Verhaltensweisen auftreten, die schwer zu verfolgen sind. Mithilfe semantischer Eigenschaften können Sie nachvollziehen, warum sich Ihre Komponenten so verhalten.

Probleme mit dem Verhalten von Bedienungshilfen können Sie mit dem Layout-Inspektor in Android Studio, mit TreeDebug in den Entwicklereinstellungen von TalkBack oder mit ComposeTestRules printToLog beheben. Alle diese Tools können Informationen zu Knoten (und ihren Eigenschaften) liefern, die von Compose für Dienste zur Barrierefreiheit freigegeben werden.

Im folgenden Beispiel wird der Layout-Inspektor verwendet, um einen Bildschirm mit drei Elementen zu debuggen. Wenn die Bedienungshilfen aktiviert sind, wird das erste Element nicht ausgewählt und das zweite Element hat kein Aktionsfeedback. Sie können die semantischen Eigenschaften prüfen, um potenzielle Probleme zu finden.

Der Komponentenbaum im Layout-Inspektor enthält Informationen zu den Begrenzungen, Parametern und anderen semantischen Informationen eines Elements. Im Baum werden alle drei Elemente erkannt:

Layout Inspector mit allen drei Elementen
Abbildung 2. Layout Inspector mit allen drei Elementen

Auf das erste Element ist die Property hideFromAccessibility angewendet. Das bedeutet, dass das Element möglicherweise irgendwo im semantischen Baum als ausgeblendet markiert ist oder durch ein dekoratives Overlay verdeckt wird.

Layout Inspector: Erstes Element mit „hideFromAccessibility“
Abbildung 3 Layout Inspector: Erstes Element mit hideFromAccessibility

Das zweite Element hat eine Fokuseigenschaft, aber kein onClick wie das vorherige Element. Daher fehlt möglicherweise irgendwo ein clickable-Modifikator, weshalb ein Dienst zur Barrierefreiheit wie TalkBack dem Nutzer möglicherweise kein Aktionssignal ansagt:

Layout Inspector: zweites Element mit Fokus
Abbildung 4: Layout Inspector: zweites Element mit focused

Das dritte Textelement hat alle erforderlichen Eigenschaften – es kann fokussiert werden, hat ein onClick und es werden weitere zusätzliche Semantiken angewendet. Daher wird es wie erwartet interpretiert.

Layout Inspector: drittes Element mit allen APIs
Abbildung 5: Layout Inspector: drittes Element mit allen APIs

So können Sie mithilfe von Debug-Tools ermitteln, warum bestimmte Ansagen oder Auswahlen nicht von Diensten für Barrierefreiheit ausgeführt werden.