Change Details

* Using NVDA screen reader while typing into the EntityLookup, there is no announcement when new results are available * it appears that pressing the down-arrow key with NVDA doesn't let the user select the options? * when using JAWS, selecting options with the arrow keys seemed to have worked * VoiceOver on MacOS does not announce the content of the Lookup menu items

| **Component** | **Issue** | **Possible solutions** | | -- | -- | -- | | Lookup | When the lookup component is focused, screen readers (VoiceOver) currently announce: "//You are currently on a text field. To enter text in this field, type//", which is incorrect. Users should be aware that they need to type text to display a list of choices. | 1. Apply the right role attribute (combobox?) to the component, use `aria-autocomplete="list"`, `aria-haspopup="listbox"`, `aria-owns="#IDREF"`, `aria-activedescendant="IDREF"` and `aria-expanded` (true/false) or so the right component and instructions are announced to users. 2. Use live regions to let users know how many results are available. (See [[ https://www.w3.org/TR/2019/NOTE-wai-aria-practices-1.1-20190814/examples/combobox/aria1.0pattern/combobox-autocomplete-list.html | WAI-ARIA example ]]) | OptionsMenu | (In VoiceOver) The content of the menu is announced as “text”: the existence of selectable options and how to navigate to them or select them is not stated. Options are not announced by screen readers when users navigate through them (see Details below)| Apply `role="listbox"` and an `aria-label` to the menu component, and the `role="option"` and `aria-selected="true"`(when applicable) to the menu options. (See [[ https://www.w3.org/TR/2019/NOTE-wai-aria-practices-1.1-20190814/examples/combobox/aria1.0pattern/combobox-autocomplete-list.html| WAI-ARIA example ]]) **Details**: * Using NVDA screen reader while typing into the EntityLookup, there is no announcement when new results are available * it appears that pressing the down-arrow key with NVDA doesn't let the user select the options? * when using JAWS, selecting options with the arrow keys seemed to have worked * VoiceOver on MacOS does not announce the content of the Lookup menu items

| **Component** | **Issue** | **Possible solutions** | | -- | -- | -- | | Lookup | When the lookup component is focused, screen readers (VoiceOver) currently announce: "//You are currently on a text field. To enter text in this field, type//", which is incorrect. Users should be aware that they need to type text to display a list of choices. | 1. Apply the right role attribute (combobox?) to the component, use `aria-autocomplete="list"`, `aria-haspopup="listbox"`, `aria-owns="#IDREF"`, `aria-activedescendant="IDREF"` and `aria-expanded` (true/false) or so the right component and instructions are announced to users. 2. Use live regions to let users know how many results are available. (See [[ https://www.w3.org/TR/2019/NOTE-wai-aria-practices-1.1-20190814/examples/combobox/aria1.0pattern/combobox-autocomplete-list.html | WAI-ARIA example ]]) | OptionsMenu | (In VoiceOver) The content of the menu is announced as “text”: the existence of selectable options and how to navigate to them or select them is not stated. Options are not announced by screen readers when users navigate through them (see Details below)| Apply `role="listbox"` and an `aria-label` to the menu component, and the `role="option"` and `aria-selected="true"`(when applicable) to the menu options. (See [[ https://www.w3.org/TR/2019/NOTE-wai-aria-practices-1.1-20190814/examples/combobox/aria1.0pattern/combobox-autocomplete-list.html| WAI-ARIA example ]]) **Details**: * Using NVDA screen reader while typing into the EntityLookup, there is no announcement when new results are available * it appears that pressing the down-arrow key with NVDA doesn't let the user select the options? * when using JAWS, selecting options with the arrow keys seemed to have worked * VoiceOver on MacOS does not announce the content of the Lookup menu items