Skip to content

Commit

Permalink
docs(material/list): update a11y documention on radio indicators
Browse files Browse the repository at this point in the history
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.
  • Loading branch information
zarend committed Jan 10, 2023
1 parent fe39362 commit 0d5c4de
Showing 1 changed file with 5 additions and 0 deletions.
5 changes: 5 additions & 0 deletions src/material/list/list.md
Expand Up @@ -213,6 +213,11 @@ these options, including buttons and anchors.
Always provide an accessible label for the `<mat-selection-list>` element via `aria-label` or
`aria-labelledby` that describes the selection being made.

By default `MatSelectionList` displays radios/checkmarks to identify selected items. While you can
hide the radio 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.

#### Custom scenarios

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

0 comments on commit 0d5c4de

Please sign in to comment.