Out of the box, the Kendo React ColumnChooser provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.


The ColumnChooser is compliant with the [Web Content Accessibility Guidelines (WCAG) 2.2 AA](https://www.w3.org/TR/WCAG22/) standards and [Section 508](https://www.section508.gov/) requirements, follows the [Web Accessibility Initiative - Accessible Rich Internet Applications (WAI-ARIA)](https://www.w3.org/WAI/ARIA/apg/) best practices for implementing the [keyboard navigation](#keyboard-navigation) for its `component` role, provides options for managing its focus and is tested against the most popular screen readers.

## WAI-ARIA


This section lists the selectors, attributes, and behavior patterns supported by the component and its composite elements, if any.

### The ColumnChooser Button

| Selector | Attribute | Usage |
| -------- | --------- | ----- |
| `.k-grid-column-chooser .k-button` | `has-popup=dialog` | Specifies that the button opens a dialog. |
|  | `aria-expanded=true/false` | Announces the current open state of the popup. |
|  | `aria-controls=.k-animation-container id` | Points to the popup that the button toggles. |

### The ColumnChooser Columns List

| Selector | Attribute | Usage |
| -------- | --------- | ----- |
| `.k-column-list` | `role=listbox` | Sets the listbox role of the list of columns wrapper. |
|  | `aria-multiselectable=true` | Specifies that the list is multiselectable. |
| `.k-column-list .k-column-list-item` | `role=option` | Sets the option role of the list item. |
|  | `aria-checked=true/false` | Sets the checked state of list item. |
|  | `tabindex=0/-1` | Sets the tabindex depending on the item's focused state. |
| `.k-column-list-item .k-checkbox` | `tabindex=-1` | Removes the default focus behavior of the checkbox. |
|  | `aria-hidden=true` | Hides the checkbox from the assistive technologies, as its accessibility is implemented by the item wrapper. |


Disregard the AXE nested interactive rule as it lacks precise definition and does not account for specific use-cases individually. The current ColumnChooser specification does not violate any explicit WCAG success criteria, allowing us to safely ignore the newly introduced AXE interpretation.

## Resources

[WAI-ARIA specification for listbox](https://www.w3.org/WAI/ARIA/apg/patterns/listbox/)

[MDN reference for the dialog role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/dialog_role)

[AXE Nested Interactive Rule](https://dequeuniversity.com/rules/axe/4.7/nested-interactive?application=AxeChrome)

[Deque Github Issue Discussion for the Nested Interactive AXE Rule](https://github.com/dequelabs/axe-core/issues/2906)

## Section 508


The ColumnChooser is fully compliant with the [Section 508 requirements](http://www.section508.gov/).

## Testing


The ColumnChooser has been extensively tested automatically with [axe-core](https://github.com/dequelabs/axe-core) and manually with the most popular screen readers.

> To report any accessibility issues, contact the team through the [Telerik Support System](https://www.telerik.com/account/support-center).

### Screen Readers


The ColumnChooser has been tested with the following screen readers and browsers combinations:

| Environment | Tool |
| ----------- | ---- |
| Firefox | NVDA |
| Chrome | JAWS |
| Microsoft Edge | JAWS |