[filter menu][filter select] Add filterable menu and select components by jjenzz · Pull Request #5490 · mui/base-ui

jjenzz · 2026-08-13T19:53:40Z

Adds dedicated FilterMenu and FilterSelect entry points for trigger-first popups that filter existing Menu and Select collections.

FilterSelect is the v1 replacement for the Select-style Combobox “input inside popup” pattern, including multiple selection. It does not replace editable/input-first Comboboxes or token-field/chip presentation.

Changes

Adds separate FilterMenu and FilterSelect entry points (instead of expanding the plain Menu and Select APIs with filtering props).
Supports labels, keywords, controlled/uncontrolled queries, and custom filters. FilterSelect custom filters receive the original item data.
Preserves Menu action patterns, groups, and submenus, with virtual-focus handling.
Documents the component boundary and removes the superseded Combobox input-inside-popup example.

Preview

netlify · 2026-08-13T19:57:52Z

✅ Deploy Preview for base-ui ready!

Name	Link
🔨 Latest commit	`d774d97`
🔍 Latest deploy log	https://app.netlify.com/projects/base-ui/deploys/6a840596ee94fd00088a5a68
😎 Deploy Preview	https://deploy-preview-5490--base-ui.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

code-infra-dashboard · 2026-08-13T20:01:20Z

Bundle size

Bundle	Parsed size	Gzip size
@base-ui/react	🔺+6.83KB^(+1.51%)	🔺+2.3KB^(+1.55%)

Details of bundle changes

Performance

Total duration: 1,095.78 ms -170.46 ms^(-13.5%) | Renders: 92 ⁽⁺⁰⁾ | Paint: 1,792.86 ms -321.88 ms^(-15.2%)

Test	Duration	Renders
Scroll Area mount (300 instances)	66.82 ms ▼-18.06 ms^(-21.3%)	3 ⁽⁺⁰⁾
Dialog mount (300 instances)	22.92 ms ▼-12.38 ms^(-35.1%)	1 ⁽⁺⁰⁾
Select open (500 options)	46.12 ms ▼-11.67 ms^(-20.2%)	14 ⁽⁺⁰⁾
Combobox open — 500 items	26.08 ms ▼-10.04 ms^(-27.8%)	4 ⁽⁺⁰⁾

11 tests within noise — details

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

pkg-pr-new · 2026-08-13T21:19:00Z

base-ui-tanstack-start

vite-css-base-ui-example

pnpm add https://pkg.pr.new/mui/base-ui/@base-ui/react@5490

pnpm add https://pkg.pr.new/mui/base-ui/@base-ui/utils@5490

commit: d774d97

…ct and render menus from items

…machinery

…terable select

… redirect

…and group hiding

Move submenu entry, exit, and focus-return behaviour into `MenuSubmenuRoot` so `Menu` owns cross-list coordination. Keep `useListNavigation` generic and focused on navigation within a single list, with explicit data-down/actions-up boundaries and one source of truth for submenu focus restoration.

…s on navigation

…itioning regressions

…c type regressions

jjenzz added the experiments label Aug 13, 2026

github-actions Bot added the PR: out-of-date The pull request has merge conflicts and can't be merged. label Aug 13, 2026

jjenzz force-pushed the codex/filterable-menu-standalone branch 2 times, most recently from 634315d to a04a95b Compare August 13, 2026 20:31

jjenzz added the type: new feature Expand the scope of the product to solve a new problem. label Aug 13, 2026

github-actions Bot removed the PR: out-of-date The pull request has merge conflicts and can't be merged. label Aug 13, 2026

jjenzz force-pushed the codex/filterable-menu-standalone branch from ce850d8 to 00bedbc Compare August 13, 2026 21:59

github-actions Bot added the PR: out-of-date The pull request has merge conflicts and can't be merged. label Aug 17, 2026

atomiks changed the title ~~[filter-menu][filter-select] New filterable comps (wip)~~ [filter menu][filter select] Add filterable menu and select components Aug 18, 2026

jjenzz and others added 18 commits August 18, 2026 16:51

add item registry hook

0e50aaa

tree-shakeable filters

4d6bacd

filter dropdown

307a051

select

2e159fc

menu

df820b2

update error codes

24af6e9

[select][menu] Address filterable variants review

