flask_template_codex/ACCESSIBILITY.md
2026-08-08 05:37:41 +02:00

1.7 KiB

Accessibility Review

Target and Scope

Steady targets WCAG 2.2 Level AA. The current review covers server-rendered structure, keyboard-visible focus, control labels, unique IDs, color contrast, 320 CSS-pixel reflow contracts, target sizing, reduced motion, forced colors, and status announcements. Reference: W3C WCAG 2.2.

This is not a certification. The development environment has no browser engine, Lighthouse, pa11y, or screen reader, so rendered layout, zoom, focus order, and assistive-technology behavior still require manual verification.

Automated Evidence

Run:

python -m pytest tests/polish/test_accessibility.py

The tests render primary authenticated pages and check language, page titles, the main landmark, skip navigation, headings, unique IDs, named buttons, and labeled controls. CSS contract tests cover the mobile breakpoint, 44-pixel primary targets, three-pixel focus outlines, reduced-motion overrides, forced-colors support, and key light/dark contrast pairs.

Manual Release Checklist

  • Navigate every page using only Tab, Shift+Tab, Enter, Space, and Escape.
  • Confirm focus is visible and never obscured at 100%, 200%, and 400% zoom.
  • Test at 320 CSS pixels without two-dimensional page scrolling.
  • Test Light, Dark, Auto, readability typography, reduced motion, and forced colors.
  • Verify forms and live feedback with NVDA/Firefox, VoiceOver/Safari, or an equivalent supported pairing.
  • Confirm timer completion is understandable with sound disabled.
  • Recheck destructive-action wording and error recovery with representative users.

Record browser, operating system, assistive technology, results, and unresolved issues before a public release.