Access the Organization Selection Screen with a Screen Reader
Blindeforbundet's users include visually impaired peer helpers for whom screen reader support is not a nice-to-have but a hard requirement. The org selection screen must be fully navigable with VoiceOver (iOS) and TalkBack (Android). Every interactive element — organization cards, the selection action, error messages, and the progress indicator — must have correct semantic labels, focus order, and role announcements. The wcag-semantics-label-resolver (688-wcag-semantics-label-resolver), semantics-wrapper-widget (606-semantics-wrapper-widget), and live-region-announcer (608-live-region-announcer) are used to ensure compliance. Organization names and role labels resolved via the terminology system must also be correctly surfaced to accessibility services.
User Story
Acceptance Criteria
- Given I am a VoiceOver user on iOS, When the org selection screen loads, Then focus is automatically placed on the first organization card and VoiceOver announces the organization name, my role, and that the card is tappable
- Given I am using a screen reader, When I navigate through the list of organization cards, Then each card is announced with the organization name, my role within that organization, and any relevant status information
- Given I am using a screen reader, When I double-tap to select an organization, Then VoiceOver announces confirmation of the selection and that the app is loading the home screen
- Given an error occurs loading the organization list, When I am using a screen reader, Then the error message is announced via a live region without requiring me to navigate to it manually
- Given the onboarding progress indicator is visible, When I am using a screen reader, Then the step progress is announced as part of the screen's accessibility description
- Given the org selection screen is displayed, When I run an accessibility audit, Then there are no WCAG 2.2 AA violations on this screen
Business Value
Blindeforbundet — one of the four founding organizations — explicitly requires full screen reader support (VoiceOver/JAWS) as a hard requirement, not a future enhancement. Their peer mentors are themselves visually impaired individuals serving other visually impaired people. A screen-inaccessible org selection screen would categorically exclude Blindeforbundet's peer mentors from using the platform entirely, making it impossible to deliver the contracted solution to this organization. WCAG 2.2 AA compliance on the entry screens is therefore a contractual and ethical obligation.
Components
- Semantics Wrapper Widget ui
- Live Region Announcer ui
- Screen Reader Detection Service service
- Accessibility Audit Service service
- Semantics Service Facade infrastructure
- WCAG 2.2 AA Compliance Checker infrastructure
- Accessibility Live Region Announcer infrastructure
- Organization Selection Screen ui
- Organization Card Widget ui
- WCAG Semantics Label Resolver infrastructure