Skip to content

Commit 5913a49

Browse files
committed
docs(material/select, material/autocomplete): update a11y docs on checkmark indicators
Update the accessibility section on checkmark indicators for single-selection. Add instructions to always communicate selection with icon indicators. Fulfill documentation needs as follow-up for #25962.
1 parent 1551d52 commit 5913a49

File tree

2 files changed

+9
-0
lines changed

2 files changed

+9
-0
lines changed

src/material/autocomplete/autocomplete.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -129,3 +129,7 @@ attribute, or the `aria-labelledby` attribute.
129129

130130
`MatAutocomplete` preserves focus on the text trigger, using `aria-activedescendant` to support
131131
navigation though the autocomplete options.
132+
133+
By default, `MatAutocomplete` displays a checkmark to identify the selected item. While you can hide
134+
the checkmark indicator via `hideSingleSelectionIndicator`, this makes the component less accessible
135+
by making it harder or impossible for users to visually identify selected items.

src/material/select/select.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -165,6 +165,11 @@ this interferes with most assistive technology.
165165
Always provide an accessible label for the select. This can be done by adding a `<mat-label>`
166166
inside of `<mat-form-field>`, the `aria-label` attribute, or the `aria-labelledby` attribute.
167167

168+
By default, `MatSelect` displays a checkmark to identify selected items. While you can hide the
169+
checkmark indicator for single-selection via `hideSingleSelectionIndicator`, this makes the
170+
component less accessible by making it harder or impossible for users to visually identify selected
171+
items.
172+
168173
### Troubleshooting
169174

170175
#### Error: Cannot change `multiple` mode of select after initialization

0 commit comments

Comments
 (0)