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 5c5e1bb
Showing 1 changed file with 4 additions and 0 deletions.
4 changes: 4 additions & 0 deletions src/material/list/list.md
Expand Up @@ -213,6 +213,10 @@ 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 radio/checkmark to identify selected items. While you can
hide the radio indicator via `hideSingleSelectionIndicator`, this makes your 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 5c5e1bb

Please sign in to comment.