directus-task-management/docs/front-end-spec/accessibility-requirements.md

1.5 KiB

Accessibility Requirements

Compliance Target

Standard: WCAG 2.1 Level AA compliance

Key Requirements

Visual:

  • Color contrast ratios: Minimum 4.5:1 for normal text, 3:1 for large text and UI components
  • Focus indicators: Visible 2px solid outline with 2px offset, using primary color (#6366F1)
  • Text sizing: Minimum 16px base font size, scalable to 200% without horizontal scrolling

Interaction:

  • Keyboard navigation: Complete functionality accessible via keyboard, logical tab order
  • Screen reader support: Proper ARIA labels, landmarks, and live regions for dynamic content
  • Touch targets: Minimum 44px click/touch area for all interactive elements

Content:

  • Alternative text: Descriptive alt text for all images, including AI status icons and charts
  • Heading structure: Proper H1-H6 hierarchy without skipping levels
  • Form labels: Explicit labels or ARIA-label for all form inputs and controls

AI-Specific Accessibility Considerations

  • Screen reader announcements for AI operations start/complete
  • Live region updates for AI-generated content with descriptive text
  • Keyboard shortcuts for common AI actions (Ctrl+K for prompt, Ctrl+Shift+A for AI enhance)
  • Clear labeling of AI-generated vs. human-created content

Testing Strategy

  • axe-core integration in development pipeline for continuous accessibility scanning
  • Manual keyboard-only navigation testing for all critical user flows
  • Screen reader testing (NVDA, JAWS, VoiceOver) on key screens