v1.8.0
mui/base-uiv1.8.0Sep 4, 2026by github-actions[bot]
AI Summary
Version 1.8.0 focuses on performance optimization, accessibility enhancements, and bug fixes across the base UI library. Key updates include new props for Avatar and Combobox, alongside critical fixes for focus management and validation states.
Key Highlights
- Add `keepMounted` prop to `<Avatar.Image>` to improve performance and stability.
- Introduce `createItems` collection API for `<Combobox>` to simplify data handling.
- Fix roving focus issues when items are dynamically added or removed.
- Improve trigger mount performance and reduce animation completion work.
- Fix custom validity ownership and validation lifecycle in the Field component.
New Features
- `keepMounted` prop for `<Avatar.Image>`
- `createItems` collection API for `<Combobox>`
- Disabled data attribute for `<NavigationMenu.Trigger>`
- Respect trigger delay with zero provider delay for `<Tooltip>`
Full Release Notes
### General changes - Fix label association when a control unregisters (#5456) by @atomiks - Reduce animation completion work (#5535) by @atomiks - Fix prop and ref merging for lazy render elements (#5562) by @atomiks - Fix roving focus when items are added or removed (#5447) by @atomiks - Fix hover and focus interaction issues (#5037) by @atomiks - Improve trigger mount performance (#5426) by @atomiks - Fix disabled anchor tracking on scroll (#5478) by @atomiks - Fix transform origin for start/end alignment (#5015) by @atomiks - Remove duplicate options key from arrow middleware (#5606) by @atomiks - Register passive touch listeners (#5572) by @wanxiankai ### Alert Dialog - Ignore outside clicks from presses that began before open (#5378) by @michaldudak ### Autocomplete - Render groups with the rowgroup role in grid mode (#5564) by @atomiks - Allow opening and browsing the popup while `readOnly` (#5541) by @vikuscz - Move `aria-orientation` to the role owners (#5551) by @gonzoblasco - Hide group labels and scrollbars from the accessibility tree (#5598) by @azeng4499 ### Avatar - Add `keepMounted` prop to `<Avatar.Image>` (#5536) by @atomiks ### Checkbox - Fix stale and duplicated control IDs (#5457) by @atomiks - Fix controlled blur validation and stale filled state (#5563) by @atomiks ### Checkbox Group - Fix stale and duplicated control IDs (#5457) by @atomiks ### Combobox - Fix applying `data-readonly` to `<Combobox.Trigger>` (#5418) by @sai6855 - Add `createItems` collection API (#5326) by @atomiks - Fix cancellation when preserving the filter after selection (#5362) by @atomiks - Render groups with the rowgroup role in grid mode (#5564) by @atomiks - Allow opening and browsing the popup while `readOnly` (#5541) by @vikuscz - Move `aria-orientation` to the role owners (#5551) by @gonzoblasco - Fix record item label lookup reading from `Object.prototype` (#5518) by @XionWCFM - Anchor multiple selection to the first selected item with a linear lookup (#5573, #5613) by @atomiks and @michaldudak - Hide group labels and scrollbars from the accessibility tree (#5598) by @azeng4499 ### Dialog - Ignore outside clicks from presses that began before open (#5378) by @michaldudak ### Drawer - Ignore swipes without an attributed direction when using snap points (#5477) by @atomiks - Respect canceled snap point dismissal (#5571) by @radist2s - Ignore the page scroller when starting a swipe (#5567) by @flaviendelangle ### Field - Fix custom validity ownership and validation lifecycle (#5449) by @atomiks - Sync controlled value changes with field state (#5460) by @atomiks - Fix stale and duplicated control IDs (#5457) by @atomiks - Validate once on Enter inside a Form (#5459) by @atomiks - Publish neutral validity while async validation is in flight (#5600) by @atomiks - Fix controlled blur validation and stale filled state (#5563) by @atomiks ### Form - Fix `clearErrors` dropping updates when multiple fields change at once (#5446) by @sai6855 ### Menu - Play the enter transition for an initially open submenu (#4383) by @michaldudak - Move `aria-orientation` to the role owners (#5551) by @gonzoblasco - Hide group labels and scrollbars from the accessibility tree (#5598) by @azeng4499 ### Menubar - Fix menubar accessibility tree to satisfy `aria-required-children` (#5058) by @michaldudak ### Navigation Menu - Fix pointer-events lock when sweeping quickly across a trigger (#5454) by @edwardhorsey - Keep focus on trigger when opening (#5479) by @atomiks - Add disabled data attribute to `<NavigationMenu.Trigger>` (#5521) by @sai6855 ### Number Field - Stop incrementing when disabled during press-and-hold (#5435) by @alex-js-ltd - Prevent scrubbing on horizontal wheel events (#5463) by @sai6855 - Preserve native and consumer-controlled selection when focusing the input (#5578, #5619) by @atomiks ### Popover - Ignore outside clicks from presses that began before open (#5378) by @michaldudak - Fix detached trigger store migration (#5442) by @atomiks ### Scroll Area - Hide group labels and scrollbars from the accessibility tree (#5598) by @azeng4499 - Prevent scrollbars from stealing focus (#5430) by @marwenilo ### Select - Move `aria-orientation` to the role owners (#5551) by @gonzoblasco - Anchor multiple selection to the first selected item with a linear lookup (#5573, #5613) by @atomiks and @michaldudak - Hide group labels and scrollbars from the accessibility tree (#5598) by @azeng4499 - Fix the root ID being ignored inside a Field (#5461) by @atomiks - Remove redundant size check in `<Select.Positioner>` (#5469) by @sai6855 - Allow opening and browsing the popup while `readOnly` (#5531) by @vikuscz - Fix record item label lookup reading from `Object.prototype` (#5518) by @XionWCFM ### Slider - Prevent update loops from unstable refs (#5441) by @atomiks ### Switch - Fix controlled blur validation and stale filled state (#5563) by @atomiks ### Tabs - Prevent update loops from unstable refs (#5441) by @atomiks - Consider 3D transforms when positioning the indicator (#4852) by @michaldudak ### Toast - Allow functional toast updates derived from the current toast (#5464, #5611, #5629) by @chuganzy and @michaldudak ### Tooltip - Respect trigger delay with zero provider delay (#5444) by @atomiks All contributors of this release in alphabetical order: @alex-js-ltd, @atomiks, @azeng4499, @chuganzy, @edwardhorsey, @flaviendelangle, @gilsmt, @gonzoblasco, @jjenzz, @marwenilo, @michaldudak, @radist2s, @sai6855, @vikuscz, @wanxiankai, @XionWCFM