Access Bufdir preview with full accessibility support
The bufdir-accessibility-utils component provides semantic labeling, live region announcements, and focus management for all interactive elements in the preview screen. All Bufdir field rows include meaningful accessibility labels that read out both the field name and its value. The validation summary banner uses a live region so that screen reader users are immediately informed of validation issues when the preview loads. The period diff view provides alternative text descriptions of numeric changes rather than relying solely on color. This is particularly important given that Blindeforbundet users rely on VoiceOver and may be coordinators as well as peer mentors.
User Story
Acceptance Criteria
- Given a coordinator using VoiceOver (iOS) navigates to the preview screen, When they swipe through the report, Then each field row is announced as '[Field Name]: [Value]' without requiring visual inspection
- Given the validation summary banner appears, When the screen loads, Then VoiceOver announces the validation status as a live region update so the coordinator immediately knows if there are errors
- Given the period diff view is active, When a coordinator using a screen reader navigates to a changed field, Then the accessibility label reads '[Field Name]: current [value], previous [previous value], [increase/decrease] of [percentage]'
- Given the preview screen contains multiple sections, When a VoiceOver user navigates by headings, Then each report section header is exposed as an H2 heading landmark
- Given all interactive elements in the preview, When tested with the accessibility audit service, Then no WCAG 2.2 AA violations are reported for contrast, touch target size, or semantic labeling
- Given focus enters the validation banner, When errors are present, Then focus is programmatically moved to the first error item so the coordinator does not have to search for it
Business Value
Accessibility compliance is a non-negotiable requirement for all three organizations, with Blindeforbundet placing it as a top-tier requirement. Failing to make the Bufdir preview accessible would exclude coordinators with disabilities from performing a core compliance task, violating both organizational values and Norwegian accessibility regulations (WCAG 2.2 AA). Non-compliance also risks loss of public sector procurement eligibility.