Skip to main content

AutoComplete

The AutoComplete component provides suggestions as you type, making it easier and faster to input data.

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

AttributeDescription
role="combobox"Announces the autocomplete input.
aria-haspopup="listbox"Indicates the component has a listbox popup.
aria-expandedAnnounces the popup visibility.
aria-labelAccessible name for the autocomplete.
aria-disabled="true"Rendered when the autocomplete is disabled.
role="listbox"Popup list has listbox role.
aria-label|aria-labelledbyPopup 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.
idReferenced by aria-controls on the input.
aria-autocompleteIndicates autocomplete type
aria-activedescendantPoints to focused item when popup is open

Keyboard Navigation

TriggerBehavior
Typing in the inputFocuses the matched item.
Alt/Opt(Mac) + ArrowDownOpens the popup.
Alt/Opt(Mac) + ArrowUp or EscapeCloses the popup.
EscapeResets the value in the input when the popup is closed.
EnterTriggers the change event.

UX Behavior

FeatureDescription
PopupOpens a suggestion list when the user starts typing.
FilteringNarrows the suggestion list as the user types.
SelectionChoosing a suggestion fills the input and closes the popup.
PlaceholderDisplays hint text inside the input when it is empty.
Disabled stateWhen 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:

EnvironmentTool
FirefoxNVDA
ChromeJAWS
Microsoft EdgeJAWS

Resources

Feedback