Skip to main content
🎉 A11y Issue Detection Agent is now live! Detect accessibility issues like a WCAG expert with AI. Try now!
No Result Found
Connect & Get help from fellow developers on our Discord community. Ask the CommunityAsk the Community

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 appropriate accessibilityClassName and 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 appropriate accessibilityTraits (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





Thank you for your valuable feedback

Is this page helping you?

Yes
No

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!

Talk to an Expert
Download Copy Check Circle