Skip to content

Commit 49e413a

Browse files
committed
docs(material/list): update a11y documention on radio indicators
Update the accessibility section on radio indicators for single-selection. Add instructions to always communicate selection with icon indicators. Fulfill documentation needs as follow-up for angular#25933 and angular#26283.
1 parent fe39362 commit 49e413a

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

src/material/list/list.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -213,6 +213,11 @@ these options, including buttons and anchors.
213213
Always provide an accessible label for the `<mat-selection-list>` element via `aria-label` or
214214
`aria-labelledby` that describes the selection being made.
215215

216+
By default `MatSelectionList` displays radios/checkmarks to identify selected items. While you can
217+
hide the radio indicator for single-selection via `hideSingleSelectionIndicator`, this makes your
218+
component less accessible by making it harder or impossible for users to visually identify selected
219+
items.
220+
216221
#### Custom scenarios
217222

218223
By default, the list assumes that it will be used in a purely decorative fashion and thus it sets no

0 commit comments

Comments
 (0)