Composables barrierefreier machen

Versuchen Sie, die Composables in Ihrer App barrierefreier zu machen. Die folgenden Schritte können die Barrierefreiheit Ihres Composables verbessern:

  • Composable beschreiben
  • Interaktionen hinzufügen
  • Komplexe UIs verarbeiten

Composable beschreiben

Um ein Composable zu beschreiben, deklarieren Sie seine semantischen Eigenschaften (z. B. role, label, state, oder Aktionen) mit Modifier.semantics. Bedienungshilfen können diese semantischen Eigenschaften lesen und die Informationen verwenden, um mit der UI zu interagieren und sie anzukündigen.

Die Eigenschaft Role ist besonders wichtig, da sie den erforderlichen Kontext für Bedienungshilfen bietet, um den Zweck einer Komponente und die erwarteten Interaktionen anzukündigen. Nehmen wir beispielsweise ein benutzerdefiniertes Symbol, das sich wie eine anklickbare Schaltfläche verhält. Wenn Sie die Rolle auf Role.button festlegen, wird es von Screenreadern als interaktives Element und nicht als statisches Bild angekündigt.

Weitere Informationen finden Sie unter Semantik.

Interaktionen hinzufügen

Verwenden Sie die clickable oder toggleable Modifikatoren, um Ihrem Composable Interaktionen hinzuzufügen. Diese Modifikatoren enthalten integrierte semantische Eigenschaften, die von Bedienungshilfen gelesen werden können. Verwenden Sie CustomAccessibilityAction, um komplexe Touchscreen Gesten barrierefreier zu machen.

Weitere Informationen finden Sie unter Benutzerdefinierte Aktionen.

Komplexe UIs verarbeiten

Compose unterstützt standardmäßig viele Bedienungshilfen. Bei einer komplexeren UI ist jedoch möglicherweise ein stärker angepasstes Verhalten erforderlich. Sie können komplexe UIs barrierefreier machen, indem Sie die UI-Hierarchie logisch strukturieren und eine logische Lesereihenfolge für Bedienungshilfen bereitstellen.

UI-Hierarchie logisch strukturieren:Wenn ein übergeordnetes Composable aus mehreren untergeordneten Elementen besteht, können Sie explizit angeben, wie diese Elemente gruppiert werden, oder sie vollständig überschreiben. Weitere Informationen finden Sie unter Zusammenführen und Löschen.

Reihenfolge der Navigation steuern:Wenn die Standardlesereihenfolge von Compose nicht ausreicht, können Sie manuell festlegen, wie Screenreader durch die UI-Elemente navigieren. Weitere Informationen finden Sie unter Reihenfolge der Navigation ändern.

Fokus steuern:Bei der Navigation mit der Tastatur und dem Steuerkreuz können Sie die Reihenfolge der Navigation manuell überschreiben. Weitere Informationen finden Sie unter Fokusverhalten ändern und Reihenfolge der Navigation ändern.

Zusätzliche Ressourcen

Weitere Informationen zum barrierefreien Gestalten Ihrer UI finden Sie in den folgenden zusätzlichen Ressourcen:

Dokumentation

Ansichten-Inhalte