Skip to content

[docs] Overhaul autocomplete docs and demos#48470

Draft
mj12albert wants to merge 7 commits into
mui:masterfrom
mj12albert:docs-refresh-autocomplete-docs
Draft

[docs] Overhaul autocomplete docs and demos#48470
mj12albert wants to merge 7 commits into
mui:masterfrom
mj12albert:docs-refresh-autocomplete-docs

Conversation

@mj12albert
Copy link
Copy Markdown
Member

@mj12albert mj12albert commented May 4, 2026

Preview: https://deploy-preview-48470--material-ui.netlify.app/material-ui/react-autocomplete/

This doc got messy over time, I revised the content and demos:

  • Reorganized the headings around the main interaction modes: combobox, multiple-selection, freeSolo
  • Added "Usage guidelines" which also replaces the "Accessibility" section, putting a11y guidance as the last section of the doc makes it look like a low priority thing. This is in the spirit of [docs] Add Accessibility section to all component demo pages #20600 but "Usage…" is better as it's more general and gives us room to include other important info here that may not necessarily be directly a11y related
  • Consolidated a lot of sections under "Customization"

Demo changes:

  • Replaced some demos with code snippets instead as it shows the concept better (hook setup, props and ref forwarding with a custom input element)
  • Country selects: replaced the png flags with svg
  • Single value rendering: changed the design, it's confusing to see "single value" in the title, but then see a demo that visually looks identical to a multi-select autocomplete
  • Github picker: updated to look like the current GH design
  • react-window demo: polished the implementation, added aria-posinset/aria-setsize (re: Autodesk)
  • They all use shared data when possible (the movies or countries dataset), no need to duplicate the IMDB data across so many demos. Also updated the IMDB top 100 dataset itself)

@mj12albert mj12albert added the docs Improvements or additions to the documentation. label May 4, 2026
@code-infra-dashboard
Copy link
Copy Markdown

code-infra-dashboard Bot commented May 4, 2026

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.

@mj12albert mj12albert force-pushed the docs-refresh-autocomplete-docs branch 2 times, most recently from 73b43e2 to f3af2f0 Compare May 4, 2026 19:28
@github-actions github-actions Bot added the PR: out-of-date The pull request has merge conflicts and can't be merged. label May 11, 2026
@mj12albert mj12albert force-pushed the docs-refresh-autocomplete-docs branch from f3af2f0 to 29c346d Compare May 12, 2026 21:25
@github-actions github-actions Bot removed the PR: out-of-date The pull request has merge conflicts and can't be merged. label May 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to the documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant