From 210a318350b8f476462e82d6a9c541fd3a896b3e Mon Sep 17 00:00:00 2001 From: Zach Arend Date: Fri, 27 Jan 2023 18:01:56 +0000 Subject: [PATCH] docs(multiple): update a11y docs on checkmark indicators For Select and Autocomplete components, update the accessibility section on heckmark indicators for single-selection. Add instructions to always communicate with icon indicators. Fulfill documentation needs as follow-up for PR #25962. --- src/material/autocomplete/autocomplete.md | 4 ++++ src/material/select/select.md | 5 +++++ 2 files changed, 9 insertions(+) diff --git a/src/material/autocomplete/autocomplete.md b/src/material/autocomplete/autocomplete.md index 8d042dce6ee2..a9c142789d4c 100644 --- a/src/material/autocomplete/autocomplete.md +++ b/src/material/autocomplete/autocomplete.md @@ -129,3 +129,7 @@ attribute, or the `aria-labelledby` attribute. `MatAutocomplete` preserves focus on the text trigger, using `aria-activedescendant` to support navigation though the autocomplete options. + +By default, `MatAutocomplete` displays a checkmark to identify the selected item. While you can hide +the checkmark indicator via `hideSingleSelectionIndicator`, this makes the component less accessible +by making it harder or impossible for users to visually identify selected items. \ No newline at end of file diff --git a/src/material/select/select.md b/src/material/select/select.md index 81e15d5d887c..a26aab612e28 100644 --- a/src/material/select/select.md +++ b/src/material/select/select.md @@ -165,6 +165,11 @@ this interferes with most assistive technology. Always provide an accessible label for the select. This can be done by adding a `` inside of ``, the `aria-label` attribute, or the `aria-labelledby` attribute. +By default, `MatSelect` displays a checkmark to identify selected items. While you can hide the +checkmark indicator for single-selection via `hideSingleSelectionIndicator`, this makes the +component less accessible by making it harder or impossible for users to visually identify selected +items. + ### Troubleshooting #### Error: Cannot change `multiple` mode of select after initialization