Skip to content

Commit 1f0feb1

Browse files
authored
docs(material/chips): update a11y documention on checkmark indicators (#26375)
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 #25890 and #26338.
1 parent 20841a8 commit 1f0feb1

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

src/material/chips/chips.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -187,3 +187,5 @@ For both MatChipGrid and MatChipListbox, always apply an accessible label to the
187187
Always apply MatChipRemove to a `<button>` element, never a `<mat-icon>` element.
188188

189189
When using MatChipListbox, never nest other interactive controls inside of the `<mat-chip-option>` element. Nesting controls degrades the experience for assistive technology users.
190+
191+
By default, `MatChipListbox` displays a checkmark to identify selected items. While you can hide the checkmark 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.

0 commit comments

Comments
 (0)