DocsAccessibility

Accessibility

We are committed to building a component library that adheres to accessibility best practices. Our components are developed and tested to align with WCAG (Web Content Accessibility Guidelines) and Section 508 standards.

Because many UI Kit components are custom-built, we pay particular attention to:

  • Keyboard navigation support
  • Screen reader compatibility
  • Proper ARIA attributes and roles

Accessibility is an ongoing effort. If you encounter a component that could be improved, we encourage you to share your feedback — we’re always looking to improve.

⚠️

While we strive to provide accessible components out of the box, developers are responsible for ensuring accessibility within their applications by using components correctly and in context.

Keyboard Navigation

Most UI Kit components support keyboard interaction to ensure usability without relying on a mouse or touch interface.

KeyAction
ButtonsEnter or Space to activate
ModalsEsc to close
TabsArrow keys to navigate between tabs, Tab to move focus
DropdownsEnter or Space to select, Arrow keys to navigate options, Esc to close
Checkboxes/RadiosSpace to toggle selection
GroupsArrow keys to move between items, Tab to move focus

ARIA and Role Customization

Many components provide props for enhancing or overriding default accessibility behavior:

  • aria-label, aria-labelledby, aria-describedby
  • role override (e.g., role="dialog" for modals)
  • Dynamic ARIA attributes such as:
    • aria-expanded
    • aria-checked
    • aria-selected
    • aria-hidden

These are passed directly to the relevant HTML elements when supported.

For advanced accessibility behavior, we recommend referencing the WAI-ARIA Authoring Practices Guide.
If you’d like to report an accessibility issue, please open an issue on our GitHub repo.