e8150d1

[combobox] Fix grid navigation swallowed by cross-axis key forwarding

a6d806c

[select] Make items the data source for the list

13d3a3e

[docs] Regenerate components index for the Select items section

02fc3dd

[select][menu] Make filter props composable in typed wrappers

2f8b850

[docs] Add Select.Collection reference section

10f1409

[menu] Fix VoiceOver accessibility

80238ab

[menu] Split filtering into a filterable-menu entrypoint

8304baf

[select] Split filtering into a filterable-select entrypoint

10d7d0f

[menu][select] Rename filterable entrypoints to FilterMenu/FilterSele…

0544363

…ct and render menus from items

[menu][select] Require items for filtering and drop the DOM matching …

6bd394e

…machinery

[select] Highlight and scroll to the selected item when opening a fil…

b1594d2

…terable select

atomiks and others added 24 commits August 18, 2026 16:58

[menu][select] Ignore focus-guard traversal in the filter popup focus…

28d094a

… redirect

[menu][select] Author filterable menus as JSX children with keywords …

94eda4d

…and group hiding

[select] Wait for focus in the open-highlight test

4bea763

[popups] Revert focus restoration gate and drop a flaky filter menu test

1fb79e0

[select][menu] improve a11y

707d79e

[menu] Keep the keyboard-open focus ring on the filter input

2efa312

[menu][select] Move WebKit virtual focus onto the list element

90904bd

[menu][select] Drop aria-orientation from the filterable popup dialog

a6dcf3c

[menu][select] Make the filter list a tab stop instead of moving focu…

4939dbe

…s on navigation

[menu] Stop hiding the filterable list from assistive technology

232d6c0

[wip] standalone comps

f521269

[filter menu][select] Fix filterable submenu navigation and touch pos…

3945a0c

…itioning regressions

[filter menu][filter select] Reimplement filterable navigation

34838d4

[filter menu] Fix input and submenu focus

5f48834

[filter menu][filter select] Fix filter interactions

c3ba2de

[filter menu][filter select] Fix filtered popup transitions

0d7fa70

[filter menu][filter select] Fix focus modality and submenu navigation

c349876

[filter menu][filter select] Fix CI verification

3d5c91d

[filter menu][filter select][menu][select] Fix ARIA, focus, and publi…

097f971

…c type regressions

[filter-menu] Fix review regressions

795db3e

[filter-menu] Fix remaining review regressions

3cdd649

[filter-menu] Add spacing after prop destructuring

de04678

[filter menu][filter select] Address review findings

d774d97

atomiks force-pushed the codex/filterable-menu-standalone branch from 3715077 to d774d97 Compare August 18, 2026 07:11

github-actions Bot removed the PR: out-of-date The pull request has merge conflicts and can't be merged. label Aug 18, 2026

atomiks mentioned this pull request Aug 18, 2026

[filter menu] Add filterable menu component #5527

Open

github-actions Bot added the PR: out-of-date The pull request has merge conflicts and can't be merged. label Aug 19, 2026

jjenzz added poc and removed experiments labels Aug 20, 2026

Navigation Menu

Uh oh!

Uh oh!

[filter menu][filter select] Add filterable menu and select components - #5490

[filter menu][filter select] Add filterable menu and select components#5490
jjenzz wants to merge 46 commits into
mui:masterfrom
jjenzz:codex/filterable-menu-standalone

jjenzz commented Aug 13, 2026 •

edited by atomiks

Loading

Uh oh!

netlify Bot commented Aug 13, 2026 •

edited

Loading

Uh oh!

code-infra-dashboard Bot commented Aug 13, 2026 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented Aug 13, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Uh oh!

Conversation

jjenzz commented Aug 13, 2026 • edited by atomiks Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Preview

Uh oh!

netlify Bot commented Aug 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for base-ui ready!

Uh oh!

code-infra-dashboard Bot commented Aug 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundle size

Performance

Uh oh!

pkg-pr-new Bot commented Aug 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

jjenzz commented Aug 13, 2026 •

edited by atomiks

Loading

netlify Bot commented Aug 13, 2026 •

edited

Loading

code-infra-dashboard Bot commented Aug 13, 2026 •

edited

Loading

pkg-pr-new Bot commented Aug 13, 2026 •

edited

Loading