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

33 lines
1.5 KiB
Markdown

# 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