NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #4524 most downloaded on npm
Utility functions for the MUI X packages (internal use only).
Latest stable
9.17.0
Last release 18 days ago
30 Oct 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
92 releases · first in 2024
Drag across the ruler to compare, or tap a release to open it.
[charts] Add color prop to Sparkline and deprecate colors (#16477) @bernardobelchior
We'd like to offer a big thanks to the 11 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @lauri865. Following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @flaviendelangle, @Janpot, @KenanYusuf, @LukasTy, @MBilalShafi, @noraleonte, @romgrk.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
createUseGridApiEventHandler() is not exported anymore.
The filteredRowsLookup object of the filter state does not contain true values anymore. If the row is filtered out, the value is false. Otherwise, the row id is not present in the object.
This change only impacts you if you relied on filteredRowsLookup to get ids of filtered rows. In this case,use gridDataRowIdsSelector selector to get row ids and check filteredRowsLookup for false values:
const filteredRowsLookup = gridFilteredRowsLookupSelector(apiRef);
-const filteredRowIds = Object.keys(filteredRowsLookup).filter((rowId) => filteredRowsLookup[rowId] === true);
+const rowIds = gridDataRowIdsSelector(apiRef);
+const filteredRowIds = rowIds.filter((rowId) => filteredRowsLookup[rowId] !== false);
The visibleRowsLookup state does not contain true values anymore. If the row is not visible, the value is false. Otherwise, the row id is not present in the object:
const visibleRowsLookup = gridVisibleRowsLookupSelector(apiRef);
-const isRowVisible = visibleRowsLookup[rowId] === true;
+const isRowVisible = visibleRowsLookup[rowId] !== false;
@mui/x-data-grid@8.0.0-alpha.11<GridRoot /> double-render pass on mount in SPA mode (#15648) @lauri865MenuList import (#16444) @romgrkuseGridApiEventHandler() (#16479) @romgrk@mui/x-data-grid-pro@8.0.0-alpha.11 Same changes as in @mui/x-data-grid@8.0.0-alpha.11, plus:
useGridApiContext() for Pro and Premium packages on React < 19 (#16441) @arminmeh@mui/x-data-grid-premium@8.0.0-alpha.11 Same changes as in @mui/x-data-grid-pro@8.0.0-alpha.11, plus:
@mui/x-date-pickers@8.0.0-alpha.11Internal changes.
@mui/x-date-pickers-pro@8.0.0-alpha.11 Same changes as in @mui/x-date-pickers@8.0.0-alpha.11, plus:
currentMonthCalendarPosition prop behavior on mobile (#16455) @LukasTy@mui/x-charts@8.0.0-alpha.11color prop to Sparkline and deprecate colors (#16477) @bernardobelchior@mui/x-charts-pro@8.0.0-alpha.11 Same changes as in @mui/x-charts@8.0.0-alpha.11.
@mui/x-tree-view@8.0.0-alpha.11Internal changes.
@mui/x-tree-view-pro@8.0.0-alpha.11 Same changes as in @mui/x-tree-view@8.0.0-alpha.11.
react-transition-group transitions in unit testing (#16288) @lauri865Your coding agent can read these notes before it upgrades. Set up the MCP server →
We'd like to offer a big thanks to the 10 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 10 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @k-rajat19, @lauri865, @mateuseap. Following are all team members who have contributed to this release: @alexfauquette, @flaviendelangle, @JCQuintas, @KenanYusuf, @MBilalShafi, @romgrk, @arminmeh.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
viewportInnerSize.width now includes pinned columns' widths (fixes recursive loops in updating dimensions <-> columns)
The Data Grid now has a default background color, and its customization has moved from theme.mixins.MuiDataGrid to theme.palette.DataGrid with the following properties:
bg: Sets the background color of the entire grid (new property)headerBg: Sets the background color of the header (previously named containerBackground)pinnedBg: Sets the background color of pinned rows and columns (previously named pinnedBackground) const theme = createTheme({
- mixins: {
- MuiDataGrid: {
- containerBackground: '#f8fafc',
- pinnedBackground: '#f1f5f9',
- },
- },
+ palette: {
+ DataGrid: {
+ bg: '#f8fafc',
+ headerBg: '#e2e8f0',
+ pinnedBg: '#f1f5f9',
+ },
+ },
});
The detailPanels, pinnedColumns, and pinnedRowsRenderZone classes have been removed.
Return type of the useGridApiRef() hook and the type of apiRef prop are updated to explicitly include the possibilty of null. In addition to this, useGridApiRef() returns a reference that is initialized with null instead of {}.
Only the initial value and the type are updated. Logic that initializes the API and its availability remained the same, which means that if you could access API in a particular line of your code before, you are able to access it as well after this change.
Depending on the context in which the API is being used, you can decide what is the best way to deal with null value. Some options are:
apiRef is not nullapiRef is nullapiRef is null@mui/x-data-grid@8.0.0-alpha.10renderContext calculation with scroll bounce / over-scroll (#16297) @lauri865gridClasses (#16256) @mateuseapnull in the return type of the useGridApiRef() hook (#16353) @arminmehonClick prop on toolbar buttons (#16356) @KenanYusuficonContainer during autosizing (#16399) @michelengelen@mui/x-data-grid-pro@8.0.0-alpha.10 Same changes as in @mui/x-data-grid@8.0.0-alpha.10, plus:
useGridApiRef for Pro and Premium packages on React < 19 (#16328) @arminmeh@mui/x-data-grid-premium@8.0.0-alpha.10 Same changes as in @mui/x-data-grid-pro@8.0.0-alpha.10.
field slot no longer receives the ref, disabled, className, sx, label, name, formatDensity, enableAccessibleFieldDOMStructure, selectedSections, onSelectedSectionsChange and inputRef props — Learn moreMuiPickersPopper theme entry have been renamed MuiPickerPopper and some of its props have been removed — Learn more@mui/x-date-pickers@8.0.0-alpha.10<PickersPopper /> (#16319) @flaviendelanglePickerContextValue properties (#16327) @flaviendelangle@mui/x-date-pickers-pro@8.0.0-alpha.10 Same changes as in @mui/x-date-pickers@8.0.0-alpha.10.
legend.position.horizontal from "left" | "middle" | "right" to "start" | "center" | "end".
This is to align with the CSS values and reflect the RTL ability of the legend component.blueberryTwilightPalette from @mui/x-charts/colorPalettes and set it on the colors property of charts.id property is now optional on the Pie and Scatter data types.@mui/x-charts@8.0.0-alpha.10bumpX and bumpY curve options (#16318) @JCQuintastooltipGetter to seriesConfig (#16331) @JCQuintaslegend.position.horizontal from "left" | "middle" | "right" to "start" | "center" | "end" (#16315) @JCQuintasid optional on PieValueType and ScatterValueType (#16389) @JCQuintas@mui/x-charts-pro@8.0.0-alpha.10 Same changes as in @mui/x-charts@8.0.0-alpha.10.
@mui/x-tree-view@8.0.0-alpha.10Internal changes.
@mui/x-tree-view-pro@8.0.0-alpha.10 Same changes as in @mui/x-tree-view@8.0.0-alpha.10.
[docs] Fix tiny line chart breaking change (#16268) @alexfauquette
We'd like to offer a big thanks to the 10 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @AxharKhan, @lauri865, @mapache-salvaje, @mostafaRoosta74.
Following are all team members who have contributed to this release: @alexfauquette, @cherniavskii, @Janpot, @JCQuintas, @LukasTy, @arminmeh.
@mui/x-data-grid@v8.0.0-alpha.9apiRef to be MutableRefObject for React versions < 19 (#16279) @arminmeh@mui/x-data-grid-pro@v8.0.0-alpha.9 Same changes as in @mui/x-data-grid@v8.0.0-alpha.9.
@mui/x-data-grid-premium@v8.0.0-alpha.9 Same changes as in @mui/x-data-grid-pro@v8.0.0-alpha.9.
@mui/x-date-pickers@v8.0.0-alpha.9all selected state on section edit (#16223) @LukasTy@mui/x-date-pickers-pro@v8.0.0-alpha.9 Same changes as in @mui/x-date-pickers@v8.0.0-alpha.9.
The experimentalMarkRendering prop has been removed from the LineChart component.
The line mark are now <circle /> element by default.
And you can chose another shape by adding a shape property to your line series.
The codemod only removes the experimentalMarkRendering prop.
If you relied on the fact that marks were path elements, you need to update your logic.
@mui/x-charts@v8.0.0-alpha.9<circle /> instead of <path /> for line marks by default (#15220) @alexfauquette@mui/x-charts-pro@v8.0.0-alpha.9 Same changes as in @mui/x-charts@v8.0.0-alpha.9, plus:
pro components watermark (#16222) @JCQuintas@mui/x-tree-view@v8.0.0-alpha.9Internal changes.
@mui/x-tree-view-pro@v8.0.0-alpha.9 Same changes as in @mui/x-tree-view@v8.0.0-alpha.9.
domainLimit definition (#16270) @alexfauquetteWe'd like to offer a big thanks to the 11 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 11 contributors who made this release possible. Here are some highlights ✨:
🍬 Improved design for Data Grid Header filters
<img width="100%" alt="Data Grid Header filters" src="https://github.com/user-attachments/assets/74a50cd9-7a55-41fc-a2b8-f8a0d5b9120e" />
🔄 Data Grid Scroll restoration
📊 Charts support server-side rendering under some conditions
🐞 Bugfixes
Special thanks go out to the community contributors who have helped make this release possible: @lauri865. Following are all team members who have contributed to this release: @arminmeh, @romgrk, @samuelsycamore, @alexfauquette, @cherniavskii, @flaviendelangle, @JCQuintas, @KenanYusuf, @LukasTy, @michelengelen.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
slotProps={{ headerFilterCell: { showClearIcon: true } }} to restore the clear button in the cell.@mui/x-data-grid@8.0.0-alpha.8@mui/x-data-grid-pro@8.0.0-alpha.8 Same changes as in @mui/x-data-grid@8.0.0-alpha.8, plus:
@mui/x-data-grid-premium@8.0.0-alpha.8 Same changes as in @mui/x-data-grid-pro@8.0.0-alpha.8.
useMultiInputDateRangeField, useMultiInputTimeRangeField, and useMultiInputDateTimeRangeField hooks have been removed in favor of the new useMultiInputRangeField hook — Learn morefield slot no longer receives the value, onChange, timezone, format, disabled, formatDensity, enableAccessibleFieldDOMStructure, selectedSections and onSelectedSectionsChange props — Learn more@mui/x-date-pickers@8.0.0-alpha.8onRangePositionChange into setRangePosition in usePickerRangePositionContext (#16189) @flaviendelangle@mui/x-date-pickers-pro@8.0.0-alpha.8 Same changes as in @mui/x-date-pickers@8.0.0-alpha.8.
x and y axis now log a warning in dev mode. Axis ids should be unique to prevent internal issues.@mui/x-charts@8.0.0-alpha.8offset could be Infinite (#16131) @JCQuintasuseChartGradientId public (#16106) @JCQuintasskipAnimation is set to true (#16166) @alexfauquettertl for gradient legend (#16115) @JCQuintas@mui/x-charts-pro@8.0.0-alpha.8 Same changes as in @mui/x-charts@8.0.0-alpha.8.
@mui/x-tree-view@8.0.0-alpha.8No changes since @mui/x-tree-view-pro@v8.0.0-alpha.7.
@mui/x-tree-view-pro@8.0.0-alpha.8 Same changes as in @mui/x-tree-view@8.0.0-alpha.8.
RefObject (#16124) @arminmehreact and react-dom definitions to simplify dep resolving (#16160) @LukasTydate-fns-v2 (#16158) @LukasTy[docs] Unify the wording of the pickers slots breaking changes (#16036) @flaviendelangle
We'd like to offer a big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @derek-0000, @josteinjhauge, @k-rajat19, @nusr, @tomashauser. Following are all team members who have contributed to this release: @cherniavskii, @flaviendelangle, @JCQuintas, @LukasTy, @MBilalShafi, @arminmeh, @romgrk, @oliviertassinari.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@8.0.0-alpha.7name attribute to the checkbox selection column (#15178) @derek-0000@mui/x-data-grid-pro@8.0.0-alpha.7 Same changes as in @mui/x-data-grid@8.0.0-alpha.7.
@mui/x-data-grid-premium@8.0.0-alpha.7 Same changes as in @mui/x-data-grid-pro@8.0.0-alpha.7, plus:
date-fns and date-fns-jalali date library adapters have been renamed to better align with the current stable major versions — Learn morecloseOnSelect and Action Bar actions values - Learn morelayout slot no longer receives the value, onChange and onSelectShortcut props — Learn more.toolbar slot no longer receives the value, onChange and isLandscape props — Learn more.shortcuts slot no longer receives the onChange, isValid and isLandscape props — Learn more.PickerShortcutChangeImportance type has been renamed PickerChangeImportance — Learn more.layout slot no longer receives the rangePosition and onRangePositionChange on range pickers — Learn more.toolbar slot no longer receives the rangePosition and onRangePositionChange on range pickers — Learn more.tabs slot no longer receives the rangePosition and onRangePositionChange on range pickers — Learn more.@mui/x-date-pickers@8.0.0-alpha.7inputRef.current.focus on accessibleFieldDOMStructure (#15985) @LukasTysetValue internally to update the picker value (#16056) @flaviendelanglemanager (#15339) @flaviendelangle<PickersActionBar /> (#16071) @LukasTyNonEmptyDateRange type (#16035) @flaviendelangleAdapterDateFns into AdapterDateFnsV2 and AdapterDateFnsV3 into AdapterDateFns (#16082) @LukasTyctx.onViewChange to ctx.setView and add it to the actions context (#16044) @flaviendelangledate-fns-jalali v4 (#16011) @LukasTycloseOnSelect and actionBar.actions default values (#15944) @LukasTyusePickerContext() and usePickerActionsContext() instead of passing props to the shortcuts and toolbar slots (#15948) @flaviendelangle@mui/x-date-pickers-pro@8.0.0-alpha.7 Same changes as in @mui/x-date-pickers@8.0.0-alpha.7.
DefaultChartsLegend component, since it is now easier to create custom legends — Learn more.width and height properties of the charts now only apply to the svg element, and not their wrappers, this might cause some layout shifts.slotProps.legend.direction now accepts 'horizontal' | 'vertical' instead of 'row' | 'column' — Learn more.getSeriesToDisplay function was removed in favor of the useLegend hook. — Learn more.@mui/x-charts@8.0.0-alpha.7@mui/x-charts-pro@8.0.0-alpha.7 Same changes as in @mui/x-charts@8.0.0-alpha.7.
@mui/x-tree-view@8.0.0-alpha.7@mui/x-tree-view-pro@8.0.0-alpha.7 Same changes as in @mui/x-tree-view@8.0.0-alpha.7.
EditingWithDatePickers demo (#15967) @k-rajat19LocalizationProvider (#16084) @tomashauserrelease:version docs (#16038) @cherniavskiitestSkipIf and describeSkipIf (#16049) @JCQuintasWe'd like to offer a big thanks to the 8 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 8 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @JoepVerkoelen, @k-rajat19, @lauri865. Following are all team members who have contributed to this release: @flaviendelangle, @JCQuintas, @LukasTy, @MBilalShafi, @romgrk.
sanitizeFilterItemValue() utility is not exported anymore.@mui/x-data-grid@8.0.0-alpha.6renderContext state in grid root for better scroll performance (#15986) @lauri865forwardRef with a shim for forward compatibility (#15955) @lauri865@mui/x-data-grid-pro@8.0.0-alpha.6 Same changes as in @mui/x-data-grid@8.0.0-alpha.6.
@mui/x-data-grid-premium@8.0.0-alpha.6 Same changes as in @mui/x-data-grid-pro@8.0.0-alpha.6, plus:
@mui/x-date-pickers@8.0.0-alpha.6usePickerContext() and usePickerActionsContext() to get the actions in the actionBar slot and in internal components (#15843) @flaviendelangleusePickerContext() to get the view-related props in the layout, toolbar and tabs slots (#15606) @flaviendelangle@mui/x-date-pickers-pro@8.0.0-alpha.6 Same changes as in @mui/x-date-pickers@8.0.0-alpha.6.
@mui/x-charts@8.0.0-alpha.6No changes since @mui/x-charts@v8.0.0-alpha.5.
@mui/x-charts-pro@8.0.0-alpha.6 Same changes as in @mui/x-charts@8.0.0-alpha.6.
@mui/x-tree-view@8.0.0-alpha.6No changes since @mui/x-tree-view-pro@v8.0.0-alpha.5.
@mui/x-tree-view-pro@8.0.0-alpha.6 Same changes as in @mui/x-tree-view@8.0.0-alpha.6.
next-env.d.ts changes (#15947) @JCQuintasWe'd like to offer a big thanks to the 9 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 9 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @good-jinu, @k-rajat19. Following are all team members who have contributed to this release: @alexfauquette, @cherniavskii, @flaviendelangle, @KenanYusuf, @LukasTy, @MBilalShafi, @romgrk.
Passing additional props (like data-*, aria-*) directly on the Data Grid component is no longer supported. To pass the props, use slotProps.
.root element, use slotProps.root..main element (the one with role="grid"), use slotProps.main.detailPanelExpandedRowIds and onDetailPanelExpandedRowIdsChange props use a Set instead of an array:
-detailPanelExpandedRowIds?: GridRowId[];
+detailPanelExpandedRowIds?: Set<GridRowId>;
-onDetailPanelExpandedRowIdsChange?: (ids: GridRowId[], details: GridCallbackDetails) => void;
+onDetailPanelExpandedRowIdsChange?: (ids: Set<GridRowId>, details: GridCallbackDetails) => void;
apiRef.current.getExpandedDetailPanels and apiRef.current.setExpandedDetailPanels methods receive and return a Set instead of an array.
gridDetailPanelExpandedRowIdsSelector returns a Set instead of an array.
gridDetailPanelExpandedRowsHeightCacheSelector was removed.
@mui/x-data-grid@8.0.0-alpha.5columnGroupHeaderHeight prop in getTotalHeaderHeight method (#15915) @k-rajat19<Badge /> to leaf import (#15879) @romgrk<ListItemText /> and <ListItemIcon /> to leaf import (#15869) @romgrkslotProps to forward props to .main and .root elements (#15870) @MBilalShafi@mui/x-data-grid-pro@8.0.0-alpha.5 Same changes as in @mui/x-data-grid@8.0.0-alpha.5, plus:
Set for detailPanelExpandedRowIds (#15835) @cherniavskii@mui/x-data-grid-premium@8.0.0-alpha.5 Same changes as in @mui/x-data-grid-pro@8.0.0-alpha.5.
The <PickersMonth /> component has been moved inside the Month Calendar component — Learn more.
The <PickersYear /> component has been moved inside the Year Calendar component — Learn more.
@mui/x-date-pickers@8.0.0-alpha.5PickersMonth and PickersYear from the theme and remove the div wrapping each button (#15806) @flaviendelangleownerState object on the <PickersTextField /> component (#15863) @flaviendelangle@mui/x-date-pickers-pro@8.0.0-alpha.5 Same changes as in @mui/x-date-pickers@8.0.0-alpha.5.
@mui/x-charts@8.0.0-alpha.5<ScatterChart /> value type if null (#15917) @alexfauquette@mui/x-charts-pro@8.0.0-alpha.5 Same changes as in @mui/x-charts@8.0.0-alpha.5.
@mui/x-tree-view@8.0.0-alpha.5No changes since @mui/x-tree-view-pro@v8.0.0-alpha.4.
@mui/x-tree-view-pro@8.0.0-alpha.5 Same changes as in @mui/x-tree-view@8.0.0-alpha.5.
@mui/material-nextjs dependency (#15925) @LukasTyWe'd like to offer a big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
<ChartDataProvider /> and <ChartsSurface /> components are now fully divided — Learn more.Special thanks go out to the community contributors who have helped make this release possible: @dloeda, @headironc, @jedesroches, @k-rajat19, @lauri865, @mathzdev, @nphmuller, @zinoroman. Following are all team members who have contributed to this release: @arminmeh, @alexfauquette, @cherniavskii, @flaviendelangle, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi, @oliviertassinari.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
<GridOverlays /> component is not exported anymore.indeterminateCheckboxAction prop has been removed. Clicking on an indeterminate checkbox "selects" the unselected descendants.apiRef.current.resize() method was removed.rowSelectionPropagation prop has been changed to { parents: true, descendants: true } which means that the selection will be propagated to the parents and descendants by default.
To revert to the previous behavior, pass rowSelectionPropagation as { parents: false, descendants: false }.estimatedRowCount is used, the text provided to the Table Pagination component from the Material UI library is updated and requires additional translations. Check the example at the end of Index-based pagination section.@mui/x-data-grid@v8.0.0-alpha.2/jsdom/ to /jsdom|HappyDOM/. (#15634) @jedesroches<GridOverlays /> export (#15573) @k-rajat19indeterminateCheckboxAction prop (#15522) @MBilalShafi<GridCell /> due to performance issues (#15616) @lauri865resize method (#15599) @cherniavskiirowSelectionPropagation (#15523) @MBilalShafi@mui/x-data-grid-pro@v8.0.0-alpha.2 Same changes as in @mui/x-data-grid@v8.0.0-alpha.2, plus:
boolean column type (#15528) @k-rajat19@mui/x-data-grid-premium@v8.0.0-alpha.2 Same changes as in @mui/x-data-grid-pro@v8.0.0-alpha.2.
The props received by the layout and the toolbar slots have been reworked — Learn more.
The TSection generic of the FieldRef type has been replaced with the TValue generic — Learn more.
@mui/x-date-pickers@v8.0.0-alpha.2America/Asuncion timezone and AdapterMoment (#15552) @flaviendelangleTSection and strictly type TValue (#15434) @flaviendelangleorientation, isLandscape, isRtl, wrapperVariant and disabled props from PickersLayout (#15494) @flaviendelangleownerState in <PickersCalendarHeader />, <PickersArrowSwitcher /> and <DayCalendarSkeleton /> (#15499) @flaviendelangleownerState object in all the field components (#15510) @flaviendelangle@mui/x-date-pickers-pro@v8.0.0-alpha.2 Same changes as in @mui/x-date-pickers@v8.0.0-alpha.2.
<div /> wrapping them anymore. All props are now passed to the root <svg /> instead of the <div />.@mui/x-charts@v8.0.0-alpha.2@mui/utils and @mui/system (#15603) @alexfauquettereleasePointerCapture (#15602) @alexfauquette@mui/x-charts-pro@v8.0.0-alpha.2 Same changes as in @mui/x-charts@v8.0.0-alpha.2.
@mui/x-tree-view@v8.0.0-alpha.2@mui/utils and @mui/system (#15604) @alexfauquette@mui/x-tree-view-pro@v8.0.0-alpha.2Same changes as in @mui/x-tree-view@v8.0.0-alpha.2.
new and preview tags in v8 docs (#15547) @JCQuintasanchorEl API page for charts (#15625) @oliviertassinari() function convention for docs @oliviertassinari@types/node bumps (#15591) @LukasTyWe'd like to offer a big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @CarlosLopezLg, @headironc, @hendrikpeilke, @k-rajat19, @lhilgert9, @viktormelin. Following are all team members who have contributed to this release: @alexfauquette, @arthurbalduini, @cherniavskii, @flaviendelangle, @JCQuintas, @LukasTy, @MBilalShafi, @oliviertassinari, @KenanYusuf, @arminmeh.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@v8.0.0-alpha.1GridColumnsManagement (#15347) @k-rajat19@mui/x-data-grid-pro@v8.0.0-alpha.1 Same changes as in @mui/x-data-grid@v8.0.0-alpha.1.
@mui/x-data-grid-premium@v8.0.0-alpha.1 Same changes as in @mui/x-data-grid-pro@v8.0.0-alpha.1, plus:
FieldValueType type has been renamed to PickerValueType — Learn more.toolbar and layout slots no longer receive the disabled and readOnly props — Learn more.@mui/x-date-pickers@v8.0.0-alpha.1PickerOwnerState and PickerContextValue (#15415) @flaviendelangleprops.value when it changes (#15490) @flaviendelangle<PickersToolbar /> component (#15515) @LukasTyFieldValueType in favor of PickerValueType (#15259) @arthurbalduiniprops.referenceDate timezone when props.value and props.defaultValue are not defined (#15532) @flaviendelangletouchend event (#15346) @arthurbalduini@mui/x-date-pickers-pro@v8.0.0-alpha.1 Same changes as in @mui/x-date-pickers@v8.0.0-alpha.1, plus:
referenceDate when selecting date (#15429) @LukasTyThe DX of the Tooltip customization has been refactored
tooltip prop has been removed in favor of slotProps.tooltip for consistency.popper, axisContent, and itemContent slots have been removed in favor of the tooltip slot which overrides the entire tooltip.
useItemTooltip or useAxisTooltip hook to get the data, and wrap your component in ChartsTooltipContainer to follow the pointer position.ChartsItemTooltipContent or ChartsItemTooltipContent to get default data and place them in your custom tooltip.The library now uses the SVG filter attribute instead of d3-color for color manipulation.
LinePlot, AreaPlot, and BarPlot components.
If you've customized the fill of those elements, you might need to override it by using the CSS filter.theme.styleOverride is removed for MuiLineElement, MuiAreaElement, and MuiBarElement to improve performance.
You can still target those elements by using the MuiLinePlot, MuiAreaPlot, and MuiBarPlot and target the appropriate classes lineElementClasses.root, areaElementClasses.root, barElementClasses.rootRemoved the resolveSizeBeforeRender prop from all chart components — Learn more.
Removed width and height props from the ChartsSurface component.
Removed the viewport prop from all charts.
@mui/x-charts@v8.0.0-alpha.1<ChartDataProvider /> and <ChartsSurface /> (#15375) @JCQuintas<ChartsGrid /> component (#15463) @alexfauquette<SvgRefProvider /> to split the received ref (#15424) @JCQuintasd3-color with CSS filter for highlight (#15084) @alexfauquette<DrawingProvider /> into <DrawingAreaProvider /> and <SvgRefProvider /> (#15417) @JCQuintas@mui/x-charts-pro@v8.0.0-alpha.1 Same changes as in @mui/x-charts@v8.0.0-alpha.1.
publicAPI methods in the render because they are now memoized — Learn more.@mui/x-tree-view@v8.0.0-alpha.1treeId from the item context (#15542) @flaviendelanglemoveItemInTree() (#15539) @flaviendelangleslotProps.groupTransition (#15534) @flaviendelangle'DensitySelectorGrid' to time-sensitive argos tests (#15425) @JCQuintasaction pins (#15462) @LukasTy.ts demo files (#15345) @KenanYusuf[docs] Add migration guide for the first breaking changes of charts (#15276) @alexfauquette
<img width="100%" alt="MUI X v8 Alpha is live" src="https://github.com/user-attachments/assets/114cf615-b617-435f-8499-76ac3c26c57b"> <br /> <br />
We'd like to offer a big thanks to the 22 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @belkocik, @GeorgiosDrivas, @k-rajat19, @kalyan90, @DungTiger, @fxnoob, @GuillaumeMeheut
Following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @arthurbalduini, @cherniavskii, @flaviendelangle, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi, @michelengelen, @noraleonte, @oliviertassinari, @romgrk, @samuelsycamore, @joserodolfofreitas.
@mui/x-data-grid@8.0.0-alpha.0onPaginationModelChange callback (#13959) @DungTigerbaseMenuList and baseMenuItem (#15049) @romgrk@mui/x-data-grid-pro@8.0.0-alpha.0 Same changes as in @mui/x-data-grid@8.0.0-alpha.0, plus:
@mui/x-data-grid-premium@8.0.0-alpha.0 Same changes as in @mui/x-data-grid-pro@8.0.0-alpha.0, plus:
The default DOM structure of the field has changed Learn more.
v8.x, the fields' DOM structure consisted of an <input />, which held the whole value for the component, but unfortunately presents a few limitations in terms of accessibility when managing multiple section values.v8.x, all the field and picker components come with a new DOM structure that allows the field component to set aria attributes on individual sections, providing a far better experience with screen readers.Some translation keys no longer require utils and the date object as parameters, but only the formatted value as a string. The keys affected by this changes are: clockLabelText, openDatePickerDialogue and openTimePickerDialogue — Learn more.
The following types are no longer exported by @mui/x-date-pickers and @mui/x-date-pickers-pro — Learn more.
UseDateFieldComponentPropsUseTimeFieldComponentPropsUseDateTimeFieldComponentPropsBaseSingleInputFieldPropsBaseMultiInputFieldPropsBasePickersTextFieldPropsThe TDate generic has been removed from all the types, interfaces, and variables of the @mui/x-date-pickers and @mui/x-date-pickers-pro packages — Learn more.
Renamed usePickersTranslations and usePickersContext hooks to have a coherent Picker prefix instead of Pickers — Learn more.
The LicenseInfo object is no longer exported from the @mui/x-date-pickers-pro package — Learn more.
@mui/x-date-pickers@8.0.0-alpha.0UseDateFieldComponentProps and equivalent interfaces (#15053) @flaviendelangleownerState object (#15056) @flaviendelangleownerState of the field and actionBar slots when resolved in a picker component (#15162) @flaviendelangleDateCalendar timezone management (#12321) @LukasTyDateTimeRangePicker error when using format without time (#14917) @fxnoobDigitalClock time options on a DST switch day (#10793) @LukasTyTDate generics in favor of PickerValidDate direct usage (#15001) @flaviendelangleutils and value params from translations (#14986) @arthurbalduini@mui/x-license (#14487) @k-rajat19disabled and readOnly props (#15304) @flaviendelangleownerState in DateCalendar, DateRangeCalendar, MonthCalendar and YearCalendar (#15171) @flaviendelangleownerState in usePickersLayout and useXXXPicker (#14994) @flaviendelangle@mui/x-date-pickers-pro@8.0.0-alpha.0 Same changes as in @mui/x-date-pickers@8.0.0-alpha.0.
The legend prop got removed. To pass props to the legend, use slotProps={{ legend: { ... } }} instead. This can be automatically done with the codemod as long as the legend prop does not come from a destructured object — Learn more.
The slots.legend does not receive the drawingArea prop. You can still access your custom legend with the useDrawingArea() hook if your custom legend needs it.
Removed or renamed multiple props from Series — Learn more.
highlighted and faded properties of highlightScope were deprecated in favor of highlight and fade.
The deprecated ones are now removed.xAxisKey, yAxisKey, and zAxisKey properties got deprecated in favor of xAxisId, yAxisId, and zAxisId.The Pie Chart lost all props and renderer linked to axes because pie chart does not need cartesian axes. If you used it, you can still add them back with composition. Please consider opening an issue to share your use case with us — Learn more.
@mui/x-charts@8.0.0-alpha.0hideLegend prop (#15277) @alexfauquettenull data (#15337) @alexfauquettexAxisKey, yAxisKey, and zAxisKey series keys (#15192) @alexfauquettelegend props (#15081) @alexfauquettegetSymbol method (#15233) @romgrk@mui/x-charts-pro@8.0.0-alpha.0 Same changes as in @mui/x-charts@8.0.0-alpha.0.
The ContentComponent or ContentProps props of the <TreeItem /> component have been removed in favor of the new slots, slotProps props and of the useTreeItem hook — Learn more.
The onClick and onMouseDown callbacks of the Tree Item component are now passed to the root element instead of the content — Learn more.
Rename the <TreeItem2 /> component (and related utils) — Learn more.
The <TreeView /> component has been renamed <SimpleTreeView /> which has exactly the same API — Learn more.
The indentation of nested Tree Items is now applied on the content of the element — Learn more.
@mui/x-tree-view@8.0.0-alpha.0TreeView component (#15093) @flaviendelangle<TreeItem /> with <TreeItem2 /> and migrate all the components and utils (#14913) @flaviendelangleLicenseInfo from @mui/x-date-pickers-pro (#15321) @flaviendelanglePickersPopper component to the Date Picker customization playground (#15305) @LukasTyAutocomplete Field demo (#15165) @flaviendelangleapplyDomain docs for the charts (#15332) @JCQuintasAdapterMomentHijri doc section (#15312) @flaviendelanglePickersTextField in the customization playground (#15288) @LukasTynext instead of ^8.0.0 in the migration guides (#15091) @flaviendelanglecherry-pick GitHub actions (#15099) @LukasTy() at the name of function name in the doc (#15075) @oliviertassinarimaster @oliviertassinaritools-public.mui.com redirection @oliviertassinarihelpers to @mui/x-internals package (#15188) @LukasTyWe'd like to offer a big thanks to the 8 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 8 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @lubka272, @ptuukkan, @iddan, @sofortdagmbh
Following are all team members who have contributed to this release: @michelengelen, @oliviertassinari, @michelengelen, @LukasTy.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.29.0@mui/x-data-grid-pro@7.29.0 Same changes as in @mui/x-data-grid@7.29.0.
@mui/x-data-grid-premium@7.29.0 Same changes as in @mui/x-data-grid-pro@7.29.0, plus:
@mui/x-date-pickers@7.29.0@mui/x-date-pickers-pro@7.29.0 Same changes as in @mui/x-date-pickers@7.29.0.
@mui/x-charts@7.29.0Internal changes.
@mui/x-charts-pro@7.29.0 Same changes as in @mui/x-charts@7.29.0.
@mui/x-tree-view@7.29.0Internal changes.
@mui/x-tree-view-pro@7.29.0 Same changes as in @mui/x-tree-view@7.29.0.
@mui dependency versions (#17390) @LukasTyWe'd like to offer a big thanks to the 10 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 10 contributors who made this release possible. Here are some highlights ✨:
@mui/material version 7 in all X packagesSpecial 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.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.28.0toggleMenu click (#16909) @michelengelenprocessRowUpdate() error if the row is removed before it is executed (#16904) @arminmehprintOptions not respecting hideFooter root prop (#16915) @k-rajat19@mui/x-data-grid-pro@7.28.0 Same changes as in @mui/x-data-grid@7.28.0, plus:
@mui/x-data-grid-premium@7.28.0 Same changes as in @mui/x-data-grid-pro@7.28.0, plus:
@mui/x-date-pickers@7.28.0@mui/x-date-pickers-pro@7.28.0 Same changes as in @mui/x-date-pickers@7.28.0, plus:
@mui/x-charts@7.28.0Internal changes.
@mui/x-charts-pro@7.28.0 Same changes as in @mui/x-charts@7.28.0.
@mui/x-tree-view@7.28.0Internal changes.
@mui/x-tree-view-pro@7.28.0 Same changes as in @mui/x-tree-view@7.28.0.
@mui/material v7 in dependencies (#16951) @LukasTyWe'd like to offer a big thanks to the 6 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 6 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @lauri865. Following are all team members who have contributed to this release: @arminmeh, @noraleonte, @LukasTy, @KenanYusuf, @flaviendelangle.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.26.0<GridRoot /> double-render pass on mount in SPA mode (#16480) @lauri865@mui/x-data-grid-pro@7.26.0 Same changes as in @mui/x-data-grid@7.26.0, plus:
useGridApiContext() for Pro and Premium packages on React < 19 (#16446) @arminmeh@mui/x-data-grid-premium@7.26.0 Same changes as in @mui/x-data-grid-pro@7.26.0, plus:
@mui/x-date-pickers@7.26.0Internal changes.
@mui/x-date-pickers-pro@7.26.0 Same changes as in @mui/x-date-pickers@7.26.0, plus:
currentMonthCalendarPosition prop behavior on mobile (#16457) @LukasTy@mui/x-charts@7.26.0Internal changes.
@mui/x-charts-pro@7.26.0 Same changes as in @mui/x-charts@7.26.0.
@mui/x-tree-view@7.26.0Internal changes.
@mui/x-tree-view-pro@7.26.0 Same changes as in @mui/x-tree-view@7.26.0.
We'd like to offer a big thanks to the 5 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 5 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @k-rajat19, @lauri865. Following are all team members who have contributed to this release: @KenanYusuf, @MBilalShafi, @arminmeh.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.25.0renderContext calculation with scroll bounce / over-scroll (#16368) @lauri865onClick prop on toolbar buttons (#16364) @KenanYusuficonContainer during autosizing (#16409) @michelengelen@mui/x-data-grid-pro@7.25.0 Same changes as in @mui/x-data-grid@7.25.0, plus:
useGridApiRef for Pro and Premium packages on React < 19 (#16348) @arminmeh@mui/x-data-grid-premium@7.25.0 Same changes as in @mui/x-data-grid-pro@7.25.0.
@mui/x-date-pickers@7.25.0Internal changes.
@mui/x-date-pickers-pro@7.25.0 Same changes as in @mui/x-date-pickers@7.25.0.
@mui/x-charts@7.25.0Internal changes.
@mui/x-charts-pro@7.25.0 Same changes as in @mui/x-charts@7.25.0.
@mui/x-tree-view@7.25.0Internal changes.
@mui/x-tree-view-pro@7.25.0 Same changes as in @mui/x-tree-view@7.25.0.
We'd like to offer a big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @mostafaRoosta74, @lauri865. Following are all team members who have contributed to this release: @alexfauquette, @JCQuintas, @cherniavskii, @LukasTy, @arminmeh.
@mui/x-data-grid@7.24.1apiRef to be MutableRefObject for React versions < 19 (#16320) @arminmeh@mui/x-data-grid-pro@7.24.1 Same changes as in @mui/x-data-grid@7.24.1.
@mui/x-data-grid-premium@7.24.1 Same changes as in @mui/x-data-grid-pro@7.24.1.
@mui/x-date-pickers@7.24.1all selected state on section edit (#16232) @LukasTy@mui/x-date-pickers-pro@7.24.1 Same changes as in @mui/x-date-pickers@7.24.1.
@mui/x-charts@7.24.1offset could be Infinite (@JCQuintas) (#16309) @JCQuintas@mui/x-charts-pro@7.24.1 Same changes as in @mui/x-charts@7.24.1.
@mui/x-tree-view@7.24.1Internal changes.
@mui/x-tree-view-pro@7.24.1 Same changes as in @mui/x-tree-view@7.24.1.
domainLimit definition (#16271) @alexfauquette@mui/x-internals a dependency of @mui/x-license (#16265) @alexfauquetteWe'd like to offer a big thanks to the 8 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 8 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @lauri865, @AxharKhan. Following are all team members who have contributed to this release: @KenanYusuf, @arminmeh, @cherniavskii, @michelengelen, @samuelsycamore, @LukasTy.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.24.0@mui/x-data-grid-pro@7.24.0 Same changes as in @mui/x-data-grid@7.24.0, plus:
@mui/x-data-grid-premium@7.24.0 Same changes as in @mui/x-data-grid-pro@7.24.0.
@mui/x-date-pickers@7.24.0Internal changes.
@mui/x-date-pickers-pro@7.24.0 Same changes as in @mui/x-date-pickers@7.24.0.
@mui/x-charts@7.24.0Internal changes.
@mui/x-charts-pro@7.24.0 Same changes as in @mui/x-charts@7.24.0.
@mui/x-tree-view@7.24.0Internal changes.
@mui/x-tree-view-pro@7.24.0 Same changes as in @mui/x-tree-view@7.24.0.
RefObject (#16125) @arminmehreact and react-dom definitions to simplify dep resolving (#16214) @LukasTyWe'd like to offer a big thanks to the 11 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 11 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community contributors who have helped make this release possible: @josteinjhauge, @derek-0000, @nusr, @k-rajat19, @tomashauser. Following are all team members who have contributed to this release: @flaviendelangle, @LukasTy, @MBilalShafi, @arminmeh, @oliviertassinari, @cherniavskii.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.23.6name attribute to selection checkboxes (#16041) @derek-0000@mui/x-data-grid-pro@7.23.6 Same changes as in @mui/x-data-grid@7.23.6.
@mui/x-data-grid-premium@7.23.6 Same changes as in @mui/x-data-grid-pro@7.23.6.
@mui/x-date-pickers@7.23.6date-fns-jalali v4 (#16013) @LukasTy@mui/x-date-pickers-pro@7.23.6 Same changes as in @mui/x-date-pickers@7.23.6.
@mui/x-charts@7.23.6@mui/x-charts-pro@7.23.6 Same changes as in @mui/x-charts@7.23.6.
@mui/x-tree-view@7.23.6@mui/x-tree-view-pro@7.23.6 Same changes as in @mui/x-tree-view@7.23.6.
EditingWithDatePickers demo (#16047) @k-rajat19LocalizationProvider (#16088) @tomashauserrelease:version docs (#16040) @cherniavskii🐞 Fix version mismatch issue in Data Grid codesandbox/stackblitz demos
Here are some highlights ✨:
@mui/x-data-grid@7.23.5No changes since @mui/x-data-grid@v7.23.4.
@mui/x-data-grid-pro@7.23.5 Same changes as in @mui/x-data-grid@7.23.5.
@mui/x-data-grid-premium@7.23.5 Same changes as in @mui/x-data-grid-pro@7.23.5.
We'd like to offer a big thanks to the 10 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 10 contributors who made this release possible. Here are some highlights ✨:
✨ Support for a new display mode on the Data Grid with the List View feature, offering an extremely flexible way to render datasets and enabling developers to adapt how data is displayed across different screen sizes.
https://github.com/user-attachments/assets/61286adc-03fc-4323-9739-8ca726fcc16c
⚛️ React 19 support
📚 Documentation improvements
🌍 Improve Spanish, Portuguese, Chinese locales on the Data Grid component.
🌍 Improve Dutch locale on the Date and Time Picker components.
🐞 Bugfixes
Special thanks go out to the community contributors who have helped make this release possible: @dloeda, @headironc, @mathzdev, @nphmuller, @lhilgert9, @lauri865. Following are all team members who have contributed to this release: @oliviertassinari, @arminmeh, @KenanYusuf, @flaviendelangle, @MBilalShafi.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@v7.23.0/jsdom/ to /jsdom|HappyDOM/. (#15642) @jedesrochesGridCell performance (#15621) @lauri865@mui/x-data-grid-pro@v7.23.0 Same changes as in @mui/x-data-grid@v7.23.0, plus:
boolean column type (#15640) @k-rajat19@mui/x-data-grid-premium@v7.23.0 Same changes as in @mui/x-data-grid-pro@v7.23.0.
@mui/x-date-pickers@v7.23.0America/Asuncion timezone and AdapterMoment (#15653) @flaviendelangleprops.referenceDate timezone when props.value and props.defaultValue are not defined (#15544) @flaviendelangle@mui/x-date-pickers-pro@v7.23.0 Same changes as in @mui/x-date-pickers@v7.23.0.
@mui/x-charts@v7.23.0releasePointerCapture (#15609) @alexfauquette@mui/x-charts-pro@v7.23.0 Same changes as in @mui/x-charts@v7.23.0.
@mui/x-tree-view@v7.23.0@mui/x-tree-view-pro@7.23.0 Same changes as in @mui/x-tree-view@7.23.0.
We'd like to offer a big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
dataset prop support for the Scatter Chart componentSpecial thanks go out to the community contributors who have helped make this release possible: @k-rajat19, @kalyan90, @rotembarsela, @wangkailang. Following are all team members who have contributed to this release: @arthurbalduini, @cherniavskii, @flaviendelangle, @JCQuintas, @LukasTy, @MBilalShafi, @arminmeh, @romgrk, @KenanYusuf, @oliviertassinari, @samuelsycamore.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.21.0onRowSelectionModelChange firing unnecessarily on initial render (#14909) @MBilalShafionRowSelectionModelChange not being called after row is removed (#14972) @arminmeh@mui/x-data-grid-pro@7.21.0 Same changes as in @mui/x-data-grid@7.21.0, plus:
rowHeight={undefined} (#14983) @cherniavskii@mui/x-data-grid-premium@7.21.0 Same changes as in @mui/x-data-grid-pro@7.21.0.
@mui/x-date-pickers@7.21.0PageUp and PageDown event handlers on time components (#14928) @arthurbalduiniownerState object (#14889) @flaviendelanglePickerValidDate usage in the Date Range Picker Toolbar (#14925) @flaviendelangle@mui/x-date-pickers-pro@7.21.0 Same changes as in @mui/x-date-pickers@7.21.0.
@mui/x-charts@7.21.0dataset to be used with the Scatter Chart (#14915) @JCQuintasreduce motion preference disables animation on page load (#14417) @JCQuintas@mui/x-charts-pro@7.0.0-beta.5 Same changes as in @mui/x-charts@7.21.0.
@mui/x-tree-view@7.21.0alpha usage with CSS variables (#14969) @wangkailangaria-selected attribute (#14991) @flaviendelangle@mui/x-codemod@7.21.0vitest/playwright (#14926) @JCQuintasAdapterDayjs coverage calculation (#14957) @LukasTyThe old APIs (props.ContentComponent and props.ContentProps) have been deprecated and will be removed in the new major version of the Tree View compon…
We'd like to offer a big thanks to the 14 contributors who made this release possible. Here are some highlights ✨:
props.ContentComponent and props.ContentProps) have been deprecated and will be removed in the new major version of the Tree View component.Special thanks go out to the community contributors who have helped make this release possible: @k-rajat19, @kalyan90, @uma-neko, @vfbiby. Following are all team members who have contributed to this release: @alelthomas, @arminmeh, @arthurbalduini, @cherniavskii, @flaviendelangle, @JCQuintas, @MBilalShafi, @noraleonte, @oliviertassinari, @samuelsycamore, @siriwatknp.
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.20.0onColumnHeaderContextMenu event (#14734) @vfbibyscrollToIndexes (#14888) @arminmehrowId param to processRowUpdate (#14821) @k-rajat19@mui/x-data-grid-pro@7.20.0 Same changes as in @mui/x-data-grid@7.20.0, plus:
rowSelectionPropagation JSDoc and doc section (#14907) @flaviendelangle@mui/x-data-grid-premium@7.20.0 Same changes as in @mui/x-data-grid-pro@7.20.0.
@mui/x-date-pickers@7.20.0PageUp and PageDown support for time components (#14812) @arthurbalduiniPickerValidDate (#14896) @flaviendelangleDateFieldInPickerProps interface to the DatePicker folder and rename it DatePickerFieldProps (same for time and date time) (#14828) @flaviendelangle@mui/x-date-pickers-pro@7.20.0 Same changes as in @mui/x-date-pickers@7.20.0.
@mui/x-charts@7.20.0No changes since @mui/x-charts@v7.19.0.
@mui/x-charts-pro@7.0.0-beta.4 Same changes as in @mui/x-charts@7.20.0.
@mui/x-tree-view@7.20.0ContentComponent and ContentProps props (#14908) @flaviendelangletooltip and highlighting pages (#14824) @JCQuintasTreeItem2 component and the useTreeItem2 hook (#14551) @noraleonte@mui/utils v6 (#14867) @siriwatknpdata-mui-test in favour of data-testid (#14882) @JCQuintasvitest group (#14856) @JCQuintaswaitFor() with act() (#14851) @oliviertassinariWe'd like to offer a big thanks to the 14 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 14 contributors who made this release possible. Here are some highlights ✨:
💫 Support Row spanning on the Data Grid that automatically merges the consecutive cells in a column based on the cell value
<img height="326" src="https://github.com/user-attachments/assets/03960387-0cc2-44da-9c6a-6c438a45fa50" alt="data grid row spanning" />
⏰ Support date-fns v4 (#14673) @LukasTy
🎉 Add option for Pickers to change the order of displayed years (#11780) @thomasmoon
🐞 Bugfixes
📚 Documentation improvements
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.18.0columnGroupHeaderHeight prop for sizing column group headers (#14637) @KenanYusufdocument reference when the grid is rendered in a popup window (#14649) @arminmehminFirstColumn from GetHeadersParams interface (#14450) @k-rajat19@mui/x-data-grid-pro@7.18.0 Same changes as in @mui/x-data-grid@7.18.0, plus:
onRowsScrollEnd being triggered instantly when bottom pinned row is present (#14602) @arminmehisEmpty and isNotEmpty filter operators (#14493) @k-rajat19@mui/x-data-grid-premium@7.18.0 Same changes as in @mui/x-data-grid-pro@7.18.0.
@mui/x-date-pickers@7.18.0date-fns v4 (#14673) @LukasTy@mui/x-date-pickers-pro@7.18.0 Same changes as in @mui/x-date-pickers@7.18.0.
@mui/x-charts@7.18.0PolarProvider to manage polar axes (#14642) @alexfauquetteLineChart animation being stuck with initial drawing area value (#14553) @JCQuintas@mui/x-charts-pro@7.0.0-beta.1 Same changes as in @mui/x-charts@7.18.0.
@mui/x-tree-view@7.18.0"use client" directive to every public component and hook (#14579) @flaviendelanglegroupingValueGetter callout in column definition docs (#14599) @michelengelenvale-action.yml from main repo @oliviertassinarivalueGetter and valueFormatter signature change (#14613) @cherniavskiimaster (#14644) @cherniavskiipackage.json repository rule @oliviertassinariobserve method to avoid flaky wait for a callback (#14640) @arminmehWe'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
@mui/x-data-grid@7.17.0:has() selectors (#14559) @KenanYusuf@mui/x-data-grid-pro@7.17.0 Same changes as in @mui/x-data-grid@7.17.0.
@mui/x-data-grid-premium@7.17.0 Same changes as in @mui/x-data-grid-pro@7.17.0.
@mui/x-date-pickers@7.17.0useSplitFieldProps and make it public (#14514) @flaviendelangle"use client" directive to every public component and hook (#14562) @flaviendelangle@mui/x-date-pickers-pro@7.17.0 Same changes as in @mui/x-date-pickers@7.17.0, plus:
currentMonthCalendarPosition not scrolling to future sibling (#14442) @GMchris@mui/x-charts@7.17.0"use client" directive to every public component and hook (#14578) @flaviendelangleonItemClick on the Legend component (#14231) @JCQuintasonAxisClick with layout='horizontal' (#14547) @alexfauquettepath with circle for performance improvement (#14518) @alexfauquette@mui/x-charts-pro@7.0.0-beta.1 Same changes as in @mui/x-charts@7.17.0.
@mui/x-tree-view@7.17.0useTreeItem2 stable (#14498) @flaviendelangleconsole.error messages on charts docs (#14554) @JCQuintas@mui/x-internals (#14528) @k-rajat19ESLint plugins renovate group (#14574) @LukasTyact() logic (#14529) @oliviertassinariWe'd like to offer a big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
slots concept introduction documentation page (#13881)<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.16.0GridFilterInputMultipleValue (#14302) @sai6855columns and columnGroupingModel update (#14368) @cherniavskiiautoHeight prop enabled (#14235) @KenanYusuf@mui/x-data-grid-pro@7.16.0 Same changes as in @mui/x-data-grid@7.16.0, plus:
@mui/x-data-grid-premium@7.16.0 Same changes as in @mui/x-data-grid-pro@7.16.0.
@mui/x-date-pickers@7.16.0onError JSDoc (#14492) @flaviendelangle@mui/x-date-pickers-pro@7.16.0 Same changes as in @mui/x-date-pickers@7.16.0.
@mui/x-charts@7.16.0LineChart not properly animating when hydrating (#14355) @JCQuintas.mjs extension for ESM build (#14387) @alexfauquettepackage.json for vendor package (#14465) @alexfauquette@mui/x-charts-pro@7.0.0-beta.0 Same changes as in @mui/x-charts@7.16.0, plus:
BarChartPro and LineChartPro (#14391) @JCQuintas@mui/x-tree-view@7.16.0@mui/x-codemod@7.16.0experimentalFeatures codemod for typescript parser (#14150) @MBilalShafislots concept introduction page (#13881) @flaviendelanglePieChart examples (#14297) @JCQuintassecrets: inherit to workflow call (#14454) @michelengelen[docs] Update deprecated props in docs (#14295) @JCQuintas
We'd like to offer a big thanks to the 8 contributors who made this release possible. Here are some highlights ✨:
@mui/material@6) peer dependency (#14142) @cherniavskiiYou can now use MUI X components with either v5 or v6 of @mui/material package 🎉
@mui/x-data-grid-pro@7.15.0 GridRowReorderCell component (#14079) @genepaul@mui/x-data-grid-premium@7.15.0 Same changes as in @mui/x-data-grid-pro@7.15.0.
@mui/x-date-pickers@7.15.0onTouchStart handler for TimeClock (#14305) @arthurbalduini@mui/x-date-pickers-pro@7.15.0 Same changes as in @mui/x-date-pickers@7.15.0, plus:
@mui/x-charts@7.15.0themeAugmentation in pro plan (#14313) @lhilgert9LineChart transition stopping before completion (#14366) @JCQuintas@mui/x-charts-pro@7.0.0-alpha.3 Same changes as in @mui/x-charts@7.15.0, plus:
@mui/x-charts package (#14335) @LukasTyh2 @oliviertassinariMUI Core renovate group (#14382) @LukasTy@mui/material@6 (#14357) @cherniavskiinext releases of @mui/docs (#14364) @LukasTy@mui/material@6 peer dependency (#14142) @cherniavskiiuseRtl instead of useTheme to access direction (#14359) @LukasTyWe'd like to offer a big thanks to the 14 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 14 contributors who made this release possible. Here are some highlights ✨:
💫 Allow filtering the axis on zoom, making the axis adapt by removing values outside the view.
<img width="600" src="https://github.com/user-attachments/assets/e65bbd00-d2a8-4136-81cd-3598f1373c16" alt="filtering the axis on zoom" />
📊 Improve bar chart performances
🌍 Improve Czech (cs-CZ) and Hebrew (he-IL) locales on the Data Grid
🌍 Improve Chinese (zh-HK), Hebrew (he-IL), and Vietnamese (vi-VN) locales on the Date and Time Pickers
🐞 Bugfixes
@mui/x-data-grid@7.14.0getTreeDataPath (#11743) @pcorpetevent.key for Tab and Escape keys (#14170) @k-rajat19api in gridCellParams interface (#14201) @k-rajat19@mui/x-data-grid-pro@7.14.0 Same changes as in @mui/x-data-grid@7.14.0.
@mui/x-data-grid-premium@7.14.0 Same changes as in @mui/x-data-grid-pro@7.14.0, plus:
onCellSelectionModelChange not triggered when additional cell range is selected (#14199) @arminmeh@mui/x-date-pickers@7.14.0Space and Enter on the TimeClock component @arthurbalduini@mui/x-date-pickers-pro@7.14.0 Same changes as in @mui/x-date-pickers@7.14.0.
@mui/x-charts@7.14.0isPointInside function for both graphs and axis (#14222) @JCQuintas@mui/x-charts-pro@7.0.0-alpha.2 Same changes as in @mui/x-charts@7.14.0, plus:
eslint-plugin-testing-library (#14232) @LukasTyWe'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
https://github.com/user-attachments/assets/cfd27be0-740f-48d4-9a6e-84c06edda376
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.13.0null and undefined values (#14166) @k-rajat19useGridStateInitialization (#14181) @k-rajat19@mui/x-data-grid-pro@7.13.0 Same changes as in @mui/x-data-grid@7.13.0, plus:
@mui/x-data-grid-premium@7.13.0 Same changes as in @mui/x-data-grid-pro@7.13.0.
@mui/x-date-pickers@7.13.0@mui/x-date-pickers-pro@7.13.0 Same changes as in @mui/x-date-pickers@7.13.0.
@mui/x-charts@7.13.0baseline property to the LineChart series (#14153) @JCQuintasCartesianContextProvider to CartesianProvider (#14102) @JCQuintas@mui/x-date-charts-pro@7.0.0-alpha.1 Same changes as in @mui/x-charts@7.13.0.
@mui/x-tree-view@7.13.0canMoveItemToNewPosition prop (#14176) @flaviendelanglecache-docs plugin setup (#14105) @LukasTyThe Pro plan is receiving two new packages:
The Pro plan is receiving two new packages:
@mui/x-tree-view-pro (available today!)@mui/x-charts-pro (available in the coming weeks)As always, every feature released as part of the MIT plan will remain free and MIT licensed forever.
This expansion of the Pro plan comes with some adjustments to our pricing strategy. Learn more about those in the Upcoming changes to MUI X pricing in 2024 blog post.
We'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
🎁 Introduce item reordering using drag and drop on the RichTreeViewPro component
<img width="287" src="https://github.com/user-attachments/assets/78bd83c5-7ce4-4ed7-acf9-be70b2dbce54" alt="Item reordering using drag and drop" />
📦 Support CommonJS bundle out of the box on @mui/x-charts by adding vendored D3 dependencies.
This modifies how the package imports D3.js. It will impact you if you use d3 packages installed by @mui/x-charts and don't have them in your package.json. You shouldn't be affected otherwise.
For more context, the initial issue is caused by D3 only exporting ESM.
The solution up until now was to export charts with only ESM. But some frameworks are confused by this configuration.
So in order to fix this, we are providing a CJS version of D3.
🌍 Improve Turkish (tr-TR) locale on the Data Grid
🌍 Improve Finnish (fi-FI) locale on the Date and Time Pickers
🐞 Bugfixes
📚 Documentation improvements
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.12.0role=presentation a11y issue (#13891) @romgrk@mui/x-data-grid-pro@7.12.0 Same changes as in @mui/x-data-grid@7.12.0.
@mui/x-data-grid-premium@7.12.0 Same changes as in @mui/x-data-grid-pro@7.12.0.
@mui/x-date-pickers@7.12.0@mui/x-date-pickers-pro@7.12.0 Same changes as in @mui/x-date-pickers@7.12.0.
@mui/x-charts@7.12.0axisId prop being allowed in xAxis/yAxis config. Use id instead. (#13986) @JCQuintasSeriesProvider to use in filtering (#14026) @JCQuintas@mui/x-tree-view@7.12.0onItemClick on the Tree View components (#14018) @flaviendelangleisEventTargetInDescendants (#13982) @flaviendelangleminDate and maxDate default description (#14024) @LukasTyrenderCell & autogenerated rows (#13879) @romgrkcharts performance with codspeed (#13952) @JCQuintasvale action paths filtering (#14038) @LukasTy[charts] Deprecate xAxisKey /zAxisKey in favor of xAxisId/zAxisId (#13940) @alexfauquette
We'd like to offer a big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
Zoom to be controllable for charts (#13858) @JCQuintas<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.11.1GridPreferencesPanel (#13934) @k-rajat19@mui/x-data-grid-pro@7.11.1 Same changes as in @mui/x-data-grid@7.11.1.
@mui/x-data-grid-premium@7.11.1 Same changes as in @mui/x-data-grid-pro@7.11.1, plus:
api object to events (#13893) @pcorpet@mui/x-date-pickers@7.11.1@mui/x-date-pickers-pro@7.11.1 Same changes as in @mui/x-date-pickers@7.11.1.
@mui/x-charts@7.11.1ownerState function to slotProps typing when available (#13965) @alexfauquetteZoom to be controllable (#13858) @JCQuintasxAxisKey /zAxisKey in favor of xAxisId/zAxisId (#13940) @alexfauquette@mui/x-tree-view@7.11.1SparkLineChart reference not being correctly capitalised (#13960) @duckboy81@mui/material-nextjs to MUI Core renovate group (#13966) @LukasTyuseReactVersion script from the monorepo (#13710) @cherniavskiiWe'd like to offer a big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.11.0gridEditRowsStateSelector (#13877) @romgrkcolumnResizeStop event not emitted when column is not resized (#13307) @mateuseapdate and datetime-local input types in GridFilterInputMultipleValue type (#13411) @karudedios@mui/x-data-grid-pro@7.11.0 Same changes as in @mui/x-data-grid@7.11.0.
@mui/x-data-grid-premium@7.11.0 Same changes as in @mui/x-data-grid-pro@7.11.0.
@mui/x-date-pickers@7.11.0Mui-selected class to TimeClock meridiem buttons (#13848) @LukasTy@mui/x-date-pickers-pro@7.11.0 Same changes as in @mui/x-date-pickers@7.11.0, plus:
name prop propagation regression (#13821) @LukasTy@mui/x-charts@7.11.0useChartContainerProps (#13817) @JCQuintasclassName to root element (#13647) @JCQuintas@mui/x-tree-view@7.11.0useTreeView hook (#13845) @flaviendelangleprocess.env.NODE_ENV in production (#13869) @cherniavskiionChange and onAccept props (#13543) @flaviendelanglerenovate group (#13846) @LukasTyimport/prefer-default-export rule @oliviertassinari...other and test imports in charts (#13844) @JCQuintasnext tag for @mui/docs package bumps (#13813) @LukasTy@mui/docs dependency (#13760) @LukasTyEventManager to @mui/x-internals package (#13815) @flaviendelangleWe'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.10.0'standard' in GridFilterInputMultipleValue (#13129) @tarunrajputreadonly on more array props (#13331) @pcorpet@mui/x-data-grid-pro@7.10.0 Same changes as in @mui/x-data-grid@7.10.0, plus:
@mui/x-data-grid-premium@7.10.0 Same changes as in @mui/x-data-grid-pro@7.10.0.
@mui/x-date-pickers@7.10.0readOnly flag (#13688) @LukasTy@mui/x-date-pickers-pro@7.10.0 Same changes as in @mui/x-date-pickers@7.10.0, plus:
calendarHeader slot props propagation (#13780) @LukasTyformat from given views (#13743) @LukasTy@mui/x-charts@7.10.0LineChart when using the log scale (#13791) @alexfauquetteOnSeriesItemClick documentation (#13761) @tonyhallett@mui/x-tree-view@7.10.0getItemTree and getItemOrderedChildrenIds methods to the public API (#13804) @flaviendelangleloading prop value (#13604) @oliviertassinariDateTimeRangePicker to the "Commonly used components" demo (#13775) @flaviendelangleDATA_GRID_PROPS_DEFAULT_VALUES alphabetically (#13783) @oliviertassinariWe'd like to offer a big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:
selectItem and getItemDOMElement methods to the TreeView component public APIusePickersTranslations hook public in the pickers component<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
@mui/x-data-grid@7.9.0pagination={undefined} (#13349) @sai6855@mui/x-data-grid-pro@7.9.0 Same changes as in @mui/x-data-grid@7.9.0.
@mui/x-data-grid-premium@7.9.0 Same changes as in @mui/x-data-grid-pro@7.9.0.
@mui/x-date-pickers@7.9.0usePickersTranslations hook public (#13657) @flaviendelangle@mui/x-date-pickers-pro@7.9.0 Same changes as in @mui/x-date-pickers@7.9.0.
@mui/x-charts@7.9.0Zoom&Pan to the Pro charts (unreleased) (#13405) @JCQuintas@mui/x-tree-view@7.9.0selectItem and getItemDOMElement methods to the public API (#13485) @flaviendelanglereact_next workflow in CircleCI (#13360) @cherniavskiijscodeshift-add-imports package (#13720) @LukasTy@mui/docs usage (#13713) @LukasTyOne column per month.