Missing view state in spoken output
Interactive controls that have states (selected, checked, etc.) must expose their current state programmatically so screen readers can announce it correctly. For non-native elements, ensure the correct state is exposed if applicable.
- Rule Category :
Accessibility Labels - WCAG Version :
2.1 & 2.2 - Rule Severity :
Serious - Supported Platforms :
Android,iOS - Conformance Level :
A - Success Criteria :
4.1.2 – Name, Role, Value (Level A)
Success criteria
The rule checks for the following potential violations:
-
Missing state information
Interactive elements do not expose their current state to accessibility services, so screen readers cannot announce it.
How to fix
To fix violations related to missing view state in spoken output, follow these steps:
-
Android: Use standard widgets where possible (
CheckBox,ToggleButton, etc.). For custom controls, expose correct state by setting appropriateaccessibilityClassNameand maintaining state properties (isSelected,isChecked, etc.) so TalkBack can announce the state correctly. -
iOS: Use standard controls where possible (
UISwitch,UISegmentedControl). For custom controls, set appropriateaccessibilityTraits(e.g.,.selected,.checked) and maintain correct state flags so VoiceOver can announce the state correctly.
Applicability
All mobile apps (Android/iOS), including native, React Native, Flutter, and hybrid apps where labels are used.
Example
Add example scan report or screenshot here.
For any missing information, please refer to the original Confluence documentation or add a placeholder as needed.
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!