Receive accessible form fields with screen reader support in the report
The post-session report feature must be fully accessible to peer mentors who rely on screen readers, particularly given that Blindeforbundet's peer mentors themselves may have visual impairments. Every dynamic field rendered in the report form must have semantic labels, correct ARIA roles, and proper focus management so that VoiceOver and TalkBack users can navigate the form in a logical sequence. The way-forward section and speech-to-text controls must also be fully accessible.
User Story
Acceptance Criteria
- Given a peer mentor uses VoiceOver on iOS, when they open the post-session report screen, then the screen reader announces the screen title and focuses on the first form field
- Given the report form has multiple sections, when the peer mentor navigates with swipe gestures, then each field is announced with its label, current value, and any validation state
- Given the way-forward section contains dynamic list items, when a peer mentor adds or removes an item with a screen reader active, then a live region announcement confirms the change
- Given the speech-to-text microphone button is visible, when a screen reader user focuses on it, then the button is announced as 'Activate speech input for [field name]' with its current state
- Given a form validation error occurs on submission, when using a screen reader, then focus is moved to the first error field and the error message is announced
- Given the report has sensitive fields that should be flagged, when a screen reader user focuses on such a field, then a warning is announced before reading the field content
Business Value
Blindeforbundet's entire user base includes people with visual impairments — and peer mentors themselves may be visually impaired. Full screen reader accessibility on the post-session report is therefore not optional but a core MUST HAVE requirement. Failure to support VoiceOver would exclude the very population the app is designed to serve, violating both WCAG 2.2 AA requirements and the organisations' accessibility commitments. This also protects against legal non-compliance in Norway's digital accessibility regulation.
Components
- Post-Session Report Screen ui
- Dynamic Field Renderer ui
- Speech-to-Text Field Overlay ui
- Semantics Wrapper Widget ui
- Sensitive Field Warning Dialog ui
- Live Region Announcer ui
- Activity Wizard Step Semantics ui
- Screen Reader Detection Service service
- Sensitive Field Privacy Guard service
- Focus Management Service service
- Semantics Service Facade infrastructure
- Accessibility Live Region Announcer infrastructure