Accessibility in React Query Builder UI
4 Sep 20264 minutes to read
The React Query Builder UI component adheres to accessibility guidelines and standards, including ADA, Section 508, WCAG 2.2 standards, and WCAG roles commonly used to evaluate web accessibility.
The following table outlines the accessibility compliance features of the React Query Builder UI component.
| Accessibility Criteria | Compatibility |
|---|---|
| WCAG 2.2 Support |  |
| Section 508 Support | |
| Screen Reader Support | |
| Right-To-Left Support | |
| Color Contrast | |
| Mobile Device Support | |
| Keyboard Navigation Support | |
| Accessibility Checker Validation | |
| Axe-core Accessibility Validation | |
- All features of the component meet the requirement.
- Some features of the component do not meet the requirement.
- The component does not meet the requirement.WAI-ARIA attributes
WAI-ARIA (Web Accessibility Initiative – Accessible Rich Internet Applications) provides a framework for enhancing the accessibility of web applications. It defines semantic roles, states, and properties that communicate component purpose and current state to assistive technologies like screen readers.
The React Query Builder UI uses the following WAI-ARIA attributes:
| Attributes | Purpose |
|---|---|
role |
Identifies the React Query Builder UI region to assistive technologies. The root container uses role="form" while individual rule rows expose role="group". |
aria-expanded |
Indicates whether the field, operator, or value dropdown is currently open or collapsed. |
aria-haspopup |
Conveys that the field, operator, and value editors open a popup (listbox) when activated. |
aria-label |
Provides an accessible name for icon buttons such as Add Group, Add Condition, Delete, Clone, and Lock. |
aria-disabled |
Reflects the locked or disabled state of a rule or group. |
Keyboard interaction
The React Query Builder UI provides keyboard support for efficient navigation and interaction without requiring a mouse. Users can navigate between fields, operators, and values; manage rules and groups; and control the component using standard keyboard shortcuts and focus management.
The React Query Builder UI component follows the keyboard interaction guideline, making it easy for people who use assistive technologies (AT) and those who completely rely on keyboard navigation. The following keyboard shortcuts are supported by the React Query Builder UI component.
| Press | To do this |
|---|---|
| Tab / Shift + Tab | Moves focus to the next or previous interactive element within the rule group. |
| Arrow Up / Arrow Down | Navigates between options inside an open field, operator, or value dropdown. |
| Enter | Commits the currently typed/selected value and moves focus to the next editor in the rule. |
| Escape | Closes any open dropdown without applying changes. |
| Delete | Removes the focused rule or group when focus is on the rule/container body. |
Ensuring accessibility
The React Query Builder UI component’s accessibility levels are ensured through an accessibility-checker and axe-core software tools during automated testing.
The accessibility compliance of the React Query Builder UI component is shown in the following sample. Open the sample in a new window to evaluate the accessibility of the React Query Builder UI component with accessibility tools.