Accessibility Support
Out of the box, the Telerik and Kendo UI Autocomplete provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.
The Autocomplete is compliant with the Web Content Accessibility Guidelines (WCAG) 2.2 standards and Section 508 requirements, follows the Web Accessibility Initiative - Accessible Rich Internet Applications (WAI-ARIA) best practices for implementing the keyboard navigation and provides options for managing its focus and is tested against the most popular screen readers.
Autocomplete
ARIA Attributes
| Attribute | Description |
|---|---|
role="combobox" | Announces the autocomplete input. |
aria-haspopup="listbox" | Indicates the component has a listbox popup. |
aria-expanded | Announces the popup visibility. |
aria-label | Accessible name for the autocomplete. |
aria-disabled="true" | Rendered when the autocomplete is disabled. |
role="listbox" | Popup list has listbox role. |
aria-label|aria-labelledby | Popup listbox must have an accessible name. Consuming code is responsible for associating with the component label via aria-labelledby. |
role="option" | Each list item is an option. |
id | Referenced by aria-controls on the input. |
aria-autocomplete | Indicates autocomplete type |
aria-activedescendant | Points to focused item when popup is open |
Keyboard Navigation
| Trigger | Behavior |
|---|---|
Typing in the input | Focuses the matched item. |
Alt/Opt(Mac) + ArrowDown | Opens the popup. |
Alt/Opt(Mac) + ArrowUp or Escape | Closes the popup. |
Escape | Resets the value in the input when the popup is closed. |
Enter | Triggers the change event. |
UX Behavior
| Feature | Description |
|---|---|
| Popup | Opens a suggestion list when the user starts typing. |
| Filtering | Narrows the suggestion list as the user types. |
| Selection | Choosing a suggestion fills the input and closes the popup. |
| Placeholder | Displays hint text inside the input when it is empty. |
| Disabled state | When disabled, the input is non-interactive and visually dimmed. |
Testing
The Autocomplete has been extensively tested automatically with axe-core and manually with the most popular screen readers.
Screen Readers
The Autocomplete has been tested with the following screen readers and browsers combinations:
| Environment | Tool |
|---|---|
| Firefox | NVDA |
| Chrome | JAWS |
| Microsoft Edge | JAWS |