Releases: mui/mui-x
v7.28.1
We'd like to offer a big thanks to the 4 contributors who made this release possible. Here are some highlights ✨:
- 🐞 Bugfixes
Special thanks go out to the community contributors who have helped make this release possible:
@jyash97, @nusr.
Following are all team members who have contributed to this release:
@arminmeh, @KenanYusuf.
Data Grid
@mui/[email protected]
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
- [DataGridPro] Fix header select checkbox state with
checkboxSelectionVisibleOnly
andpaginationMode="server"
(@arminmeh) (#17032)
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
- [DataGridPremium] Update column state correctly when grouping mode is updated with one grouping column (@arminmeh) (#17074)
Tree View
@mui/[email protected]
Internal changes.
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
Docs
- [docs] Fix Data Grid advanced list view demo (@KenanYusuf) (#17066)
- [docs] Fix custom detail panel toggle state update (@nusr) (#17018)
v8.0.0-beta.0

We'd like to offer a big thanks to the 21 contributors who made this release possible. Here are some highlights ✨:
- 🚀 Add Time Range Picker component
- 🎁 Add support for
@mui/material
version 7 in all X packages - 🐞 Bugfixes
- 🌍 Improve Chinese (zh-CN), (zh-HK), (zh-TW), Czech (cs-CZ), Korean (ko-KR) and Slovak (sk-Sk) locales on the Data Grid
- 🌍 Improve Chinese (zh-CN), (zh-HK) and (zh-TW) locales on the Pickers
Breaking changes
- ℹ️ The peer dependency on
@mui/material
has been updated to accept only v7.
This has been done to increase the adoption rate of ESM.
Since only v7 of@mui/material
has proper ESM support, we decided to help with its adoption and fix numerous issues using X packages in environments where transpiling is not an option.
Special thanks go out to the community members for their valuable contributions:
@Blake-McCullough, @hlavacz, @k-rajat19, @layerok, @nusr, @owais635, @yelahj.
Following are all team members who have contributed to this release:
@alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @DiegoAndai, @flaviendelangle, @Janpot, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi, @michelengelen, @noraleonte, @romgrk.
Alpha release highlights
Below are the highlights of the alpha releases leading up to this beta release:
-
⚛️ React 19 support.
-
🛠️ New and improved Data Grid Toolbar component.
-
📦 Data Grid data source is now available in the Community plan.
-
🚫 Add "No columns" overlay to Data Grid.
-
🍬 Improved design for Data Grid Header filters.
-
🔄 Add Data Grid Scroll restoration.
-
💫 Support aggregation with server-side data.
-
🎁 Support Server-side lazy loading on the Data Grid.
-
🎯 Improved data caching.
-
🏎️ Improve Data Grid aggregation, Excel export serialization, mount, resize and scrolling performance.
-
🎨 Improve Data Grid theming and add default background color.
-
📊 New Pro chart: Funnel.
-
📊 New Community chart: Radar is available in preview for testing.
-
📊 Charts legend is now an HTML element which can be styled more easily.
-
📊 Create custom HTML components using chart data.
-
📊 Refactor Charts Tooltip customization.
-
📊 Improve Charts composition.
-
📊 Charts support server-side rendering under some conditions.
-
📊 Add a new API to support multiple axes (decouple
margin
andaxis-size
) -
🔁 Support automatic parents and children selection for the Rich Tree View components.
Data Grid
@mui/[email protected]
- [DataGrid] Add a slot for unsort icon in column menu (#16918) @layerok
- [DataGrid] Add click propagation and prevents default on
toggleMenu
click (#16845) @michelengelen - [DataGrid] Anchor preference panel to columns/filter trigger (#16953) @KenanYusuf
- [DataGrid] Fix
QuickFilter
debounce overriding input value (#16856) @KenanYusuf - [DataGrid] Fix
printOptions
not respectinghideFooter
root prop (#14863) @k-rajat19 - [DataGrid] Fix
processRowUpdate()
error if the row is removed before it is executed (#16741) @arminmeh - [DataGrid] Fix bug with adding and removing columns in active edit state (#16888) @Blake-McCullough
- [DataGrid] Fix columns update not restoring column definition defaults (#16970) @cherniavskii
- [DataGrid] Fix page scrolling when preference panel is opened (#17004) @KenanYusuf
- [DataGrid] Fix visual issue with pinned columns and row spanning (#16923) @MBilalShafi
- [DataGrid] Make column header menu button aria-labels unique (#16796) @owais635
- [DataGrid] Refactor: create base Pagination (#16759) @romgrk
- [DataGrid] Update CSS variable naming convention to singular (#16993) @KenanYusuf
- [DataGrid] Use Material UI CSS vars (#16962) @KenanYusuf
- [l10n] Improve Chinese (zh-CN), (zh-HK) and (zh-TW) locales (#15230, #16898 and #16966) @nusr
- [l10n] Improve Czech (cs-CZ) and Slovak (sk-Sk) locales (#16968) @hlavacz
- [l10n] Improve Korean (ko-KR) locale (#16807) @yelahj
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
- [DataGridPro] Fix header filters not displaying restored values (#16855) @MBilalShafi
- [DataGridPro] Fix infinite loading not reacting when scrolling to the end (#16926) @arminmeh
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
- [DataGridPremium] Fix selection propagation issues with controlled state (#16810) @MBilalShafi
Date and Time Pickers
Breaking changes
- The
useClearableField
hook has been removed.
The custom field component now receives theclearable
andonClear
props — Learn more. - The
ExportedUseClearableFieldProps
,UseClearableFieldSlots
,UseClearableFieldSlotProps
, andUseClearableFieldResponse
types have been removed — Learn more.
@mui/[email protected]
- [l10n] Improve Chinese (zh-CN), (zh-HK) and (zh-TW) locales (#16966) @nusr
- [pickers] Add the Time Range Picker component (#9431) @LukasTy and @flaviendelangle
- [pickers] Add valid aria labels to the range picker opening button (#16799) @flaviendelangle
- [pickers] Always use
props.value
as the source of truth when defined (#16853) @flaviendelangle - [pickers] Avoid passing unexpected
focusedView
to time renderers (#16869) @LukasTy - [pickers] Improve JSDoc (#16858) @flaviendelangle
- [pickers] Remove
useClearableField
hook (#16859) @LukasTy
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
- [DateRangeCalendar] Do not update the previewed day when hovering a day and the value is empty (#16892) @flaviendelangle
- [TimeRangePicker] Shift popper between start and end input on multi input field (#16920) @LukasTy
Charts
Breaking changes
- Tick labels in the x-axis of cartesian charts will now have an ellipsis applied to prevent overflow.
If your tick labels are being clipped sooner than you would like, you can increase the x-axis size by increasing itsheight
property.
The default line-height has also been changed to 1.25, so if you aren't customizing the line height for x-axis tick labels, make sure to double check if the result is desirable.
@mui/[email protected]
- [charts] Add axis highlight to the radar (#16868) @alexfauquette
- [charts] Add radar labels (#16839) @alexfauquette
- [charts] Allow breaking line for radar labels (#16947) @alexfauquette
- [charts] Allow circular grid on radar chart (#16870) @alexfauquette
- [charts] Allow customizing shape in scatter charts (#16640) @bernardobelchior
- [charts] Avoid spreading props in demos (#16857) @bernardobelchior
- [charts] Fix React 18 tests failing due to missing
forwardRef
(#16894) @bernardobelchior - [charts] Fix line highlight position with RTL (#16994) @alexfauquette
- [charts] Fix interaction performance (#16897) @JCQuintas
- [charts] Fix x-axis tick label overflow (#16709) @bernardobelchior
- [charts] Grid support time step below 1s (#16957) @alexfauquette
- [charts] Improve radar slice (#16932) @alexfauquette
- [charts] Radar add option to highlighting series (#16940) @alexfauquette
- [charts] Refactor zoom
isInteracting
behavior directly to community code (#16999) @JCQuintas - [charts] Remove
fireEvent
usage from tests (#17006) @JCQuintas - [charts] Remove dead voronoi code (#16886) @JCQuintas
- [charts] Remove the polar axis plugin from the default plugins of the ChartContainer (#16936) @alexfauquette
- [charts] Rename
useIsClient
(#16937) @bernardobelchior
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Tree View
@mui/[email protected]
Internal changes.
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Docs
v7.28.0
We'd like to offer a big thanks to the 10 contributors who made this release possible. Here are some highlights ✨:
- 🎁 Add support for
@mui/material
version 7 in all X packages - 🐞 Bugfixes
- 🌍 Improve Chinese (zh-CN), (zh-HK), (zh-TW), Czech (cs-CZ), Korean (ko-KR) and Slovak (sk-Sk) locales on the Data Grid
- 🌍 Improve Chinese (zh-CN), (zh-HK) and (zh-TW) locales on the Pickers
Special thanks go out to the community contributors who have helped make this release possible:
@Blake-McCullough, @hlavacz, @yelahj, @k-rajat19, @nusr.
Following are all team members who have contributed to this release:
@arminmeh, @flaviendelangle, @LukasTy, @michelengelen, @MBilalShafi.
Data Grid
@mui/[email protected]
- [DataGrid] Add click propagation and prevents default on
toggleMenu
click (#16909) @michelengelen - [DataGrid] Fix
processRowUpdate()
error if the row is removed before it is executed (#16904) @arminmeh - [DataGrid] Fix bug with adding and removing columns in active edit state (#16916) @Blake-McCullough
- [DataGrid] Fix visual issue with pinned columns and row spanning (#16942) @MBilalShafi
- [DataGrid] Make column header menu button aria-labels unique (#16925) @owais635
- [DataGrid] Fix
printOptions
not respectinghideFooter
root prop (#16915) @k-rajat19 - [l10n] Improve Chinese (zh-CN), (zh-HK) and (zh-TW) locales (#16917 and #16887) @nusr
- [l10n] Improve Czech (cs-CZ) and Slovak (sk-Sk) locales (#16996) @hlavacz
- [l10n] Improve Korean (ko-KR) locale (#16998) @yelahj
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
- [DataGridPro] Fix header filters not displaying restored values (#16976) @MBilalShafi
- [DataGridPro] Fix infinite loading not reacting when scrolling to the end (#16939) @arminmeh
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
- [DataGridPremium] Fix selection propagation issues with controlled state (#16995) @MBilalShafi
Date and Time Pickers
@mui/[email protected]
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
- [DateRangeCalendar] Do not update the previewed day when hovering a day and the value is empty (#16892) @flaviendelangle
Charts
@mui/[email protected]
Internal changes.
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Tree View
@mui/[email protected]
Internal changes.
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Docs
Core
v8.0.0-alpha.14
We'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
- 🚀📊 New Pro Chart: It is now possible to create Funnel charts—perfect for visualizing conversions, sales pipelines and more!
- 🎁 The first iteration of the radar chart is available. Features and refinements will be added in the coming weeks.
- 🛠️ New and improved Toolbar component for the data grid
- 🐞 Bugfixes
Special thanks go out to the community member for their valuable contributions:
@vadimka123.
Following are all team members who have contributed to this release:
@alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @flaviendelangle, @JCQuintas, @KenanYusuf, @LukasTy, @michelengelen, @noraleonte, @oliviertassinari.
Data Grid
Breaking changes
- The density selector has been removed from the toolbar. It is still possible to set the density programmatically via the
density
prop. A density selector can be added to a custom toolbar passed toslots.toolbar
. See Toolbar component—Settings menu for an example. - The quick filter is now shown in the toolbar by default. Use
slotProps={{ toolbar: { showQuickFilter: false } }}
to hide it. - The
<GridSaveAltIcon />
icon is not exported anymore. ImportSaveAlt
from@mui/icons-material
instead.
@mui/[email protected]
- [DataGrid] Fix
aria-hidden
console error when scrollbar is dragged (#16829) @arminmeh - [DataGrid] Fix scroll jump with dynamic row height (#16763) @cherniavskii
- [DataGrid] New
<Toolbar />
component (#14611) @KenanYusuf - [DataGrid] Use new toolbar by default (#16814) @KenanYusuf
- [DataGrid] Remove the quick filtering on a given column (#16738) @vadimka123
@mui/[email protected]

Same changes as in @mui/[email protected]
.
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Date and Time Pickers
Breaking changes
- All Date Time Picker variants now use Digital Clock for time editing.
- Stop passing invalid date to
onChange
when the date is partially filled — Learn more.
@mui/[email protected]
- [DateTimePicker] Use Digital Clock in all component variants (#16678) @LukasTy
- [fields] Always use
props.value
as the source of truth when defined (#15875) @flaviendelangle - [fields] Fix Fields aria relationship with
helperText
(#16821) @LukasTy - [pickers] Add
TValidationProps
generic to thePickerManager
interface (#16832) @flaviendelangle - [pickers] Fix
edge
property setting in different button position cases (#16838) @LukasTy - [pickers] Fix typo in JSDoc (#16831) @flaviendelangle
- [pickers] Refactor the files in the
usePicker
folder (#16680) @flaviendelangle
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Charts
@mui/[email protected]
- [charts] Fix
undefined
behaving differently from missing value for axis size (#16844) @bernardobelchior - [charts] Fix x-axis text anchor default when language is RTL (#16836) @bernardobelchior
- [charts] Add Radar chart (#16406) @alexfauquette
- [charts] Move series default color generation in the series config (#16752) @alexfauquette
- [charts] Render axis title within axis size (#16730) @bernardobelchior
- [charts] Split
defaultizeAxis
function into two (#16745) @bernardobelchior - [charts] Warn if axes data don't have enough elements (#16830) @alexfauquette
- [charts] XAxis: Add defaults for
textAnchor
anddominantBaseline
based onangle
(#16817) @bernardobelchior
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
- [charts] Add Funnel chart (#14804) @JCQuintas
Tree View
Breaking changes
-
The
selectItem
method has been renamedsetItemSelection
:const { publicAPI } = useTreeItemUtils(); const handleSelectItem() { - publicAPI.selectItem({ event, itemId: props.itemId, shouldBeSelected: true }) + publicAPI.setItemSelection({ event, itemId: props.itemId, shouldBeSelected: true }) }
-
The
setItemExpansion
method now receives a single object instead of a list of parameters:const { publicAPI } = useTreeItemUtils(); const handleExpandItem() { - publicAPI.setItemExpansion(event, props.itemId, true) + publicAPI.setItemExpansion({ event, itemId: props.itemId, shouldBeExpanded: true }) }
@mui/[email protected]
- [TreeView] Clean the expansion and selection API methods (#16795) @flaviendelangle
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Docs
- [docs] Fix padding package install on mobile (#16794) @oliviertassinari
- [docs] Typo fixes (#16835) @alexfauquette
Core
- [code-infra] Fix console warning in telemetry package (#16816) @JCQuintas
- [code-infra] Split date-picker test files (#16825) @JCQuintas
- [infra] Replace PR label check workflow with reusable version (#16762) @michelengelen
- [infra] Update label in priority-support issue template (#16767) @michelengelen
- [test] Add timeout to flaky screenshot tests (#16852) @LukasTy
v7.27.3
We'd like to offer a big thanks to the 4 contributors who made this release possible. Here are some highlights ✨:
- 🐞 Bugfixes
Team members who have contributed to this release:
@arminmeh, @cherniavskii, @LukasTy, @michelengelen.
Data Grid
@mui/[email protected]
- [DataGrid] Fix
aria-hidden
console error when scrollbar is dragged (#16834) @arminmeh - [DataGrid] Fix scroll jump with dynamic row height (#16801) @cherniavskii
@mui/[email protected]

Same changes as in @mui/[email protected]
.
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Date and Time Pickers
@mui/[email protected]
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Core
- [infra] Update contributor acknowledgment wording (#16753) @michelengelen
v8.0.0-alpha.13
We'd like to offer a big thanks to the 19 contributors who made this release possible. Here are some highlights ✨:
- 📊 Decouple
margin
andaxis-size
. A new API to support multiple axes (#16418) @JCQuintas - 🗺️ Added Bangla (bn-BD) locale
- 🗺️ Improve Russian (ru-RU) and Hungarian (hu-HU) locale on the Data Grid
Special thanks go out to the community members for their contributions:
@denpiligrim, @lhilgert9, @noherczeg, @officialkidmax, @pcorpet.
Following are all team members who have contributed to this release:
@alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @flaviendelangle, @hasdfa, @Janpot, @JCQuintas, @KenanYusuf, @LukasTy, @michelengelen, @MBilalShafi, @oliviertassinari, @romgrk.
Data Grid
Breaking changes
-
The
slots.baseFormControl
component was removed. -
The "Reset" button in the column visibility panel now resets to the initial column visibility model. Previously it was reset to the model that was active at the time the panel was opened. The reset behavior follows these rules:
- If an initial
columnVisibilityModel
is provided, it resets to that model. - If a controlled
columnVisibilityModel
is provided, it resets to the first model value. - When the columns are updated (via the
columns
prop orupdateColumns()
API method), the reset reference point updates to the currentcolumnVisibilityModel
.
To revert to the previous behavior, provide a custom component to the
slots.columnsManagement
. - If an initial
-
The deprecated
LicenseInfo
export has been removed from the@mui/x-data-grid-pro
and@mui/x-data-grid-premium
packages.
You have to import it from@mui/x-license
instead:- import { LicenseInfo } from '@mui/x-data-grid-pro'; - import { LicenseInfo } from '@mui/x-data-grid-premium'; + import { LicenseInfo } from '@mui/x-license'; LicenseInfo.setLicenseKey('YOUR_LICENSE_KEY');
-
The row selection model has been changed from
GridRowId[]
to{ type: 'include' | 'exclude'; ids: Set<GridRowId> }
.
UsingSet
allows for a more efficient row selection management.
Theexclude
selection type allows to select all rows except the ones in theids
set.This change impacts the following props:
rowSelectionModel
onRowSelectionModelChange
initialState.rowSelectionModel
- const [rowSelectionModel, setRowSelectionModel] = React.useState<GridRowSelectionModel>([]); + const [rowSelectionModel, setRowSelectionModel] = React.useState<GridRowSelectionModel>({ type: 'include', ids: new Set() });
This change also impacts the
gridRowSelectionStateSelector
selector.
For convenience, use thegridRowSelectionManagerSelector
selector to handle both selection types:- const rowSelection = gridRowSelectionStateSelector(apiRef); - const isRowSelected = rowSelection.includes(rowId); + const rowSelectionManager = gridRowSelectionManagerSelector(apiRef); + const isRowSelected = rowSelectionManager.has(rowId);
There is also a
createRowSelectionManager
utility function that can be used to manage the row selection:const rowSelectionManager = createRowSelectionManager({ type: 'include', ids: new Set(), }); rowSelectionManager.select(rowId); rowSelectionManager.unselect(rowId); rowSelectionManager.has(rowId);
-
The
selectedIdsLookupSelector
selector has been removed. Use thegridRowSelectionManagerSelector
orgridRowSelectionStateSelector
selectors instead. -
The
selectedGridRowsSelector
has been renamed togridRowSelectionIdsSelector
. -
The
selectedGridRowsCountSelector
has been renamed togridRowSelectionCountSelector
. -
The data source feature and its related props are now stable.
<DataGridPro - unstable_dataSource={dataSource} - unstable_dataSourceCache={cache} - unstable_lazyLoading - unstable_lazyLoadingRequestThrottleMs={100} + dataSource={dataSource} + dataSourceCache={cache} + lazyLoading + lazyLoadingRequestThrottleMs={100} />
-
The data source API is now stable.
- apiRef.current.unstable_dataSource.getRows() + apiRef.current.dataSource.getRows()
-
The signature of
unstable_onDataSourceError()
has been updated to support future use-cases.<DataGrid - unstable_onDataSourceError={(error: Error, params: GridGetRowsParams) => { - if (params.filterModel) { - // do something - } - }} + unstable_onDataSourceError={(error: GridGetRowsError | GridUpdateRowError) => { + if (error instanceof GridGetRowsError && error.params.filterModel) { + // do something + } + }} />
-
Fix the type of the
GridSortModel
to allow readonly arrays. -
GridSortItem
interface is not exported anymore. -
The
showToolbar
prop is now required to display the toolbar.It is no longer necessary to pass
GridToolbar
as a slot to display the default toolbar.<DataGrid + showToolbar - slots={{ - toolbar: GridToolbar, - }} />
@mui/[email protected]
- [DataGrid] Add
showToolbar
prop to enable default toolbar (#16687) @KenanYusuf - [DataGrid] Column Visibility: Update "Reset" button behavior (#16626) @MBilalShafi
- [DataGrid] Column management design updates (#16630) @KenanYusuf
- [DataGrid] Fix
showColumnVerticalBorder
prop (#16715) @KenanYusuf - [DataGrid] Fix scrollbar overlapping cells on mount (#16639) @KenanYusuf
- [DataGrid] Fix: base
Select
menupropsonClose()
(#16643) @romgrk - [DataGrid] Make
GridSortItem
internal (#16732) @arminmeh - [DataGrid] Make data source stable (#16710) @MBilalShafi
- [DataGrid] Reshape row selection model (#15651) @cherniavskii
- [DataGrid] Replace
sx
prop usage withstyled()
components (#16665) @KenanYusuf - [DataGrid] Refactor: create base
Autocomplete
(#16390) @romgrk - [DataGrid] Refactor: remove base form control (#16634) @romgrk
- [DataGrid] Refactor: remove base input label & adornment (#16646) @romgrk
- [DataGrid] Refactor: remove material containers (#16633) @romgrk
- [DataGrid] Refactor: theme to CSS variables (#16588) @romgrk
- [DataGrid] Update the signature of the
onDataSourceError()
callback (#16718) @MBilalShafi - [DataGrid] Use readonly array for the
GridSortModel
(#16627) @pcorpet - [DataGrid] Fix the popper focus trap (#16736) @romgrk
- [l10n] Added Bangla (bn-BD) locale (#16648) @officialkidmax
- [l10n] Improve Hungarian (hu-HU) locale (#16578) @noherczeg
- [l10n] Improve Russian (ru-RU) locale (#16591) @denpiligrim
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
- [DataGridPro] Remove
LicenseInfo
reexports (#16671) @cherniavskii
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
- [DataGridPremium] Use
valueGetter
to get row group keys (#16016) @cherniavskii
Date and Time Pickers
Breaking changes
- The
<DateRangePicker />
now uses adialog
instead of atooltip
to render their view when used with a single input range field.
@mui/[email protected]
- [l10n] Added Bangla (bn-BD) locale (#16648) @officialkidmax
- [pickers] Clean the typing of the slots on the range pickers (#16670) @flaviendelangle
- [pickers] Fix Time Clock meridiem button selected styles (#16681) @LukasTy
- [pickers] Make the single input field the default field on range pickers (#16656) @flaviendelangle
- [pickers] Move the opening logic to the range fields (#16175) @flaviendelangle
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Charts
Breaking changes
-
Charts array inputs are now
readonly
. Allowing externally definedas const
to be used as a prop value of the React component.const xAxis = [{ position: 'bottom' }] as const <BarChart xAxis={xAxis} />
-
Replace
topAxis
,rightAxis
,bottomAxis
andleftAxis
props by theposition
property in the axis config.
If you were using them to place axis, set theposition
property to the corresponding value'top' | 'right' | 'bottom' | 'left'
.
If you were disabling an axis by setting it tonull
, set itsposition
to'none'
.<LineChart yAxis={[ { scaleType: 'linear', + position: 'right', }, ]} series={[{ data: [1, 10, 30, 50, 70, 90, 100], label: 'linear' }]} height={400} - rightAxis={{}} />
-
Remove
position
prop fromChartsXAxis
andChartsYAxis
.
Theposition
prop has been removed from theChartsXAxis
andChartsYAxis
components. Configure it directly in the axis config.<ChartContainer yAxis={[ { id: 'my-axis', + position: 'right', }, ]} > - <ChartsYAxis axisId="my-axis" position="right" /> + <ChartsYAxis axisId="my-axis" /> </ChartContainer>
-
Add
minTickLabelGap
to x-axis, which allows users to define the minimum gap, in pixels, between two tick labels. The default value is 4px. Make sure to check your charts as the spacing between tick labels might have changed.
@mui/[email protected]
- [charts] Accept component in
labelMarkType
(#16739) @bernardobelchior - [charts] Add
minTickLabelGap
to x-axis (#16548) @bernardobelchior - [charts] Add unit test for pie chart with empty series (#16663) @bernardobelchior
- [charts] ...
v7.27.2
We'd like to offer a big thanks to the 5 contributors who made this release possible. Here are some highlights ✨:
- 🐞 Bugfixes
- 🌍 Improve Hungarian (hu-HU) and Russian (ru-RU) locales on the Data Grid
Special thanks go out to the community contributors who have helped make this release possible:
@pcorpet, @noherczeg, @denpiligrim.
Following are all team members who have contributed to this release:
@MBilalShafi, @KenanYusuf.
Data Grid
@mui/[email protected]
- [DataGrid] Fix
showColumnVerticalBorder
prop (#16726) @KenanYusuf - [DataGrid] Make server-side data navigation consistent (#16735) @MBilalShafi
- [DataGrid] Use readonly array for
GridSortModel
(#16731) @pcorpet - [l10n] Improve Hungarian (hu-HU) locale (#16746) @noherczeg
- [l10n] Improve Russian (ru-RU) locale (#16725) @denpiligrim
@mui/[email protected]

Same changes as in @mui/[email protected]
.
@mui/[email protected]

Same changes as in @mui/[email protected]
.
v7.27.1
We'd like to offer a big thanks to the 5 contributors who made this release possible. Here are some highlights ✨:
- 🐞 Bugfixes
- 🌍 Add Bangla (bn-BD) locale on the Data Grid and Date Pickers
Special thanks go out to the community contributors who have helped make this release possible:
@nusr, @officialkidmax.
Following are all team members who have contributed to this release:
@bernardobelchior, @MBilalShafi, @KenanYusuf.
Data Grid
@mui/[email protected]
- [DataGrid] Fix the pagination unexpected behavior when using -1 for "All" rows per page (#16485) @nusr
- [DataGrid] Extract
getRowId()
API method as a selector (#16574) @MBilalShafi - [DataGrid] Fix scrollbars overlapping cells on mount (#16653) @KenanYusuf
- [l10n] Add Bangla (bn-BD) locale (#16649) @officialkidmax
@mui/[email protected]

Same changes as in @mui/[email protected]
.
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Date and Time Pickers
@mui/[email protected]
- [l10n] Add Bangla (bn-BD) locale (#16649) @officialkidmax
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Charts
@mui/[email protected]
- [charts] Fix empty series array in pie chart (#16657) @bernardobelchior
@mui/[email protected]

Same changes as in @mui/[email protected]
.
v8.0.0-alpha.12
We'd like to offer a big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
- 📦 Data Grid data source is now available in the Community plan
- ⚡ Improve Data Grid Excel export serialization performance
- 🚫 Add "No columns" overlay to Data Grid
- 🌍 Improve Polish (pl-PL) and Ukrainian (uk-UA) locales on the Data Grid
- 🐞 Bugfixes
Special thanks go out to the community contributors who have helped make this release possible:
@Neonin, @nusr, and @pawelkula.
Following are all team members who have contributed to this release:
@alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @Janpot, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi, @michelengelen, @oliviertassinari, @romgrk, and @mapache-salvaje.
Data Grid
Breaking changes
-
The
main--hasSkeletonLoadingOverlay
class has been renamed tomain--hiddenContent
and is now also applied when the "No columns" overlay is displayed. -
The
apiRef.current.forceUpdate()
method was removed. Use selectors combined withuseGridSelector()
hook to react to changes in the state. -
The selectors signature has been updated. They are only accepting
apiRef
as a first argument andinstanceId
is no longer the third argument.-mySelector(state, arguments, instanceId) +mySelector(apiRef, arguments)
@mui/[email protected]
- [DataGrid] Add "No columns" overlay (#16543) @KenanYusuf
- [DataGrid] All selectors accept only
apiRef
as first argument (#16198) @arminmeh - [DataGrid] Avoid
undefined
value for paginationrowCount
(#16488) @cherniavskii - [DataGrid] Create the base Checkbox slot (#16445) @romgrk
- [DataGrid] Create the base Input slot (#16443) @romgrk
- [DataGrid] Create the base MenuList slot (#16481) @romgrk
- [DataGrid] Create the base Popper slot (#16362) @romgrk
- [DataGrid] Create the base Select slot (#16394) @romgrk
- [DataGrid] Create the base Switch slot (#16527) @romgrk
- [DataGrid] Extract
getRowId()
API method as a selector (#16487) @MBilalShafi - [DataGrid] Fix the
onClock
prop of the base Select slot (#16557) @romgrk - [DataGrid] Go to the first page when sorting/filtering is applied (#16447) @arminmeh
- [DataGrid] Make base data source available in the Community plan (#16359) @MBilalShafi
- [DataGrid] Remove
apiRef.current.forceUpdate()
method (#16560) @MBilalShafi - [DataGrid] Fix the unexpected behavior of the pagination when using
-1
for "All" rows per page (#16485) @nusr - [l10n] Improve Polish (pl-PL) locale (#16123) @pawelkula
- [l10n] Improve Ukrainian (uk-UA) locale (#16463) @Neonin
@mui/[email protected]

Same changes as in @mui/[email protected]
.
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
- [DataGridPremium] Fix Excel export Web Worker demo not working in dev mode (#16517) @cherniavskii
- [DataGridPremium] Fix loading issue + add skeleton overlay (#16282) @MBilalShafi
- [DataGridPremium] Improve Excel export serialization performance (#16526) @cherniavskii
- [DataGridPremium] Namespace Excel export worker (#16020) @oliviertassinari
Date and Time Pickers
Breaking changes
-
The
aria-label
on the<Clock />
component and Time Picker opening button has been fixed to rely on the setampm
property instead of defaulting to the user's locale. -
The following unused formats have been removed from the adapters and can no longer be overridden via the
dateFormats
prop on the<LocalizationProvider />
component:fullTime
- please usefullTime12h
andfullTime24h
instead:<LocalizationProvider dateFormats={{ - fullTime: 'LT', + fullTime12h: 'hh:mm A', + fullTime24h: 'hh:mm', }} >
keyboardDateTime
- please usekeyboardDateTime12h
andkeyboardDateTime24h
instead:<LocalizationProvider dateFormats={{ - keyboardDateTime: 'DD.MM.YYYY | LT', + keyboardDateTime12h: 'DD.MM.YYYY | hh:mm A', + keyboardDateTime24h: 'DD.MM.YYYY | hh:mm', }} >
@mui/[email protected]
- [pickers] Fix time related aria labels to depend on
ampm
flag value (#16572) @LukasTy - [pickers] Remove unused adapter formats (#16522) @LukasTy
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
Charts
Breaking changes
- The
useSeries
hook family has been stabilized and renamed accordingly — Learn more
@mui/[email protected]
- [charts] Add docs for scatter "Size" section (#16556) @bernardobelchior
- [charts] Add
test:performance:browser
script #16600 @bernardobelchior - [charts] Add warning when using unknown ids in
useXxxSeries
hooks (#16552) @JCQuintas - [charts] Divide the logic for
useXxxSeries
intouseXxxSeriesContext
(#16546) @JCQuintas - [charts] Document plugins for internal use (#16504) @JCQuintas
- [charts] Fix internal typo (#16524) @alexfauquette
- [charts] Fix type overloads (#16581) @JCQuintas
- [charts] Fix zoom filter regression (#16507) @alexfauquette
- [charts] Improve tooltip placement in mobile (#16553) @bernardobelchior
- [charts] Let the
useXxxSeries
support array of ids and document them (#15545) @JCQuintas - [charts] Memoize some tooltip internals (#16564) @alexfauquette
- [charts] Move Voronoi handler in a dedicated plugin (#16470) @alexfauquette
- [charts] Performance tests: set license on setup. Update vitest minor version. (#16525) @bernardobelchior
- [charts] Propagate the axis scale to the
valueFormatter
(#16555) @alexfauquette - [charts] Remove
colors
prop fromSparkLineChart
. (#16494) @bernardobelchior - [charts] Stabilize series hooks (
useSeries
,usePieSeries
, etc.) (#16459) @bernardobelchior
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Tree View
@mui/[email protected]
Internal changes.
@mui/[email protected]

Same changes as in @mui/[email protected]
.
Docs
- [docs] Add demo for Scatter Chart with linked points (#16505) @bernardobelchior
- [docs] Improve license installation page (#16403) @michelengelen
- [docs] Standardize getting started docs across all packages (#16302) @mapache-salvaje
Core
- [core] Update charts folder structure (#16471) @alexfauquette
- [code-infra] Bump @mui/monorepo (#16422) @LukasTy
- [code-infra] Fix lock file (#16562) @LukasTy
- [code-infra] Fix root package version (#16503) @JCQuintas
- [code-infra] Update internal packages to
next
releases (#16423) @LukasTy - [code-infra] Update package layout for better ESM support (#14386) @Janpot
- [code-infra] Update peer dependencies for v8 (#16563) @Janpot
v7.27.0
We'd like to offer a big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:
- ⚡ Improve Data Grid Excel export serialization performance
- 🐞 Bugfixes
- 🌍 Improve Polish (pl-PL) and Ukrainian (uk-UA) locale on the Data Grid
Special thanks go out to the community contributors who have helped make this release possible:
@pawelkula, @Neonin.
Following are all team members who have contributed to this release:
@cherniavskii, @JCQuintas, @oliviertassinari, @arminmeh and @LukasTy
Data Grid
@mui/[email protected]
- [DataGrid] Add
resetPageOnSortFilter
prop that resets the page after sorting and filtering (#16580) @arminmeh - [DataGrid] Avoid
undefined
value for paginationrowCount
(#16558) @cherniavskii - [l10n] Improve Polish (pl-PL) locale (#16594) @pawelkula
- [l10n] Improve Ukrainian (uk-UA) locale (#16593) @Neonin
@mui/[email protected]

Same changes as in @mui/[email protected]
.
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
- [DataGridPremium] Fix Excel export Web Worker demo not working in dev mode (#16532) @cherniavskii
- [DataGridPremium] Improve Excel export serialization performance (#16545) @cherniavskii
- [DataGridPremium] Namespace Excel export worker (#16539) @oliviertassinari
Date and Time Pickers
@mui/[email protected]
Internal changes.
@mui/[email protected]

Same changes as in @mui/[email protected]
, plus:
Charts
@mui/[email protected]
Internal changes.
@mui/[email protected]

- [charts-pro] Fix automatic type overloads (#16579) @JCQuintas