Receive Accessible Screen Reader Narration of Benefit Results

For Blindeforbundet and other organizations serving users with visual impairments, full screen reader compatibility is non-negotiable. The Benefit Calculator screen must use semantics-wrapper-widget on all interactive and informational elements. The live-region-announcer must announce calculation completion, period changes, and share confirmations. The benefit-results-card and each benefit-metric-tile must have semantics labels that read the full context in natural language, not just numeric values. The screen-reader-detection-service detects active assistive technology and can adjust layout hints (e.g., collapsing decorative animations). The focus-management-service ensures focus moves logically after calculation completes — from input panel to results card — so screen reader users do not lose their place.

HIGH story-volunteer-benefit-calculator-peer-mentor-006 5 pts

Story Points

High

Priority

Volunteer Benefit Calculator

Feature

User Story

As a Peer Mentor (Likeperson)

I want the Benefit Calculator screen to be fully narrated by my screen reader, with all metric values and benefit results announced in clear, plain language

So that I can understand my volunteer impact even if I have a visual impairment or use assistive technology, without requiring help from another person

Acceptance Criteria

Given VoiceOver or TalkBack is active, When the benefit-calculator-screen loads and calculation completes, Then the live-region-announcer announces 'Calculation complete. Your estimated volunteer benefit for [period] is [value]'
Given a screen reader user navigates through benefit-metric-tile components, When each tile receives focus, Then the semantics label provides full context including activity type name, count, hours, and benefit value in a single coherent sentence
Given the screen-reader-detection-service detects active assistive technology, When decorative animations are present in the results card, Then animations are suppressed or reduced to avoid distraction for screen reader users
Given the peer mentor changes the calculation period using the input panel, When the new calculation completes, Then focus-management-service moves focus to the updated benefit-results-card and the live-region-announcer announces the new total
Given the Benefit Calculator screen is evaluated by the accessibility-audit-service, When the audit runs, Then zero critical WCAG 2.2 AA violations are reported for the screen, including color contrast, touch target size, and semantics labelling

Business Value

Accessibility is a MUST HAVE requirement across all three organizations, with Blindeforbundet explicitly requiring full screen reader support. A Benefit Calculator that cannot be navigated by screen reader users excludes the very population the app is built to serve. Full WCAG 2.2 AA compliance also protects the organizations from legal and reputational risk, and demonstrates that the app lives up to its promise of universal accessibility — which is a key differentiator in the competitive nonprofit software landscape and a prerequisite for Bufdir funding compliance.

Components

Volunteer Benefit Calculator

Related Feature

Peer Mentor (Likeperson)

User Role