Skip to content

[docs][autocomplete] Add removal and navigation aria descriptions to Chip examples - #49086

Open
silviuaavram wants to merge 1 commit into
mui:masterfrom
silviuaavram:docs/improve-autocomplete-chips-a11y
Open

[docs][autocomplete] Add removal and navigation aria descriptions to Chip examples#49086
silviuaavram wants to merge 1 commit into
mui:masterfrom
silviuaavram:docs/improve-autocomplete-chips-a11y

Conversation

@silviuaavram

@silviuaavram silviuaavram commented Sep 4, 2026

Copy link
Copy Markdown
Member

Starting from mui/base-ui#5628, we are applying the same improvements to Material UI's Autocomplete Chips examples.

  • input should narrate that Arrow Left is used to navigate to selected options
  • chips should narrate that Backspace and Delete should be used to remove them

@silviuaavram
silviuaavram requested review from ZeeshanTamboli and siriwatknp and a lite review from Copilot September 4, 2026 08:23
@silviuaavram silviuaavram added docs Improvements or additions to the documentation. accessibility a11y scope: autocomplete Changes related to the autocomplete. This includes ComboBox. labels Sep 4, 2026
@silviuaavram silviuaavram changed the title [docs][autocomplete] Add removal and navigation aria descriptions to … [docs][autocomplete] Add removal and navigation aria descriptions to Chip examples Sep 4, 2026
@code-infra-dashboard

Copy link
Copy Markdown

Deploy preview

Bundle size

Bundle Parsed size Gzip size
@mui/material 0B(0.00%) 0B(0.00%)
@mui/lab 0B(0.00%) 0B(0.00%)
@mui/private-theming 0B(0.00%) 0B(0.00%)
@mui/system 0B(0.00%) 0B(0.00%)
@mui/utils 0B(0.00%) 0B(0.00%)

Details of bundle changes


Check out the code infra dashboard for more information about this PR.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The changes are localized to docs demos and consistently apply the intended aria-description guidance without introducing functional or type issues in the reviewed code.

Pull request overview

This PR improves accessibility in the Material UI Autocomplete “chips/tags” documentation demos by adding screen reader guidance for (1) navigating from the input to selected chips and (2) removing chips via keyboard.

Changes:

  • Adds aria-description to selected chips (via slotProps.chip or explicit <Chip aria-description=... />) to announce Backspace/Delete removal behavior.
  • Adds aria-description to the underlying input (slotProps.htmlInput) to announce Arrow Left navigation to selected items when at least one item is selected.
  • Updates several demos from defaultValue to controlled value + onChange so the narrated “N selected” count stays accurate.
File summaries
File Description
docs/data/material/components/autocomplete/Tags.tsx Adds input + chip aria-description and controlled state to keep selected-count narration accurate.
docs/data/material/components/autocomplete/Tags.js JS equivalent of the Tags demo a11y + state updates.
docs/data/material/components/autocomplete/Sizes.tsx Adds a11y descriptions to the multi-select “sizes” variants and controls value for accurate narration.
docs/data/material/components/autocomplete/Sizes.js JS equivalent of the Sizes demo a11y + state updates.
docs/data/material/components/autocomplete/LimitTags.tsx.preview Updates preview snippet to match the new controlled-value demo API usage.
docs/data/material/components/autocomplete/LimitTags.tsx Adds chip/input aria-description and controlled state to keep selected-count narration accurate.
docs/data/material/components/autocomplete/LimitTags.js JS equivalent of the LimitTags demo a11y + state updates.
docs/data/material/components/autocomplete/FixedTags.tsx Adds conditional chip removal narration (only for removable chips) plus input selected-count narration.
docs/data/material/components/autocomplete/FixedTags.js JS equivalent of the FixedTags demo a11y updates.
docs/data/material/components/autocomplete/CheckboxesTags.tsx Adds chip/input aria-description and controlled value to support accurate selected-count narration.
docs/data/material/components/autocomplete/CheckboxesTags.js JS equivalent of the CheckboxesTags demo a11y + state updates.
docs/data/material/components/autocomplete/autocomplete.md Documents the recommended aria-description additions and translation guidance.
Review details
  • Files reviewed: 12/12 changed files
  • Comments generated: 0
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

accessibility a11y docs Improvements or additions to the documentation. scope: autocomplete Changes related to the autocomplete. This includes ComboBox.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants