Verfügt über eine gültige Zugänglichkeitsrolle
Regel-ID: hat eine gültige Zugriffsrolle
accessibilityRole teilt dem Benutzer der unterstützenden Technologie den Zweck einer Komponente mit.
accessibilityRole kann einer der folgenden sein:
- einstellbar Wird verwendet, wenn ein Element „eingestellt“ werden kann (z. B. ein Schieberegler).
- Alarm Wird verwendet, wenn ein Element wichtigen Text enthält, der dem Benutzer angezeigt werden soll.
- Schaltfläche Wird verwendet, wenn das Element als Schaltfläche behandelt werden soll.
- Kontrollkästchen Wird verwendet, wenn ein Element ein Kontrollkästchen darstellt, das aktiviert, deaktiviert oder in einem gemischten aktivierten Zustand sein kann.
- Kombinationsbox Wird verwendet, wenn ein Element eine Kombinationsbox darstellt, die dem Benutzer die Auswahl zwischen mehreren Optionen ermöglicht.
- Header Wird verwendet, wenn ein Element als Header für einen Inhaltsabschnitt fungiert (z. B. der Titel einer Navigationsleiste).
- Bild Wird verwendet, wenn das Element als Bild behandelt werden soll. Kombinierbar mit einem Button oder Link.
- Bildschaltfläche Wird verwendet, wenn das Element als Schaltfläche behandelt werden soll und auch ein Bild ist.
- Tastaturtaste Wird verwendet, wenn das Element als Tastaturtaste fungiert.
- Link Wird verwendet, wenn das Element als Link behandelt werden soll.
- Menü Wird verwendet, wenn die Komponente ein Auswahlmenü ist.
- Menüleiste Wird verwendet, wenn eine Komponente ein Container mit mehreren Menüs ist.
- Menüelement Wird verwendet, um ein Element innerhalb eines Menüs darzustellen.
- keine Wird verwendet, wenn das Element keine Rolle hat.
- Fortschrittsbalken Wird verwendet, um eine Komponente darzustellen, die den Fortschritt einer Aufgabe anzeigt.
- Radio Wird verwendet, um ein Optionsfeld darzustellen.
- Radiogruppe Wird verwendet, um eine Gruppe von Optionsfeldern darzustellen.
- Bildlaufleiste Wird verwendet, um eine Bildlaufleiste darzustellen.
- Suchen Wird verwendet, wenn ein Textfeldelement auch als Suchfeld behandelt werden soll.
- Drehknopf Wird verwendet, um eine Schaltfläche darzustellen, die eine Liste mit Auswahlmöglichkeiten öffnet.
- Zusammenfassung Wird verwendet, wenn ein Element verwendet werden kann, um beim ersten Start der App eine schnelle Zusammenfassung der aktuellen Bedingungen in der App bereitzustellen.
- Schalter Wird verwendet, um einen Schalter darzustellen, der ein- und ausgeschaltet werden kann.
- Registerkarte Wird verwendet, um eine Registerkarte darzustellen.
- Registerkartenliste Wird verwendet, um eine Liste von Registerkarten darzustellen.
- text Wird verwendet, wenn das Element als statischer Text behandelt werden soll, der sich nicht ändern kann.
- Timer Wird verwendet, um einen Timer darzustellen.
– togglebutton Wird verwendet, um eine Umschalttaste darzustellen. Sollte mit geprüftem accessibilityState verwendet werden, um anzugeben, ob die Schaltfläche ein- oder ausgeschaltet ist. – toolbar Wird verwendet, um eine Symbolleiste darzustellen (ein Container mit Aktionsschaltflächen oder Komponenten).
- Grid Wird mit ScrollView, VirtualizedList, FlatList oder SectionList verwendet, um ein Grid darzustellen. Fügt der GridView von Android die In-/Out-of-Grid-Ankündigungen hinzu.
Warum es wichtig ist
Elemente, denen ungültige Rollenwerte zugewiesen sind, werden von der unterstützenden Technologie nicht wie vom Entwickler beabsichtigt interpretiert.
Wenn Bildschirmleseprogramme und andere unterstützende Technologien die Rolle der einzelnen Elemente nicht kennen, können sie weder intelligent mit ihnen interagieren, noch sind sie in der Lage, dem Benutzer die Rolle mitzuteilen. Die Merkmale, Eigenschaften und Methoden eines Elements zur Übermittlung von Informationen an und/oder vom Benutzer können nicht über unterstützende Technologien übermittelt werden, wenn ein Rollenwert ungültig ist.
So beheben Sie das Problem
Stellen Sie sicher, dass der accessibilityRole Wert eine gültige Rolle ist.
Bestandene Beispiele
<TouchableOpacity accessibilityRole="button">
<Text>Increase Count</Text>
</TouchableOpacity>Beispiele für Fehlschläge
<TouchableOpacity accessibilityRole="secondary-button">
<Text>Increase Count</Text>
</TouchableOpacity>