Skip to content

Commit 468ad3c

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 20841a8 commit 468ad3c

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 radio or checkmark indicators to identify selected items.
217+
While you can hide the radio indicator for single-selection via `hideSingleSelectionIndicator`, this
218+
makes the component less accessible by making it harder or impossible for users to visually identify
219+
selected 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)