Access All Multi-Step Wizards via Screen Reader with Step Progress Announcements

All wizard screens in the app use a step progress model that is currently communicated visually via a progress bar or step dots. For screen reader users, this progress information must also be exposed semantically. Each wizard step container must include a Semantics node announcing 'Step X of Y: [step title]' when it becomes the active view. The step progress indicator widget must have an appropriate semantic role (progressbar or heading) and value. Navigation between steps via 'Next' and 'Back' buttons must announce the destination step. If a user attempts to advance with an incomplete step, the first validation error must receive focus automatically and be announced.

HIGH story-screen-reader-support-peer-mentor-005 5 pts

Story Points

High

Priority

Screen Reader Support

Feature

User Story

As a user

I want multi-step wizards (activity registration, event creation, expense registration) to announce the current step number, total step count, and step title when I navigate to each step, and to announce progress and completion states clearly

So that So that I maintain orientation within complex multi-step flows without needing vision to read visual step indicators, reducing the risk of abandoning a registration midway due to confusion about progress

Acceptance Criteria

Given a user with VoiceOver enabled enters the activity registration wizard, when the first step loads, then VoiceOver announces 'Step 1 of 5: Select Contact'
Given a user taps 'Next' to advance a wizard step, when the next step loads, then VoiceOver announces the new step number, total, and title within 300ms
Given a user taps 'Next' on an incomplete wizard step, when validation fails, then focus moves automatically to the first field with an error and the error message is announced
Given a user reaches the final summary step of the activity wizard, when it loads, then VoiceOver announces 'Step 5 of 5: Review and Submit' followed by a summary of the entered values
Given a user taps 'Back' in a wizard, when the previous step loads, then VoiceOver announces the step context so the user knows they are moving backwards through the flow
Given the wizard step progress indicator is focused directly, when VoiceOver reads it, then it announces the current progress as a percentage or step fraction (e.g., 'Progress: step 3 of 5, 60 percent complete')

Business Value

Activity registration is the highest-priority function for all partner organizations, and the multi-step wizard is the primary interaction pattern for completing it. Visually impaired peer mentors — the core users of this feature for Norges Blindeforbund — must be able to complete registrations independently. Without step progress announcements, wizard-based flows are disorienting for screen reader users and lead to incomplete submissions, directly causing the underreporting problem that the app is designed to solve.

Components

Accessible Widget Library ui
Semantic Label Service service

Screen Reader Support

Related Feature

Peer Mentor (Likeperson)

User Role