Skip to main content

ComboBox

The ComboBox component allows you to select an option from a list or input your own custom value.

Accessibility Support

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

The Combobox 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.

Combobox

ARIA Attributes

AttributeDescription
role="combobox"Identifies the input as a combobox.
aria-haspopup="listbox"Indicates the combobox has a listbox popup.
aria-expandedIndicates whether the popup is open.
aria-invalid="true"Rendered when the combobox is in an invalid state.
aria-busy="true"Rendered when the combobox is loading data.
aria-label|aria-labelledbyAccessible name provided by consuming app.
aria-disabled="true"Rendered when the combobox is disabled.
role="button"The dropdown toggle button.
aria-labelAccessible name for the dropdown button.
tabindex="-1"Dropdown button is not in the tab order.
role="listbox"The popup list container has the 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.
aria-selectedIndicates the selected state.
aria-live="polite"Announces no-data state to screen readers.
idReferenced by aria-controls and aria-activedescendant on the input.
aria-autocompleteIndicates autocomplete behavior to assistive technologies
aria-activedescendantPoints to focused item when popup is open

Keyboard Navigation

TriggerBehavior
Typing in the inputFocuses the matched item.
ArrowDownHighlights the next available item.
ArrowUpHighlights the previous available item.
EnterSelects the focused item.
Alt/Opt(Mac) + ArrowDownOpens the popup.
Alt/Opt(Mac) + ArrowUp or EscapeCloses the popup.
EscapeIf the popup is not visible, clears the value.

UX Behavior

FeatureDescription
Editable inputThe user can type to filter options or enter a custom value.
PopupOpens a dropdown list when the toggle button is clicked or when the user types.
SelectionChoosing an option fills the input and closes the popup.
PlaceholderDisplays hint text when no value is selected.
Disabled stateWhen disabled, the control is non-interactive.

Testing

The Combobox has been extensively tested automatically with axe-core and manually with the most popular screen readers.

Screen Readers

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

EnvironmentTool
FirefoxNVDA
ChromeJAWS
Microsoft EdgeJAWS

Resources

Feedback