Accessibility

Current State

TokenFlight widgets include basic accessibility support:

Tab cycles through interactive elements (buttons, inputs, selectors)
Enter / Space activates focused buttons and controls
Escape closes modal overlays (token selector, route details)

Color Contrast

theme="auto" respects the user's prefers-color-scheme setting
Light and dark themes are designed with sufficient contrast ratios for text readability

Focus Indicators

Interactive elements show visible focus outlines when navigated via keyboard

Known Limitations

ARIA labels and roles may be incomplete on some interactive elements
Screen reader announcements for state transitions (loading, success, error) are not yet implemented
The token selector modal may not fully trap focus
Color contrast has not been formally audited against WCAG 2.1 AA standards

Recommendations

If accessibility is critical for your integration:

Test the widget with your target screen readers (VoiceOver, NVDA, JAWS)
Provide supplementary instructions or status text outside the widget based on callback events
Use onSwapSuccess and onSwapError callbacks to announce outcomes via your app's accessibility infrastructure

Reporting Issues

If you find accessibility problems, please report them through the support channels listed on the documentation site.