diff --git a/examples/combobox/combobox-select-only.html b/examples/combobox/combobox-select-only.html index c470f4d8b5..e4b48c4aeb 100644 --- a/examples/combobox/combobox-select-only.html +++ b/examples/combobox/combobox-select-only.html @@ -67,6 +67,23 @@

Example

+
+

Accessibility Features

+

While the functionality and user experience of this example are nearly equivalent to an HTML select element with the attribute size="1", the following differences in behavior are implemented to improve both accessibility and general usability.

+
    +
  1. + If the combobox is collapsed and the user types printable characters, the listbox is displayed and receives accessibility focus via aria-activedescendant. + This enables users to perceive the presence of the options, and enables assistive technology users to comprehend the size of the list of options. +
  2. +
  3. + Navigating the list of options does not set the value of the input. + This gives screen reader users, who need to navigate among the options to perceive them, the ability to explore options without losing the current value of the input. + The value is set when users press Space, Enter, or Tab, or when focus moves out of the combobox. + The current value is retained if the listbox is closed with Escape or if the user collapses the list by clicking the input. +
  4. +
+
+

Keyboard Support