@mui/x-internals
Shared utilities used by MUI X packages. This package should never be installed or used directly.
Utility functions for the MUI X packages (internal use only).
Shared utilities used by MUI X packages. This package should never be installed or used directly.
For full v8 changelog, please refer to the v.8x branch.
All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.
Jan 14, 2026
We'd like to extend a big thank you to the 8 contributors who made this release possible. Here are some highlights ✨:
📊 The Chart legend now has an option that enables click to toggle visibility of series.
🐞 Bugfixes
The following team members contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @JCQuintas, @mapache-salvaje, @rita-codes, @Janpot
@mui/x-data-grid@8.25.0Internal changes.
@mui/x-data-grid-pro@8.25.0 Same changes as in @mui/x-data-grid@8.25.0.
@mui/x-data-grid-premium@8.25.0 Same changes as in @mui/x-data-grid-pro@8.25.0.
@mui/x-date-pickers@8.25.0Internal changes.
@mui/x-date-pickers-pro@8.25.0 Same changes as in @mui/x-date-pickers@8.25.0.
@mui/x-charts@8.25.0initialHiddenItems prop to set initial state (#20894) @JCQuintastouch-action: pan-y removal when zoom is disabled (#20852) @bernardobelchior@mui/x-charts-pro@8.25.0 Same changes as in @mui/x-charts@8.25.0, plus:
@mui/x-charts-premium@8.25.0 Same changes as in @mui/x-charts-pro@8.25.0, plus:
ChartContainerPremium (#20910) @bernardobelchiorChartDataProviderPremium tests (#20868) @bernardobelchior@mui/x-tree-view@8.25.0Internal changes.
@mui/x-tree-view-pro@8.25.0 Same changes as in @mui/x-tree-view@8.25.0.
@mui/x-codemod@8.25.0Internal changes.
material-ui/disallow-react-api-in-server-components (#20909) @JCQuintasJan 8, 2026
We'd like to extend a big thank you to the 12 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to these community members for their valuable contributions: @anders-noerrelykke, @auloin, @sai6855, @yuito-it
The following team members contributed to this release: @alelthomas, @alexfauquette, @arminmeh, @bernardobelchior, @flaviendelangle, @JCQuintas, @mapache-salvaje, @siriwatknp
@mui/x-data-grid@8.24.0@mui/x-data-grid-pro@8.24.0 Same changes as in @mui/x-data-grid@8.24.0, plus:
density="compact" (#20834) @arminmeh@mui/x-data-grid-premium@8.24.0 Same changes as in @mui/x-data-grid-pro@8.24.0.
@mui/x-date-pickers@8.24.0@mui/x-date-pickers-pro@8.24.0 Same changes as in @mui/x-date-pickers@8.24.0.
@mui/x-charts@8.24.0VisibilityManager logic to allow managing series/items (#20571) @JCQuintasidentifierSerializer configuration (#20775) @JCQuintasserializeIdentifier instance function (#20791) @JCQuintasPieChart and PieChartPro to use slots and slotProps directly (#20795) @sai6855useRegisterPointerEventHandlers (#20824) @bernardobelchior@mui/x-charts-pro@8.24.0 Same changes as in @mui/x-charts@8.24.0, plus:
slotProps.toolbar to Toolbar in PieChartPro (#20796) @sai6855@mui/x-charts-premium@8.24.0 Same changes as in @mui/x-charts-pro@8.24.0, plus:
@mui/x-tree-view@8.24.0@mui/x-tree-view-pro@8.24.0 Same changes as in @mui/x-tree-view@8.24.0.
@mui/x-codemod@8.24.0Internal changes.
onAccept's context.source documentation to use 'view' instead of 'picker' (#20465) @auloinglob-gitignore (#20801) @bernardobelchiornyc (#20804) @bernardobelchiorstream-browserify and null-loader (#20805) @bernardobelchiorstylelint-config-tailwindcss (#20807) @bernardobelchiorpath package (#20802) @bernardobelchiorinternal slot to properly generate components CSS layer (#20763) @siriwatknpDec 24, 2025
We'd like to extend a big thank you to the 12 contributors who made this release possible. Here are some highlights ✨:
size, size(true), and size(false) aggregations for 'boolean' column typeSpecial thanks go out to these community members for their valuable contributions: @henkerik, @sai6855
The following team members contributed to this release: @alelthomas, @alexfauquette, @arminmeh, @bernardobelchior, @brijeshb42, @flaviendelangle, @JCQuintas, @mapache-salvaje, @MBilalShafi, @siriwatknp
@mui/x-data-grid@8.23.0includeHeaderFilters flag to include header filters when autosizing columns (#20510) @siriwatknpEnter key down when starting editing (#20751) @siriwatknp@mui/x-data-grid-pro@8.23.0 Same changes as in @mui/x-data-grid@8.23.0, plus:
@mui/x-data-grid-premium@8.23.0 Same changes as in @mui/x-data-grid-pro@8.23.0, plus:
'boolean' column type (#20683) @arminmehisRowSelectable() checks for the rows missing due to keepNonExistentRowsSelected (#20668) @arminmeh@mui/x-date-pickers@8.23.0Internal changes.
@mui/x-date-pickers-pro@8.23.0 Same changes as in @mui/x-date-pickers@8.23.0.
@mui/x-charts@8.23.0x-charts-vendor (#20685) @henkerik@mui/x-charts-pro@8.23.0 Same changes as in @mui/x-charts@8.23.0, plus:
@mui/x-charts-premium@8.23.0 Same changes as in @mui/x-charts-pro@8.23.0.
@mui/x-tree-view@8.23.0@mui/x-tree-view-pro@8.23.0 Same changes as in @mui/x-tree-view@8.23.0.
@mui/x-codemod@8.23.0Internal changes.
ColumnPinningDynamicRowHeight demo (#20750) @sai6855Dec 17, 2025
We'd like to extend a big thank you to the 13 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community members for their valuable contributions: @KyeongJooni, @VismaAndreasIvarsson
The following team members contributed to this release: @alelthomas, @alexfauquette, @arminmeh, @bernardobelchior, @Janpot, @JCQuintas, @mapache-salvaje, @michelengelen, @mj12albert, @prakhargupta1, @romgrk, @siriwatknp
@mui/x-data-grid@8.22.1@mui/x-data-grid-pro@8.22.1 Same changes as in @mui/x-data-grid@8.22.1.
@mui/x-data-grid-premium@8.22.1 Same changes as in @mui/x-data-grid-pro@8.22.1, plus:
useId() from @mui/utils to maintain React 17 compatibility (#20635) @arminmeh@mui/x-date-pickers@8.22.1onAccept() returning wrong year after selecting year then month (#20639) @michelengelen@mui/x-date-pickers-pro@8.22.1 Same changes as in @mui/x-date-pickers@8.22.1.
@mui/x-charts@8.22.1FocusedPieArc from PieArcPlot (#20613) @alexfauquetteuseSelector() => store.use() (#20681) @romgrk@mui/x-charts-pro@8.22.1 Same changes as in @mui/x-charts@8.22.1, plus:
@mui/x-charts-premium@8.22.1 Same changes as in @mui/x-charts-pro@8.22.1, plus:
BarChartPremium (#20643) @bernardobelchior@mui/x-tree-view@8.22.1Internal changes.
@mui/x-tree-view-pro@8.22.1 Same changes as in @mui/x-tree-view@8.22.1.
@mui/x-codemod@8.22.1Internal changes.
seriesConfig to prevent future confusion (#20678) @alexfauquetteDec 11, 2025
We'd like to extend a big thank you to the 11 contributors who made this release possible. Here are some highlights ✨:
Each Tree View component now exposes its own hook to initialize the apiRef object with accurate typing:
-import { useTreeViewApiRef } from '@mui/x-tree-view/hooks';
+import { useSimpleTreeViewApiRef } from '@mui/x-tree-view/hooks';
-const apiRef = useTreeViewApiRef();
+const apiRef = useSimpleTreeViewApiRef();
-import { useTreeViewApiRef } from '@mui/x-tree-view/hooks';
+import { useRichTreeViewApiRef } from '@mui/x-tree-view/hooks';
-const apiRef = useTreeViewApiRef();
+const apiRef = useRichTreeViewApiRef();
-import { useTreeViewApiRef } from '@mui/x-tree-view/hooks';
+import { useRichTreeViewProApiRef } from '@mui/x-tree-view-pro/hooks';
-const apiRef = useTreeViewApiRef();
+const apiRef = useRichTreeViewProApiRef();📚 Tutorial on building a Data Grid with server-side data
Special thanks go out to this community member for their valuable contributions: @kzhgit
The following team members contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @flaviendelangle, @JCQuintas, @mapache-salvaje, @michelengelen, @noraleonte, @oliviertassinari
@mui/x-data-grid@8.22.0color-mix if it is unsupported (#20597) @cherniavskiibaseTooltip slot for column header sort icon (#20460) @kzhgit@mui/x-data-grid-pro@8.22.0 Same changes as in @mui/x-data-grid@8.22.0.
@mui/x-data-grid-premium@8.22.0 Same changes as in @mui/x-data-grid-pro@8.22.0, plus:
valueFormatter (#20607) @arminmeh@mui/x-date-pickers@8.22.0@mui/x-date-pickers-pro@8.22.0 Same changes as in @mui/x-date-pickers@8.22.0.
@mui/x-charts@8.22.0MarkPlot by moving calculation to useMarkPlotData (#20570) @JCQuintasstore.state over store.getSnapshot() (#20616) @bernardobelchior@typescript-eslint/consistent-type-imports eslint rules (#20560) @JCQuintasimport/no-cycle eslint rules (#20554) @JCQuintas@mui/x-charts-pro@8.22.0 Same changes as in @mui/x-charts@8.22.0, plus:
@mui/x-charts-premium@8.22.0 Same changes as in @mui/x-charts-pro@8.22.0.
@mui/x-tree-view@8.22.0apiRef (#20235) @flaviendelangleupdateItemChildren() to accept null (#20483) @noraleonte@mui/x-tree-view-pro@8.22.0 Same changes as in @mui/x-tree-view@8.22.0.
@mui/x-codemod@8.22.0Internal changes.
aria-label (#20620) @alexfauquette@mui/monorepo digest to 800638d (#20337) @renovate[bot]@next/eslint-plugin-next to 15.5.7 (#20575) @renovate[bot]^5.90.12 (#20582) @renovate[bot]eslint to ^8.48.1 (#20576) @renovate[bot]markdown-to-jsx to ^9.3.2 (#20507) @renovate[bot]motion to ^12.23.25 (#20579) @renovate[bot]19.2.1 (#20581) @renovate[bot]react-hook-form to ^7.68.0 (#20584) @renovate[bot]react-router to ^7.10.1 (#20341) @renovate[bot]tsx to ^4.21.0 (#20585) @renovate[bot]Dec 3, 2025
We'd like to extend a big thank you to the 8 contributors who made this release possible. Here are some highlights ✨:
The following team members contributed to this release: @alexfauquette, @bernardobelchior, @ElliottMiller, @Janpot, @JCQuintas, @romgrk, @sai6855, @siriwatknp
@mui/x-data-grid@8.21.0@mui/x-data-grid-pro@8.21.0 Same changes as in @mui/x-data-grid@8.21.0.
@mui/x-data-grid-premium@8.21.0 Same changes as in @mui/x-data-grid-pro@8.21.0, plus:
@mui/x-date-pickers@8.21.0Internal changes.
@mui/x-date-pickers-pro@8.21.0 Same changes as in @mui/x-date-pickers@8.21.0.
@mui/x-charts@8.21.0any types (#20527) @sai6855drawingArea from findClosestPoints (#20471) @bernardobelchioruseIsHydrated to default=false (#20511) @JCQuintas@mui/x-charts-pro@8.21.0 Same changes as in @mui/x-charts@8.21.0, plus:
anchor="node" on Sankey tooltip (#20462) @alexfauquette@mui/x-charts-premium@8.21.0 Same changes as in @mui/x-charts-pro@8.21.0.
@mui/x-tree-view@8.21.0Internal changes.
@mui/x-tree-view-pro@8.21.0 Same changes as in @mui/x-tree-view@8.21.0.
@mui/x-codemod@8.21.0Internal changes.
next/font for fonts loading (#20407) @CopilotuseSyncExternalStore (#20447) @romgrkvitest/expect-expect and vitest/no-standalone-expect rules for x-charts packages (#20535) @CopilotNov 26, 2025
We'd like to extend a big thank you to the 8 contributors who made this release possible. Here are some highlights ✨:
The following team members contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @siriwatknp, @JCQuintas, @MBilalShafi, @prakhargupta1
@mui/x-data-grid@8.20.0viewport as a boundary for the BasePopper flip (#20311) @arminmeh@mui/x-data-grid-pro@8.20.0 Same changes as in @mui/x-data-grid@8.20.0, plus:
@mui/x-data-grid-premium@8.20.0 Same changes as in @mui/x-data-grid-pro@8.20.0.
@mui/x-charts@8.20.0@mui/x-charts-pro@8.20.0 Same changes as in @mui/x-charts@8.20.0, plus:
AreaPlotRoot styled component (#20414) @arminmeh@mui/x-charts-premium@8.20.0 Same changes as in @mui/x-charts-pro@8.20.0, plus:
ChartsRenderer for better compatibility with React 18 (#20413) @arminmehllms.txt link to the sidebar (#20312) @siriwatknpNov 20, 2025
We'd like to extend a big thank you to the 15 contributors who made this release possible. Here are some highlights ✨:
wheel to the charts zoomcolumns prop stable.Special thanks go out to these community members for their valuable contributions: @lauri865, @noobyogi0010, @sai6855
The following team members contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @flaviendelangle, @Janpot, @JCQuintas, @mj12albert, @noraleonte, @rita-codes, @siriwatknp, @ZeeshanTamboli
@mui/x-data-grid@8.19.0tabNavigation prop to control tab navigation in the grid (#20286) @arminmehautoHeight prop (#20363) @cherniavskii@mui/x-data-grid-pro@8.19.0 Same changes as in @mui/x-data-grid@8.19.0.
@mui/x-data-grid-premium@8.19.0 Same changes as in @mui/x-data-grid-pro@8.19.0, plus:
ExcelJS version (#20329) @cherniavskii@mui/x-date-pickers@8.19.0slotProps.field.slotProps (#20322) @flaviendelangle@mui/x-date-pickers-pro@8.19.0 Same changes as in @mui/x-date-pickers@8.19.0.
@mui/x-charts@8.19.0niceDomain utility (#20250) @bernardobelchiortouch-action: pan-y when zoom is disabled (#20204) @bernardobelchiorgetBBox() for correct SVG sizes in firefox (#20309) @JCQuintas@mui/x-internals (#20365) @alexfauquette@mui/x-charts-pro@8.19.0 Same changes as in @mui/x-charts@8.19.0, plus:
wheel to zoom (#19998) @JCQuintas@mui/x-charts-premium@8.19.0 Same changes as in @mui/x-charts-pro@8.19.0.
@mui/x-tree-view@8.19.0@mui/x-tree-view-pro@8.19.0 Same changes as in @mui/x-tree-view@8.19.0.
@mui/x-codemod@8.19.0Internal changes.
LoadingButton with Button component (#20208) @JanpotcheckMaterialVersion (#20307) @Janpot@docsearch/react (#20313) @Janpotuse-react-version pnpm script (#20319) @cherniavskiiNov 13, 2025
We'd like to extend a big thank you to the 14 contributors who made this release possible. Here are some highlights ✨:
Add barLabelPlacement property to customize the bar label position in bar charts, enabling labels to be placed above bars.
Add source property to the date/time picker lifecycle and event handler context, enabling clearer differentiation between changes initiated by the picker UI and those from direct field input.
Special thanks go out to these community members for their valuable contributions: @htollefsen, @sai6855, @Sigdriv
The following team members contributed to this release: @arminmeh, @bernardobelchior, @brijeshb42, @cherniavskii, @flaviendelangle, @JCQuintas, @michelengelen, @noraleonte, @prakhargupta1, @rita-codes, @siriwatknp
@mui/x-data-grid@8.18.0useGridApiRef (#20277) @cherniavskii@mui/x-data-grid-pro@8.18.0 Same changes as in @mui/x-data-grid@8.18.0.
@mui/x-data-grid-premium@8.18.0 Same changes as in @mui/x-data-grid-pro@8.18.0, plus:
cellParams value from the aggregation cells (#20224) @arminmeh@mui/x-date-pickers@8.18.0source property to onChange and onAccept context object (#20234) @michelengelen@mui/x-date-pickers-pro@8.18.0 Same changes as in @mui/x-date-pickers@8.18.0.
@mui/x-charts@8.18.0ChartAxisZoomSliderThumb (#20232) @sai6855@mui/x-charts-pro@8.18.0 Same changes as in @mui/x-charts@8.18.0, plus:
@mui/x-charts-premium@8.18.0 Same changes as in @mui/x-charts-pro@8.18.0.
@mui/x-tree-view@8.18.0TreeItemId type instead of raw string (#20233) @flaviendelangle@mui/x-tree-view-pro@8.18.0 Same changes as in @mui/x-tree-view@8.18.0.
@mui/x-codemod@8.18.0Internal changes.
useAxes() hook documentation page (#20229) @JCQuintasNov 5, 2025
We'd like to extend a big thank you to the 13 contributors who made this release possible. Here are some highlights ✨:
Add colorGetter prop to cartesian charts series
🌎 Add Catalan (ca-ES) locale on the Data Grid
Special thanks go out to these community members for their valuable contributions: @frncesc, @Methuselah96, @samuelwalk, @htollefsen
The following team members contributed to this release: @alexfauquette, @bernardobelchior, @flaviendelangle, @Janpot, @JCQuintas, @mnajdova, @rita-codes, @arminmeh, @brijeshb42
@mui/x-data-grid@8.17.0editable prop is updated in the column definition (#20147) @arminmeh@mui/x-data-grid-pro@8.17.0 Same changes as in @mui/x-data-grid@8.17.0.
@mui/x-data-grid-premium@8.17.0 Same changes as in @mui/x-data-grid-pro@8.17.0.
@mui/x-date-pickers@8.17.0Internal changes.
@mui/x-date-pickers-pro@8.17.0 Same changes as in @mui/x-date-pickers@8.17.0.
@mui/x-charts@8.17.0barLabel to bar series. Deprecate barLabel in BarPlot. (#20184) @bernardobelchiorChartsSurface classes (#20180) @bernardobelchioroverflow: scroll container (#20182) @bernardobelchior@mui/x-internals (#20052) @alexfauquette@mui/x-internals (#20121) @alexfauquetteuseDataset hook (#20205) @JCQuintas@mui/x-charts-pro@8.17.0 Same changes as in @mui/x-charts@8.17.0, plus:
@mui/x-charts-premium@8.17.0 Same changes as in @mui/x-charts-pro@8.17.0.
@mui/x-tree-view@8.17.0expandedItems prop (#20181) @Methuselah96aria-checked instead of aria-selected on items (#19851) @flaviendelangle@mui/x-tree-view-pro@8.17.0 Same changes as in @mui/x-tree-view@8.17.0.
@mui/x-codemod@8.17.0Internal changes.
getInitialProps with getStaticProps (#20192) @JanpotOct 29, 2025
We'd like to extend a big thank you to the 14 contributors who made this release possible. Here are some highlights ✨:
brush zoom interaction to chartsSpecial thanks go out to the community members for their valuable contributions: @felix-wg, @frncesc, @sai6855
The following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @brijeshb42, @flaviendelangle, @JCQuintas, @MBilalShafi, @mbrookes, @michelengelen, @noraleonte, @rita-codes
@mui/x-data-grid@8.16.0Ctrl+A key combination for the row selection in the community version (#20110) @felix-wg@mui/x-data-grid-pro@8.16.0 Same changes as in @mui/x-data-grid@8.16.0, plus:
getVisibleRowsLookup() to fix the build with tsc (#20116) @arminmeh@mui/x-data-grid-premium@8.16.0 Same changes as in @mui/x-data-grid-pro@8.16.0, plus:
valueFormatter() crash (#20070) @sai6855@mui/x-date-pickers@8.16.0@mui/x-date-pickers-pro@8.16.0 Same changes as in @mui/x-date-pickers@8.16.0.
@mui/x-charts@8.16.0undefined id and color in series (#20087) @bernardobelchioruseMemo from isZoomOnEnabled and isPanOnEnabled hooks (#20132) @Copilot@mui/x-charts-pro@8.16.0 Same changes as in @mui/x-charts@8.16.0, plus:
brush zoom interaction (#19899) @JCQuintas@mui/x-charts-premium@8.16.0 Same changes as in @mui/x-charts-pro@8.16.0.
@mui/x-tree-view@8.16.0Internal changes.
@mui/x-tree-view-pro@8.16.0 Same changes as in @mui/x-tree-view@8.16.0.
@mui/x-codemod@8.16.0Internal changes.
rows prop documentation (#20127) @MBilalShafiOct 23, 2025
We'd like to extend a big thank you to the 14 contributors who made this release possible. Here are some highlights ✨:
brush charts interaction for building custom behavior.
Special thanks go out to the community members for their valuable contributions: @ZagrebaAlex
The following are all team members who have contributed to this release: @alexfauquette, @bernardobelchior, @cherniavskii, @flaviendelangle, @Janpot, @JCQuintas, @KenanYusuf, @prakhargupta1, @rita-codes, @siriwatknp, @arminmeh, @brijeshb42, @noraleonte
@mui/x-data-grid@8.15.0dataSource.fetchRows API's return type (#20068) @arminmeh@mui/x-data-grid-pro@8.15.0 Same changes as in @mui/x-data-grid@8.15.0, plus:
@mui/x-data-grid-premium@8.15.0 Same changes as in @mui/x-data-grid-pro@8.15.0, plus:
@mui/x-date-pickers@8.15.0Internal changes.
@mui/x-date-pickers-pro@8.15.0 Same changes as in @mui/x-date-pickers@8.15.0.
@mui/x-charts@8.15.0ChartsBrushOverlay and allow brush configuration (#19956) @JCQuintasgetStringSize benchmark. Remove benchmarks from built package. (#19995) @bernardobelchiorgetStringSize and batchMeasureStrings performance (#19996) @bernardobelchior@mui/x-charts-pro@8.15.0 Same changes as in @mui/x-charts@8.15.0, plus:
axis.reverse (#20031) @JCQuintas@mui/x-charts-premium@8.15.0 Same changes as in @mui/x-charts-pro@8.15.0.
@mui/x-tree-view@8.15.0@mui/x-tree-view-pro@8.15.0 Same changes as in @mui/x-tree-view@8.15.0.
@mui/x-codemod@8.14.0Internal changes.
environment: 'browser' from vitest browser config (#19993) @bernardobelchiorOct 16, 2025
We'd like to extend a big thank you to the 14 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community members for their valuable contributions: @djpremier, @jacknot, @justdoit1897, @mellis481, @sai6855
The following are all team members who have contributed to this release: @arminmeh, @bernardobelchior, @brijeshb42, @cherniavskii, @flaviendelangle, @Janpot, @JCQuintas, @noraleonte, @siriwatknp
@mui/x-data-grid@8.14.1isCellEditable prop change (#19898) @cherniavskii@mui/x-data-grid-pro@8.14.1 Same changes as in @mui/x-data-grid@8.14.1, plus:
@mui/x-data-grid-premium@8.14.1 Same changes as in @mui/x-data-grid-pro@8.14.1.
@mui/x-date-pickers@8.14.1Internal changes.
@mui/x-date-pickers-pro@8.14.1 Same changes as in @mui/x-date-pickers@8.14.1.
@mui/x-charts@8.14.1minBarSize when y-axis is reversed (#19932) @bernardobelchiordatasetKeys.id not being optional (#19897) @bernardobelchiorGaugeValueArc having wrong class (#19965) @bernardobelchiorundefined path when highlight empty line chart axis (#19969) @bernardobelchior@mui/x-charts-pro@8.14.1 Same changes as in @mui/x-charts@8.14.1, plus:
highlighting to Sankey chart (#19662) @JCQuintas@mui/x-charts-premium@8.14.1 Same changes as in @mui/x-charts-pro@8.14.1.
@mui/x-tree-view@8.14.1ownerState to the icon (#19772) @flaviendelangle@mui/x-tree-view-pro@8.14.1 Same changes as in @mui/x-tree-view@8.14.1.
@mui/x-codemod@8.14.0Internal changes.
'bumpX' and 'bumpY' curve types to the interpolation demo (#19676) @djpremierisExpanded type in tree view docs (#19092) @mellis481Oct 9, 2025
We'd like to extend a big thank you to the 14 contributors who made this release possible. Here are some highlights ✨:
pressAndDrag gesture. Pan by pressing and dragging.Special thanks go out to the community members for their valuable contributions: @djpremier, @Utkarsh-0304
The following are all team members who have contributed to this release: @alexfauquette, @bernardobelchior, @flaviendelangle, @hasdfa, @Janpot, @JCQuintas, @prakhargupta1, @rita-codes, @noraleonte, @brijeshb42, @arminmeh, @michelengelen
@mui/x-data-grid@8.14.0@mui/x-data-grid-pro@8.14.0 Same changes as in @mui/x-data-grid@8.14.0.
@mui/x-data-grid-premium@8.14.0 Same changes as in @mui/x-data-grid-pro@8.14.0, plus:
@mui/x-date-pickers@8.14.0autoCapitalize value for Firefox compatibility (#19285) @michelengelen@mui/x-date-pickers-pro@8.14.0 Same changes as in @mui/x-date-pickers@8.14.0.
@mui/x-charts@8.14.0pressAndDrag pan gesture (#19779) @JCQuintasminPointers and maxPointers to be configured by pointer type (#19794) @JCQuintas@mui/x-charts-pro@8.14.0 Same changes as in @mui/x-charts@8.14.0.
@mui/x-charts-premium@8.14.0 Same changes as in @mui/x-charts-pro@8.14.0.
@mui/x-tree-view@8.14.0@mui/x-tree-view-pro@8.14.0 Same changes as in @mui/x-tree-view@8.14.0.
@mui/x-codemod@8.14.0Internal changes.
baseUrl (#19837) @Janpotlodash with es-toolkit (#19853) @bernardobelchiorlodash (#19864) @bernardobelchiortitle knob (#19792) @JCQuintasOct 1, 2025
@mui/x-charts-pro failure on import due to missing @mui/x-internals release@mui/x-data-grid@8.13.1Internal changes.
@mui/x-data-grid-pro@8.13.1 Same changes as in @mui/x-data-grid@8.13.1.
@mui/x-data-grid-premium@8.13.1 Same changes as in @mui/x-data-grid-pro@8.13.1.
@mui/x-date-pickers@8.12.0Internal changes.
@mui/x-date-pickers-pro@8.12.0 Same changes as in @mui/x-date-pickers@8.12.0.
@mui/x-charts@8.13.1Internal changes.
@mui/x-charts-pro@8.13.1 Same changes as in @mui/x-charts@8.13.1, plus:
@mui/x-charts-pro failure on import due to missing @mui/x-internals release @bernardobelchior@mui/x-charts-premium@8.13.1 Same changes as in @mui/x-charts-pro@8.13.1.
@mui/x-tree-view@8.13.1Internal changes.
@mui/x-tree-view-pro@8.13.1 Same changes as in @mui/x-tree-view@8.13.1.
@mui/x-codemod@8.12.0Internal changes.
Oct 1, 2025
We'd like to extend a big thank you to the 14 contributors who made this release possible. Here are some highlights ✨:
tapAndDrag gesture. Zoom in/out by tapping twice and dragging vertically.<BarChartPro
zoomInteractionConfig={{
// Only zoom when Control key is pressed
zoom: [{ type: 'wheel', keys: ['Control'] }],
// Only pan when Shift key is pressed
pan: [{ type: 'drag', keys: ['Shift'] }],
}}
/>Special thanks go out to the community members for their valuable contributions: @sai6855
The following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @flaviendelangle, @hasdfa, @Janpot, @JCQuintas, @KenanYusuf, @mapache-salvaje, @MBilalShafi, @mnajdova, @rita-codes, @siriwatknp
@mui/x-data-grid@8.13.0slotProps not being applied (#19769) @sai6855fetchRows() when strategy is not initialized (#19728) @MBilalShafi@mui/x-data-grid-pro@8.13.0 Same changes as in @mui/x-data-grid@8.13.0, plus:
@mui/x-data-grid-premium@8.13.0 Same changes as in @mui/x-data-grid-pro@8.13.0, plus:
metadata.referenceId to AI assistant prompt resolver (#19695) @hasdfa@mui/x-date-pickers@8.12.0Internal changes.
@mui/x-date-pickers-pro@8.12.0 Same changes as in @mui/x-date-pickers@8.12.0.
@mui/x-charts@8.13.0tapAndDrag zoom gesture (#19727) @JCQuintas@mui/x-charts-pro@8.13.0 Same changes as in @mui/x-charts@8.13.0, plus:
@mui/x-charts-premium@8.13.0 Same changes as in @mui/x-charts-pro@8.13.0.
@mui/x-tree-view@8.13.0apiRef type of each Tree View component (#19543) @flaviendelangle@mui/x-tree-view-pro@8.13.0 Same changes as in @mui/x-tree-view@8.13.0.
@mui/x-codemod@8.12.0Internal changes.
FocusedMark API page (#19773) @bernardobelchiorreleaseInfo (#19674) @Janpotpnpm-lock.yaml broken lockfile (#19755) @bernardobelchiorSep 25, 2025
Release highlight ✨:
@mui/x-data-grid@8.12.1Internal changes.
@mui/x-data-grid-pro@8.12.1 Same changes as in @mui/x-data-grid@8.12.1.
@mui/x-data-grid-premium@8.12.1 Same changes as in @mui/x-data-grid-pro@8.12.1, plus:
Sep 25, 2025
We'd like to extend a big thank you to the 15 contributors who made this release possible. Here are some highlights ✨:
renderer="svg-batch" prop to Scatter charts that provides improved performance for large datasets@mui/x-codemod minimum supported Node version is 20.19.
This was only the case due to using the v18 yargs package; this now explicitly aligns with it. (#18979)
Special thanks go out to the community members for their valuable contributions: @deade1e, @sai6855, @thomas-mcdonald
The following are all team members who have contributed to this release: @alexfauquette, @bernardobelchior, @flaviendelangle, @Janpot, @JCQuintas, @LukasTy, @michelengelen, @prakhargupta1, @rita-codes, @siriwatknp, @arminmeh, @romgrk
@mui/x-data-grid@8.12.0@mui/x-data-grid-pro@8.12.0 Same changes as in @mui/x-data-grid@8.12.0.
@mui/x-data-grid-premium@8.12.0 Same changes as in @mui/x-data-grid-pro@8.12.0, plus:
@mui/x-date-pickers@8.12.0slotProps.textField.slotProps.htmlInput resolution (#19713) @LukasTy@mui/x-date-pickers-pro@8.12.0 Same changes as in @mui/x-date-pickers@8.12.0.
@mui/x-charts@8.12.0getAxisExtremum (#19627) @bernardobelchiorgetAxisScale (#19673) @bernardobelchior@mui/x-charts-pro@8.12.0 Same changes as in @mui/x-charts@8.12.0, plus:
valueFormatter to sankey (#19636) @JCQuintassource/target keywords in sankey link color (#19634) @JCQuintasSankeyChart (#19659) @JCQuintasmax and filterMode: 'discard' (#19200) @bernardobelchior@mui/x-charts-premium@8.12.0 Same changes as in @mui/x-charts-pro@8.12.0, plus:
@mui/x-tree-view@8.12.0null to the icon slots (#19569) @flaviendelangleapiRef.current.isItemExpanded() method (#19619) @flaviendelangle@mui/x-tree-view-pro@8.12.0 Same changes as in @mui/x-tree-view@8.12.0.
@mui/x-codemod@8.12.0engines.node to >=20.19 to align with yargs package (#18979) @LukasTyExportServerSideData demo layout shift (#19669) @siriwatknpupdateRow() description (#19554) @deade1etsx files in visual regression (#19595) @JCQuintasDEFAULT_TIMESTAMP format to ISO 8601 (#19624) @JanpotfindLatestTaggedVersion to filter tags based on major version (#19693) @michelengelencreateReleasePR.mjs (#19702) @bernardobelchiorx-charts-premium releasable (#18959) @JCQuintascreate-playground script only runs if target file is absent (#19603) @michelengelenmatchPackageNames to matchDepNames for date-fns-v2 @JanpotSep 16, 2025
We'd like to extend a big thank you to the 11 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community members for their valuable contributions: @sai6855
The following are all team members who have contributed to this release: @alexfauquette, @bernardobelchior, @brijeshb42, @cherniavskii, @flaviendelangle, @Janpot, @JCQuintas, @LukasTy, @rita-codes, @siriwatknp
@mui/x-data-grid@8.11.3operator types to display literal values (#19529) @siriwatknp@mui/x-data-grid-pro@8.11.3 Same changes as in @mui/x-data-grid@8.11.3.
@mui/x-data-grid-premium@8.11.3 Same changes as in @mui/x-data-grid-pro@8.11.3.
@mui/x-date-pickers@8.11.3slots and slotProps propagation strategy (#18867) @LukasTy@mui/x-date-pickers-pro@8.11.3 Same changes as in @mui/x-date-pickers@8.11.3.
@mui/x-charts@8.11.3inline- piecewise legend options (#19382) @JCQuintasisBandScale to isDiscreteScale (#19514) @bernardobelchior@mui/x-charts-pro@8.11.3 Same changes as in @mui/x-charts@8.11.3, plus:
@mui/x-tree-view@8.11.3removeItem event (#19500) @flaviendelangle@mui/x-tree-view-pro@8.11.3 Same changes as in @mui/x-tree-view@8.11.3.
@mui/x-codemod@8.11.3Internal changes.
shiny bar chart example at the top (#19416) @JCQuintasSep 10, 2025
We'd like to extend a big thank you to the 13 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community members for their valuable contributions: @ludvigeriksson, @sai6855
The following are all team members who have contributed to this release: @alexfauquette, @bernardobelchior, @brijeshb42, @flaviendelangle, @Janpot, @LukasTy, @MBilalShafi, @noraleonte, @rita-codes, @romgrk, @siriwatknp
@mui/x-data-grid@8.11.2stringify() for theme objects (#19427) @romgrk@mui/x-data-grid-pro@8.11.2 Same changes as in @mui/x-data-grid@8.11.2.
@mui/x-data-grid-premium@8.11.2 Same changes as in @mui/x-data-grid-pro@8.11.2, plus:
0 as total aggregation value when aggregation position is set to null for row groups (#19515) @cherniavskii@mui/x-date-pickers@8.11.2textField.slotProps (#18980) @LukasTycalendarState.currentMonth in Month Calendar when available (#19073) @LukasTyid and aria-labelledby attributes from spinbuttons (#19523) @LukasTy@mui/x-date-pickers-pro@8.11.2 Same changes as in @mui/x-date-pickers@8.11.2.
@mui/x-charts@8.11.2ChartsXAxis and ChartsYAxis (#19198) @bernardobelchiorgetRange and createDateFormatter (#19517) @bernardobelchiorfilterMode: 'discard' (#19199) @bernardobelchior@mui/x-charts-pro@8.11.2 Same changes as in @mui/x-charts@8.11.2.
@mui/x-tree-view@8.11.2props.items in the getItemTree() method (#19483) @flaviendelangle@mui/x-tree-view-pro@8.11.2 Same changes as in @mui/x-tree-view@8.11.2.
@mui/x-codemod@8.11.2Internal changes.
Sep 4, 2025
We'd like to extend a big thank you to the 6 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community members for their valuable contributions: @sai6855
The following are all team members who have contributed to this release: @brijeshb42, @flaviendelangle, @JCQuintas, @mapache-salvaje, @oliviertassinari
@mui/x-data-grid@8.11.1GridCell component (#19384) @sai6855@mui/x-data-grid-pro@8.11.1 Same changes as in @mui/x-data-grid@8.11.1.
@mui/x-data-grid-premium@8.11.1 Same changes as in @mui/x-data-grid-pro@8.11.1.
@mui/x-date-pickers@8.11.1slotProps for input adornment in PickerFieldUI component (#19399) @sai6855@mui/x-date-pickers-pro@8.11.1 Same changes as in @mui/x-date-pickers@8.11.1.
@mui/x-charts@8.11.1axisId when composing (#19397) @JCQuintas@mui/x-charts-pro@8.11.1 Same changes as in @mui/x-charts@8.11.1.
@mui/x-tree-view@8.11.1@mui/x-tree-view-pro@8.11.1 Same changes as in @mui/x-tree-view@8.11.1.
@mui/x-codemod@8.11.1Internal changes.
Aug 29, 2025
We'd like to extend a big thank you to the 19 contributors who made this release possible. Here are some highlights ✨:
📊 Add new SankeyChart
🚀 Data Grid row grouping now supports row reordering
See the Drag-and-drop group reordering section for more details.
📚 Documentation improvements
Special thanks go out to the community members for their valuable contributions: @dwrth, @lauri865, @Webini
The following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @brijeshb42, @cherniavskii, @flaviendelangle, @Janpot, @JCQuintas, @mapache-salvaje, @MBilalShafi, @michelengelen, @noraleonte, @oliviertassinari, @rita-codes, @romgrk, @sai6855, @siriwatknp
@mui/x-data-grid@8.11.0columnUnsortedIcon slot back (#19268) @arminmehmenu role to the empty actions menu (#19338) @arminmehcolumnsManagementRow style override slot not working (#19097) @dwrth@mui/x-data-grid-pro@8.11.0 Same changes as in @mui/x-data-grid@8.11.0, plus:
multipleColumnsSortingMode="always" (#19099) @MBilalShafikeepColumnPositionIfDraggedOutside is enabled (#19372) @arminmeh@mui/x-data-grid-premium@8.11.0 Same changes as in @mui/x-data-grid-pro@8.11.0, plus:
valueFormatter issues when rowGroupingColumnMode="single" (#18967) @cherniavskii@mui/x-date-pickers@8.11.0startContainer is a restricted object (#18772) @Webini@mui/x-date-pickers-pro@8.11.0 Same changes as in @mui/x-date-pickers@8.11.0.
@mui/x-charts@8.11.0RadarAxis component to render labels (#19240) @alexfauquettefill and stroke properties (#19316) @sai6855hideLegend prop description in docs (#19371) @sai6855@mui/x-charts-pro@8.11.0 Same changes as in @mui/x-charts@8.11.0, plus:
SankeyChart (#18895) @JCQuintas@mui/x-tree-view@8.11.0slotProps (#19247) @flaviendelangle@mui/x-tree-view-pro@8.11.0 Same changes as in @mui/x-tree-view@8.11.0.
@mui/x-codemod@8.11.0Internal changes.
synchronize to workflow triggers (#19342) @michelengelenAug 20, 2025
We'd like to extend a big thank you to the 10 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community members for their valuable contributions: @lauri-heinonen-2025-04, @Methuselah96, @sai6855, @wilcoschoneveld
The following are all team members who have contributed to this release: @alexfauquette, @cherniavskii, @flaviendelangle, @Janpot, @oliviertassinari, @rita-codes
@mui/x-data-grid@8.10.2<GridEditSingleSelect /> when density='compact' (#19249) @sai6855disableColumnSorting (#19222) @wilcoschoneveld@mui/x-data-grid-pro@8.10.2 Same changes as in @mui/x-data-grid@8.10.2, plus:
@mui/x-data-grid-premium@8.10.2 Same changes as in @mui/x-data-grid-pro@8.10.2.
@mui/x-date-pickers@8.10.2Internal changes.
@mui/x-date-pickers-pro@8.10.2 Same changes as in @mui/x-date-pickers@8.10.2.
@mui/x-charts@8.10.2Internal changes.
@mui/x-charts-pro@8.10.2 Same changes as in @mui/x-charts@8.10.2.
@mui/x-tree-view@8.10.2aria-hidden to the Tree Item Checkbox (#19246) @flaviendelangle@mui/x-tree-view-pro@8.10.2 Same changes as in @mui/x-tree-view@8.10.2.
@mui/x-codemod@8.10.2Internal changes.
renovate.json @oliviertassinariexeca update (#19229) @JanpotAug 15, 2025
We'd like to extend a big thank you to the 11 contributors who made this release possible. Here are some highlights ✨:
band and point scales.The following are all team members who have contributed to this release: @alexfauquette, @bernardobelchior, @Janpot, @JCQuintas, @mnajdova, @oliviertassinari, @prakhargupta1, @romgrk, @brijeshb42, @noraleonte, @rita-codes
@mui/x-data-grid@8.10.1@mui/x-data-grid-pro@8.10.1 Same changes as in @mui/x-data-grid@8.10.1.
@mui/x-data-grid-premium@8.10.1 Same changes as in @mui/x-data-grid-pro@8.10.1.
@mui/x-date-pickers@8.10.0Internal changes.
@mui/x-date-pickers-pro@8.10.0 Same changes as in @mui/x-date-pickers@8.10.0.
Axes can now be grouped by category when using band and point scales
@mui/x-charts@8.10.1@mui/x-charts-pro@8.10.1 Same changes as in @mui/x-charts@8.10.1.
@mui/x-tree-view@8.10.1@mui/x-tree-view-pro@8.10.1 Same changes as in @mui/x-tree-view@8.10.1.
@mui/x-codemod@8.10.1Internal changes.
:catalog for @babel/runtime (#19028) @oliviertassinarifs-extra removal from formattedTSDemos script (#19132) @bernardobelchiorfs-extra with node:fs where possible (#19127) @bernardobelchiorlockFileMaintenance simple @oliviertassinarilockFileMaintenance is enabled @oliviertassinariAug 8, 2025
We'd like to extend a big thank you to the 17 contributors who made this release possible. Here are some highlights ✨:
FunnelChart marked as stableSpecial thanks go out to the community members for their valuable contributions: @AnderzL7, @aqeelat, @dwrth, @noobyogi0010, @nusr, @sai6855
The following are all team members who have contributed to this release: @arminmeh, @bernardobelchior, @cherniavskii, @flaviendelangle, @Janpot, @JCQuintas, @mapache-salvaje, @MBilalShafi, @oliviertassinari, @rita-codes, @romgrk
@mui/x-data-grid@8.10.0BaseSelect to allow variant change (#19026) @dwrthuse-sync-external-store shim (#19063) @romgrkdataSource.fetchRows() API method (#18904) @MBilalShafipreProcessEditCellProps() if cell is not editable based on isCellEditable() (#18405) @nusrrenderCountry throwing an error when used in tree data (#19068) @cherniavskiislotProps being ignored by the grid (#19095) @romgrk@mui/x-data-grid-pro@8.10.0 Same changes as in @mui/x-data-grid@8.10.0, plus:
@mui/x-data-grid-premium@8.10.0 Same changes as in @mui/x-data-grid-pro@8.10.0, plus:
valueFormatter (#18982) @arminmehsingleSelect columns not working in pivot model (#18971) @cherniavskii@mui/x-date-pickers@8.10.0MuiPickersLayout-toolbar is overlapping the Calendar in RTL MobileDatePicker variant (#18981) @rita-codes@mui/x-date-pickers-pro@8.10.0 Same changes as in @mui/x-date-pickers@8.10.0.
@mui/x-charts@8.10.0groups to band and point axis config (#18766) @JCQuintasmotion library (#18993) @JCQuintasUnstable_ radar exports (#19079) @JCQuintasvalueFormatter in heatmap (#19047) @sai6855@mui/x-charts-pro@8.10.0 Same changes as in @mui/x-charts@8.10.0, plus:
slotProps.tooltip.trigger not respected in ScatterChartPro and FunnelChart (#18902) @bernardobelchiorFunnelChart as stable (#19048) @JCQuintascreateAxisFilterMapper (#18998) @bernardobelchior@mui/x-tree-view@8.10.0Internal changes.
@mui/x-tree-view-pro@8.10.0 Same changes as in @mui/x-tree-view@8.10.0.
@mui/x-codemod@8.10.0Internal changes.
RichTreeViewPro demo for dragging via custom drag-handle is not working properly (#19008) @rita-codesPORT env on docs:dev script (#19014) @JCQuintasmodule field (#18961) @Janpot@mui/system (#19062) @aqeelatJul 31, 2025
We'd like to extend a big thank you to the 23 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community members for their valuable contributions: @AmrElnaggar99, @atlanteh, @ddolcimascolo, @Jiseoup, @leonaha5, @noherczeg, @sai6855
The following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @bharatkashyap, @brijeshb42, @cherniavskii, @flaviendelangle, @Janpot, @JCQuintas, @KenanYusuf, @LukasTy, @mapache-salvaje, @MBilalShafi, @rita-codes, @romgrk, @siriwatknp
@mui/x-data-grid@8.9.2<GridEditSingleSelect /> (#18184) @sai6855@mui/x-data-grid-pro@8.9.2 Same changes as in @mui/x-data-grid@8.9.2, plus:
@mui/x-data-grid-premium@8.9.2 Same changes as in @mui/x-data-grid-pro@8.9.2, plus:
privateMode to AI assistant prompt resolver (#18759) @bharatkashyapvalueFormatter() (#18916) @cherniavskiiapi param for the aggregation function optional (#18984) @arminmeh@mui/x-date-pickers@8.9.2@mui/x-date-pickers-pro@8.9.2 Same changes as in @mui/x-date-pickers@8.9.2.
@mui/x-charts@8.9.2valueFormatter() (#18877) @sai6855ChartsWrapper from './ChartsWrapper' rather than './internals' (#18966) @JCQuintas@mui/x-charts-pro@8.9.2 Same changes as in @mui/x-charts@8.9.2, plus:
@mui/x-codemod@8.9.2Internal changes.
variant to pickerVariant (#18919) @AmrElnaggar99Jul 21, 2025
We'd like to extend a big thank you to the 2 contributors who made this release possible. Here are some highlights ✨:
🐞 Fix package publish issue
The following are all team members who have contributed to this release: @KenanYusuf, @MBilalShafi
@mui/x-data-grid@8.9.1gridVisibleColumnDefinitionsSelector (#18724) @KenanYusuf@mui/x-data-grid-pro@8.9.1 Same changes as in @mui/x-data-grid@8.9.1.
@mui/x-data-grid-premium@8.9.1 Same changes as in @mui/x-data-grid-pro@8.9.1.
Jul 17, 2025
We'd like to extend a big thank you to the 10 contributors who made this release possible. Here are some highlights ✨:
✨ Improve the drag and drop interaction for Data Grid row reordering feature. It uses a drop indicator to point to the position the row would be moving to.
https://github.com/user-attachments/assets/37284c4f-e8d4-4fc6-a6af-a780592905ef
🚀 Improve Data Grid Pivoting and Aggregation performance
📊 Add minBarSize to set a minimum height for bars
Special thanks go out to the community members for their valuable contributions: @lauri865
The following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @flaviendelangle, @JCQuintas, @LukasTy, @mapache-salvaje, @noraleonte, @MBilalShafi
@mui/x-data-grid@8.9.0Internal changes.
@mui/x-data-grid-pro@8.9.0 Same changes as in @mui/x-data-grid@8.9.0, plus:
@mui/x-data-grid-premium@8.9.0 Same changes as in @mui/x-data-grid-pro@8.9.0, plus:
@mui/x-date-pickers@8.9.0AdapterDayjs (#18429) @flaviendelangletimeSteps JSDoc (#18807) @LukasTy@mui/x-date-pickers-pro@8.9.0 Same changes as in @mui/x-date-pickers@8.9.0.
@mui/x-charts@8.9.0minBarSize to prevent bars from having 0 height (#18798) @JCQuintasminBarSize now ignores 0 and null values (#18816) @JCQuintas@mui/x-charts-pro@8.9.0 Same changes as in @mui/x-charts@8.9.0 plus:
[charts-pro] Fix issue where charts gestures weren't properly working when inside the shadow-dom (#18837) @JCQuintas
@mui/x-tree-view@8.9.0Internal changes.
@mui/x-tree-view-pro@8.9.0 Same changes as in @mui/x-tree-view@8.9.0.
@mui/x-codemod@8.9.0Internal changes.
import restriction rule for test files (#18669) @LukasTy@testing-library/jest-dom (#18800) @bernardobelchioreslint-plugin-mui-x (#18797) @bernardobelchiorJul 11, 2025
We'd like to extend a big thank you to the 13 contributors who made this release possible. Here are some highlights ✨:
📊 Chart zoom preview can be enabled
🌎 Add Indonesian (id-ID) locale on the Data Grid
Special thanks go out to the community members for their valuable contributions: @kennarddh
The following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi, @noraleonte, @prakhargupta1, @rita-codes, @siriwatknp
@mui/x-data-grid@8.8.0useGridSelector missing subscription in React.StrictMode (#18676) @cherniavskiiz-index (#18688) @KenanYusuf@mui/x-data-grid-pro@8.8.0 Same changes as in @mui/x-data-grid@8.8.0, plus:
@mui/x-data-grid-premium@8.8.0 Same changes as in @mui/x-data-grid-pro@8.8.0.
@mui/x-date-pickers@8.8.0Internal changes.
@mui/x-date-pickers-pro@8.8.0 Same changes as in @mui/x-date-pickers@8.8.0.
@mui/x-charts@8.8.0@mui/x-charts-pro@8.8.0 Same changes as in @mui/x-charts@8.8.0, plus:
funnelDirection to control pyramid direction (#18568) @JCQuintasonBeforeExport callback (#18722) @bernardobelchior@mui/x-tree-view@8.8.0checkboxSelection are enabled (#18749) @rita-codes@mui/x-tree-view-pro@8.8.0 Same changes as in @mui/x-tree-view@8.8.0.
@mui/x-codemod@8.8.0Internal changes.
size column filtering in files tree demo (#17952) @cherniavskiillms.txt for X and their products (#18595) @siriwatknp@mui/* packages are picked by Material UI renovate group (#18711) @LukasTyprettier config resolving (#18720) @LukasTyJul 4, 2025
We'd like to extend a big thank you to the 15 contributors who made this release possible. Here are some highlights ✨:
useChartProApiRef for easier access to the APIreferenceDate props on range componentsSpecial thanks go out to the community members for their valuable contributions: @ShahrazH, @vadimkuragkovskiy, @whythecode
The following are all team members who have contributed to this release: @alexfauquette, @brijeshb42, @mapache-salvaje, @arminmeh, @bernardobelchior, @bharatkashyap, @Janpot, @JCQuintas, @KenanYusuf, @LukasTy, @michelengelen, @rita-codes
@mui/x-data-grid@8.7.0@mui/x-data-grid-pro@8.7.0 Same changes as in @mui/x-data-grid@8.7.0.
@mui/x-data-grid-premium@8.7.0 Same changes as in @mui/x-data-grid-pro@8.7.0.
@mui/x-date-pickers@8.7.0start and end referenceDate props on range components (#18549) @LukasTy@mui/x-date-pickers-pro@8.7.0 Same changes as in @mui/x-date-pickers@8.7.0.
@mui/x-charts@8.7.0ChartsReferenceLineProps (#18598) @bernardobelchior@mui/x-charts-pro@8.7.0 Same changes as in @mui/x-charts@8.7.0, plus:
useChartProApiRef for easier refs (#18013) @JCQuintasuseChartApiContext to useChartProApiContext (#18565) @JCQuintas@mui/x-tree-view@8.7.0Internal changes.
@mui/x-tree-view-pro@8.7.0 Same changes as in @mui/x-tree-view@8.7.0, plus:
dataSource JSDoc (#18650) @LukasTydocument object (#18657) @vadimkuragkovskiymaterial-ui/disallow-react-api-in-server-components ESLint rule is applied (#18570) @LukasTyJun 27, 2025
We'd like to extend a big thank you to the 12 contributors who made this release possible. Here are some highlights ✨:
📅 Add usePickerAdapter hook to access the date adapter.
You can use the adapter in your custom components if you need them to work with multiple date libraries — Learn more.
🌎 Improve Danish (da-DK) locale
Special thanks go out to the community members for their valuable contributions: @omalyutin, @ShahrazH, @vadimka123
The following are all team members who have contributed to this release: @arminmeh, @bernardobelchior, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi, @michelengelen, @noraleonte, @rita-codes, @sai6855
@mui/x-data-grid@8.6.0label type in GridActionsCellItem type (#18175) @sai6855@mui/x-data-grid-pro@8.6.0 Same changes as in @mui/x-data-grid@8.6.0, plus:
@mui/x-data-grid-premium@8.6.0 Same changes as in @mui/x-data-grid-pro@8.6.0.
@mui/x-date-pickers@8.6.0usePickerAdapter hook (#18457) @LukasTyvalue when updating lastCommittedValue in internal state (#18518) @LukasTyusePickerAdapter hook internally instead of useUtils (#18465) @LukasTy@mui/x-date-pickers-pro@8.6.0 Same changes as in @mui/x-date-pickers@8.6.0.
@mui/x-charts@8.6.0data-series to charts legend item (#18414) @bernardobelchiordata-series to bar charts (#18413) @bernardobelchiordata-series to elements of line chart (#18409) @bernardobelchiordata-series to pie charts (#18432) @bernardobelchiorisElementInside helper (#18530) @JCQuintas@mui/x-charts-pro@8.6.0 Same changes as in @mui/x-charts@8.6.0, plus:
@mui/x-tree-view@8.6.0Internal changes.
@mui/x-tree-view-pro@8.6.0 Same changes as in @mui/x-tree-view@8.6.0, plus:
@mui/x-codemod@8.6.0Internal changes.
GridRenderContext (#18492) @arminmehnextOrAccept action (#18505) @LukasTyString.raw for creating the remote regex (#18462) @michelengelenJun 19, 2025
We'd like to extend a big thank you to the 10 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community members for their valuable contributions: @alisasanib, @arminmeh, @sai6855
The following are all team members who have contributed to this release: @alexfauquette, @bernardobelchior, @flaviendelangle, @JCQuintas, @LukasTy, @MBilalShafi, @oliviertassinari
@mui/x-data-grid@8.5.3@mui/x-data-grid-pro@8.5.3 Same changes as in @mui/x-data-grid@8.5.3, plus:
rowCount response when new children are fetched with the data source (#17711) @arminmeh@mui/x-data-grid-premium@8.5.3 Same changes as in @mui/x-data-grid-pro@8.5.3.
@mui/x-date-pickers@8.5.3inputSizeSmall to classes interface (#18242) @sai6855@mui/x-date-pickers-pro@8.5.3 Same changes as in @mui/x-date-pickers@8.5.3.
@mui/x-charts@8.5.3tabIndex in surface and legend (#18344) @JCQuintas@mui/x-charts-pro@8.5.3 Same changes as in @mui/x-charts@8.5.3, plus:
FunnelChart label positioning with different curves (#18354) @JCQuintas@mui/x-tree-view@8.5.3Internal changes.
@mui/x-tree-view-pro@8.5.3 Same changes as in @mui/x-tree-view@8.5.3.
@mui/x-codemod@8.5.3Internal changes.
Playwright renovate group (#18397) @LukasTyCODEOWNERS for charts repositories (#18418) @JCQuintasURL usage for test config (#18444) @LukasTyvitest bundled types (#17758) @JCQuintasJun 12, 2025
We'd like to extend a big thank you to the 15 contributors who made this release possible. Here are some highlights ✨:
useSyncExternalStore import error in React 17Special thanks go out to the community members for their valuable contributions: @alisasanib, @noobyogi0010.
The following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @JCQuintas, @KenanYusuf, @LukasTy, @mapache-salvaje, @michelengelen, @noraleonte, @oliviertassinari, @prakhargupta1, @romgrk.
@mui/x-data-grid@8.5.2@mui/x-data-grid-pro@8.5.2 Same changes as in @mui/x-data-grid@8.5.2, plus:
@mui/x-data-grid-premium@8.5.2 Same changes as in @mui/x-data-grid-pro@8.5.2.
@mui/x-date-pickers@8.5.2PickerDay2 and DateRangePickerDay2 components (#15921) @noraleontehiddenLabel prop propagation (#18195) @noobyogi0010@mui/x-date-pickers-pro@8.5.2 Same changes as in @mui/x-date-pickers@8.5.2.
@mui/x-charts@8.5.2sx prop merging from useComponentRenderer (#18235) @bernardobelchioruseSyncExternalStore import error in React 17 (#18314) @bernardobelchior@mui/x-charts-pro@8.5.2 Same changes as in @mui/x-charts@8.5.2, plus:
gap prop does not impact the drawing area (#18233) @JCQuintasChartsToolbarPro types in pro charts (#18243) @bernardobelchior@mui/x-tree-view@8.5.2useSyncExternalStore import error in React 17 (#18314) @bernardobelchior@mui/x-tree-view-pro@8.5.2 Same changes as in @mui/x-tree-view@8.5.2.
React to 19.0.0 (#18265) @LukasTycatalog for reused dependencies (#18302) @LukasTyJun 5, 2025
We'd like to extend a big thank you to the 9 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community members for their valuable contributions: @moosekebab, @TiagoPortfolio. The following are all team members who have contributed to this release: @alexfauquette, @bernardobelchior, @JCQuintas, @KenanYusuf, @LukasTy, @michelengelen, @arminmeh.
@mui/x-data-grid@8.5.1registerPipeProcessor() for Node v20 (#18241) @arminmehuseComponentRenderer from x-internals (#18203) @bernardobelchior@mui/x-data-grid-pro@8.5.1 Same changes as in @mui/x-data-grid@8.5.1, plus:
@mui/x-data-grid-premium@8.5.1 Same changes as in @mui/x-data-grid-pro@8.5.1.
@mui/x-date-pickers@8.5.1transformOrigin resolving based on popper placement (#18206) @LukasTy@mui/x-date-pickers-pro@8.5.1 Same changes as in @mui/x-date-pickers@8.5.1.
@mui/x-charts@8.5.1extendVertically (#18211) @JCQuintas@mui/x-charts-pro@8.5.1 Same changes as in @mui/x-charts@8.5.1, plus:
linear-sharp curve as alternative to square edge (#17966) @JCQuintasFunnelSectionLabel (#18061) @JCQuintas@mui/x-tree-view@8.5.1Internal changes.
@mui/x-tree-view-pro@8.5.1 Same changes as in @mui/x-tree-view@8.5.1.
valueFormatter signature in migration guide (#18226) @michelengelenprocessRowUpdate (#18213) @JCQuintasistanbul references (#18194) @JCQuintasmocha with vitest on e2e and regression tests (#18071) @JCQuintasno-direct-state-access tests (#18209) @JCQuintasplaywright docker image (#18186) @LukasTyMay 29, 2025
We'd like to offer a big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
RadarChartPro, FunnelChart and Heatmap as image and PDF.RadarChart is now stable.Special thanks go out to the community members for their valuable contributions: @xBlizZer, @sai6855, @alisasanib. Following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @flaviendelangle, @Janpot, @JCQuintas, @KenanYusuf, @LukasTy, @oliviertassinari.
@mui/x-data-grid@8.5.0toggleColumn event type (#18023) @KenanYusufany type (#17979) @sai6855@mui/x-data-grid-pro@8.5.0 Same changes as in @mui/x-data-grid@8.5.0, plus:
@mui/x-data-grid-premium@8.5.0 Same changes as in @mui/x-data-grid-pro@8.5.0, plus:
GridApiPremium type (#18037) @arminmeh@mui/x-date-pickers@8.5.0Internal changes.
@mui/x-date-pickers-pro@8.5.0 Same changes as in @mui/x-date-pickers@8.5.0, plus:
@mui/x-charts@8.5.0render prop to charts toolbar components (#17649) @bernardobelchioruseFunnelSeries and useRadarSeries (#18034) @JCQuintasChartApi through context (#18004) @bernardobelchior@mui/x-charts-pro@8.5.0 Same changes as in @mui/x-charts@8.5.0, plus:
ChartAxisZoomSlider into smaller files (#18011) @bernardobelchior@mui/x-tree-view@8.5.0Internal changes.
@mui/x-tree-view-pro@8.5.0 Same changes as in @mui/x-tree-view@8.5.0.
babel-plugin-display-name in vitest (#17903) @JCQuintasponyfillGlobal usage (#18003) @LukasTybabel-plugin-display-name from npm (#18040) @LukasTyponyfillGlobal (#17986) @xBlizZerMay 21, 2025
We'd like to offer a big thanks to the 21 contributors who made this release possible. Here are some highlights ✨:
🔺 Support regular pyramid variation in the <FunnelChart /> component:
📚 Documentation improvements
Special thanks go out to the community members for their valuable contributions: @aizerin, @arminmeh, @campmarc, @jyash97, @mapache-salvaje, @noraleonte, @nusr, @ragnarr18, @romgrk, @whereisrmsqhs. Following are all team members who have contributed to this release: @alexfauquette, @bernardobelchior, @flaviendelangle, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi, @rita-codes.
@mui/x-data-grid@8.4.0exclude selection model type if quick filter does not have actual values (#17899) @arminmeh@mui/x-data-grid-pro@8.4.0 Same changes as in @mui/x-data-grid@8.4.0, plus:
aria-expanded attribute to the master detail toggle button (#17122) @whereisrmsqhs@mui/x-data-grid-premium@8.4.0 Same changes as in @mui/x-data-grid-pro@8.4.0.
@mui/x-date-pickers@8.4.0disabled value is used when focusing or clicking (#17914) @aizerinPickersTextField overflow (#17942) @noraleonte@mui/x-date-pickers-pro@8.4.0 Same changes as in @mui/x-date-pickers@8.4.0.
@mui/x-charts@8.4.0isPointInside less often (#17850) @bernardobelchioruseAnimate test (#17777) @JCQuintasisXInside and isYInside (#17911) @bernardobelchior@mui/x-charts-pro@8.4.0 Same changes as in @mui/x-charts@8.4.0, plus:
Pyramid chart (#17783) @JCQuintas@mui/x-tree-view@8.4.0getItemChildren prop in RichTreeView (#17894) @rita-codesapiRef to toggle the editing status of an item (#17768) @rita-codes@mui/x-tree-view-pro@8.4.0 Same changes as in @mui/x-tree-view@8.4.0.
apiRef copy (#17776) @mapache-salvajedisplayName (#17845) @romgrkvitest cli (#17847) @JCQuintasisolatedModules=true in tsconfig (#17781) @JCQuintasMay 14, 2025
We'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community members for their valuable contributions: @100pearlcent, @htollefsen, @JanPretzel, @sai6855. Following are all team members who have contributed to this release: @bernardobelchior, @cherniavskii, @flaviendelangle, @Janpot, @JCQuintas, @MBilalShafi, @oliviertassinari, @prakhargupta1.
@mui/x-data-grid@8.3.1reason param for onRowSelectionModelChange callback (#17545) @sai6855renderContext calculation loop (#17779) @cherniavskii@mui/x-data-grid-pro@8.3.1 Same changes as in @mui/x-data-grid@8.3.1.
@mui/x-data-grid-premium@8.3.1 Same changes as in @mui/x-data-grid-pro@8.3.1, plus:
@mui/x-date-pickers@8.3.1@mui/x-date-pickers-pro@8.3.1 Same changes as in @mui/x-date-pickers@8.3.1.
@mui/x-charts@8.3.1@mui/x-charts-pro@8.3.1 Same changes as in @mui/x-charts@8.3.1, plus:
@mui/x-tree-view@8.3.1Internal changes.
@mui/x-tree-view-pro@8.3.1 Same changes as in @mui/x-tree-view@8.3.1.
mocha with vitest for browser & jsdom tests (#14508) @JCQuintasMay 8, 2025
We'd like to offer a big thanks to the 11 contributors who made this release possible. Here are some highlights ✨:
<FunnelChart />, including variant, borderRadius, pyramid, and step-pyramid curves.Special thanks go out to this community member for a valuable contribution: @ptuukkan. Team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @flaviendelangle, @Janpot, @JCQuintas, @LukasTy, @MBilalShafi, @rita-codes, @romgrk.
@mui/x-data-grid@8.3.0isRowSelectable prop (#17629) @MBilalShafipreProcessEditCellProps for non-editable columns when starting a row update (#17732) @arminmeh@mui/x-data-grid-pro@8.3.0 Same changes as in @mui/x-data-grid@8.3.0.
@mui/x-data-grid-premium@8.3.0 Same changes as in @mui/x-data-grid-pro@8.3.0.
@mui/x-date-pickers@8.3.0DigitalClock stealing focus from a Picker open button on close (#17686) @LukasTy@mui/x-date-pickers-pro@8.3.0 Same changes as in @mui/x-date-pickers@8.3.0, plus:
The <FunnelChart /> series now accepts a variant='outlined' prop for a simpler style.
Add a borderRadius property to <FunnelChart />. All funnels have 8px as a default value.
Add a pyramid curve to <FunnelChart />, which allows creation of a pyramid-shaped funnel.
Add a step-pyramid curve to <FunnelChart />, which creates a stepped-pyramid like shape.
@mui/x-charts@8.3.0<PieArcLabel /> not taking arcLabelRadius into account (#17655) @bernardobelchior<MarkElement /> performance (#17546) @bernardobelchiormaterialSlots internal constant (#17710) @bernardobelchior@mui/x-charts-pro@8.3.0 Same changes as in @mui/x-charts@8.3.0, plus:
pyramid curve to <FunnelChart /> (#17665) @JCQuintasvariant='outlined' to <FunnelChart /> series (#17661) @JCQuintasborderRadius property to <FunnelChart /> (#17660) @JCQuintas@mui/x-tree-view@8.3.0@mui/x-tree-view-pro@8.3.0 Same changes as in @mui/x-tree-view@8.3.0.
node types in the built packages (#17533) @LukasTypkg.pr.new publishing (#17402) @JanpotMay 1, 2025
We'd like to offer a big thanks to the 14 contributors who made this release possible. Here are some highlights ✨:
<FunnelChart/> now uses the strawberrySky sequential color palette by default.
apiRef.exportAsImage — Learn more.Special thanks go out to the community members for their valuable contributions: @federico-ntr, @nusr. Following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @hasdfa, @Janpot, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi, @michelengelen, @oliviertassinari, @romgrk.
@mui/x-data-grid@8.2.0defaultProps causing unwanted re-renders (#17490) @KenanYusuf<GridEditInputCell /> break input (#16773) @nusr@mui/x-data-grid-pro@8.2.0 Same changes as in @mui/x-data-grid@8.2.0, plus:
@mui/x-data-grid-premium@8.2.0 Same changes as in @mui/x-data-grid-pro@8.2.0.
@mui/x-date-pickers@8.2.0@mui/x-date-pickers-pro@8.2.0 Same changes as in @mui/x-date-pickers@8.2.0.
@mui/x-charts@8.2.0<circle /> for circular legend mark (#17590) @alexfauquette@mui/x-charts-pro@8.2.0 Same changes as in @mui/x-charts@8.2.0, plus:
gap option to <FunnelChart /> (#17642) @JCQuintas<FunnelChart /> (#17606) @JCQuintas@mui/x-tree-view@8.2.0Internal changes.
@mui/x-tree-view-pro@8.2.0 Same changes as in @mui/x-tree-view@8.2.0.
groupingColDef reference needs to be stable (#17544) @arminmeh@next usages (#17542) @LukasTyloadStyleSheets to internals and use it in data grid and charts (#17548) @bernardobelchiorvitest changes (#17619) @JCQuintasclock=fake and add async act for datagrid (#17563) @JCQuintasbranch switch comments (#17589) @michelengelenApr 24, 2025
We'd like to offer a big thanks to the 14 contributors who made this release possible. Here are some highlights ✨:
apiRef.exportAsPrint().Special thanks go out to the community members for their valuable contributions: @lhilgert9, @ArturAghakaryan, @sai6855. Following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @JCQuintas, @joserodolfofreitas, @KenanYusuf, @LukasTy, @mapache-salvaje, @oliviertassinari, @romgrk.
@mui/x-data-grid@8.1.0material prop (#17513) @KenanYusuf@mui/x-data-grid-pro@8.1.0 Same changes as in @mui/x-data-grid@8.1.0, plus:
@mui/x-data-grid-premium@8.1.0 Same changes as in @mui/x-data-grid-pro@8.1.0.
@mui/x-date-pickers@8.1.0PickersInputBase owner state typing (#17478) @LukasTy@mui/x-date-pickers-pro@8.1.0 Same changes as in @mui/x-date-pickers@8.1.0.
apiRef.exportAsPrint().@mui/x-charts@8.1.0rafThrottle on event handlers instead of setter (#17489) @bernardobelchior@mui/x-charts-pro@8.1.0 Same changes as in @mui/x-charts@8.1.0, plus:
initialZoom (#17500) @bernardobelchior@mui/x-tree-view@8.1.0Internal changes.
@mui/x-tree-view-pro@8.1.0 Same changes as in @mui/x-tree-view@8.1.0.
@types/node (#17444) @LukasTyreact-is dependency (#17470) @LukasTyoverridesResolver in styled components (#17466) @romgrk@babel/node (#17446) @LukasTyclock=fake from pickers (#17253) @JCQuintasApr 17, 2025
We're excited to announce the first v8 stable release! 🎉🚀
This is now the officially supported major version, where we'll keep rolling out new features, bug fixes, and improvements. Migration guides are available with a complete list of the breaking changes:
Here are the highlights from alpha and beta releases included in this stable release:
🎁 @mui/material@7 support – see the Material UI v7 upgrade guide.
🔄 Pivoting.
🎨 Improved Data Grid theming and add default background color.
📊 New Pro chart: Funnel.
margin and axis-size).🚫 Removed react-spring dependency from @mui/x-charts.
🚀 New Time Range Picker component.
🔁 Support automatic parents and children selection for the Rich Tree View components.
Below are the changes since the last beta release:
@mui/x-data-grid@8.0.0@mui/x-data-grid-pro@8.0.0 Same changes as in @mui/x-data-grid@8.0.0, plus:
@mui/x-data-grid-premium@8.0.0 Same changes as in @mui/x-data-grid-pro@8.0.0, plus:
groupingValueGetter for row grouping on the server (#17376) @cherniavskii@mui/x-date-pickers@8.0.0<input /> but the field expects the accessible DOM structure (#17237) @flaviendelangleEnter press with accessible DOM structure (#17328) @LukasTydisabled=true (#17215) @flaviendelangle@mui/x-date-pickers-pro@8.0.0 Same changes as in @mui/x-date-pickers@8.0.0, plus:
@mui/x-charts@8.0.0slotProps.legend.hidden to migration docs (#17379) @bernardobelchiorAnimationContext into a plugin (#17299) @bernardobelchiorbarElementClasses (#17273) @10tacionuseAnimate hook (#17162) @bernardobelchioruseAnimate test flakiness (#17372) @bernardobelchioruseEventCallback to memoize onZoomChange without triggering a re-render (#17233) @JCQuintasChartDataProvider (#17403) @bernardobelchior@mui/x-charts-pro@8.0.0 Same changes as in @mui/x-charts@8.0.0, plus:
requestAnimationFrame (#17137) @JCQuintas@mui/x-tree-view@8.0.0@mui/x-tree-view-pro@8.0.0 Same changes as in @mui/x-tree-view@8.0.0.
ownerState changes (#17151) @flaviendelangleResponsiveChartContainer migration guide (#17364) @MonstraGTelemetryContextType (#17282) @oliviertassinari__RELEASE_INFO__ is managed (#17416) @LukasTyvitest changes (#17247) @JCQuintasvitest (#17251) @JCQuintasclock=fake from pickers tests (#17225) @JCQuintasApr 3, 2025
We'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
react-spring as a dependency of @mui/x-chartsTeam members who have contributed to this release: @bernardobelchior, @cherniavskii, @flaviendelangle, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi, @michelengelen, @oliviertassinari, @noraleonte, @romgrk, @alexfauquette.
The list view feature and its related props are now stable.
The unstable_listColumn prop has been renamed to listViewColumn.
The GridListColDef type has been renamed to GridListViewColDef.
-const listViewColDef: GridListColDef = {
+const listViewColDef: GridListViewColDef = {
field: 'listColumn',
renderCell: ListViewCell,
};
<DataGridPro
- unstable_listView
- unstable_listColumn={listViewColDef}
+ listView
+ listViewColumn={listViewColDef}
/>The useGridApiEventHandler() hook has been renamed to useGridEvent().
useGridApiOptionHandler() hook has been renamed to useGridEventPriority().@mui/x-data-grid@8.0.0-beta.3useGridApiEventHandler() to useGridEvent() (#17159) @romgrk@mui/x-data-grid-pro@8.0.0-beta.3 Same changes as in @mui/x-data-grid@8.0.0-beta.3, plus:
@mui/x-data-grid-premium@8.0.0-beta.3 Same changes as in @mui/x-data-grid-pro@8.0.0-beta.3.
@mui/x-date-pickers@8.0.0-beta.3nextOrAccept action bar action (#17037) @flaviendelangle@mui/x-date-pickers-pro@8.0.0-beta.3 Same changes as in @mui/x-date-pickers@8.0.0-beta.3.
Removed react-spring as a dependency of @mui/x-charts.
A consequence of this change is that the props of some slots have been changed because the SpringValue wrapper has been removed. The affected slots and props are:
x, y, width and height props of the bar slot are now number;startAngle, endAngle, innerRadius, outerRadius, arcLabelRadius, cornerRadius and paddingAngle props of pieArc and pieArcLabel slot are now number.Additionally, the pieArc slot now receives a skipAnimation prop to configure whether animations should be enabled or disabled.
Tick labels in the y-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 y-axis size by increasing its width property.
The tooltip DOM structure is modified to improve accessibility. If you relied on it to apply some style or run tests, you might be impacted by this modification.
@mui/x-charts@8.0.0-beta.3react-spring (#16961) @bernardobelchiorreact-spring (#17123) @bernardobelchior@mui/x-charts-pro@8.0.0-beta.3 Same changes as in @mui/x-charts@8.0.0-beta.3.
@mui/x-tree-view@8.0.0-beta.3Internal changes.
@mui/x-tree-view-pro@8.0.0-beta.3 Same changes as in @mui/x-tree-view@8.0.0-beta.3.
@mui/x-codemod@8.0.0-beta.3listView prop rename codemod (#17220) @MBilalShafi@mui dependency versions (#17160) @LukasTytest:unit warning (#17224) @JCQuintasdescribeValidation (#17150) @JCQuintasdescribeValue (#17199) @JCQuintasMar 27, 2025
We'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
Special thanks go out to the community members for their valuable contributions: @lhilgert9. Following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @flaviendelangle, @hasdfa, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi, @michelengelen, @mnajdova, @romgrk.
@mui/x-data-grid@8.0.0-beta.2@mui/styled-engine-sc (#17154) @KenanYusuf@mui/x-data-grid-pro@8.0.0-beta.2 Same changes as in @mui/x-data-grid@8.0.0-beta.2, plus:
@mui/x-data-grid-premium@8.0.0-beta.2 Same changes as in @mui/x-data-grid-pro@8.0.0-beta.2.
@mui/x-date-pickers@8.0.0-beta.2@mui/x-date-pickers-pro@8.0.0-beta.2 Same changes as in @mui/x-date-pickers@8.0.0-beta.2.
@mui/x-charts@8.0.0-beta.2@mui/x-charts-pro@8.0.0-beta.2 Same changes as in @mui/x-charts@8.0.0-beta.2.
@mui/x-tree-view@8.0.0-beta.2Internal changes.
@mui/x-tree-view-pro@8.0.0-beta.2 Same changes as in @mui/x-tree-view@8.0.0-beta.2.
@mui/x-codemod@8.0.0-beta.1ExportExcel component (#17110) @KenanYusuf@mui/styles dependency & patches (#17071) @mnajdovaisDeepEqual to @mui/x-internals (#17129) @JCQuintastest_regressions step from React 18 pipeline (#17108) @LukasTyissue-status-label-handler.yml @michelengelenMar 21, 2025
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 members for their valuable contributions: @jyash97. Following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @flaviendelangle, @JCQuintas, @KenanYusuf.
@mui/x-data-grid@8.0.0-beta.1forwardRef to ClickAwayListener (#17049) @arminmeh@mui/x-data-grid-pro@8.0.0-beta.1 Same changes as in @mui/x-data-grid@8.0.0-beta.1, plus:
checkboxSelectionVisibleOnly and paginationMode="server" (#17026) @arminmeh@mui/x-data-grid-premium@8.0.0-beta.1 Same changes as in @mui/x-data-grid-pro@8.0.0-beta.1, plus:
@mui/x-date-pickers@8.0.0-beta.1useField hook (part 1) (#16944) @flaviendelangledoesSectionFormatHaveLeadingZeros (#17051) @flaviendelangledisableOpenPicker prop (#17040) @flaviendelanglecleanLeadingZeros method (#17063) @flaviendelangleownerState in PickersDay and DateRangePickerDay (#17035) @flaviendelangle@mui/x-date-pickers-pro@8.0.0-beta.1 Same changes as in @mui/x-date-pickers@8.0.0-beta.1, plus:
@mui/x-charts@8.0.0-beta.1@mui/x-charts-pro@8.0.0-beta.1 Same changes as in @mui/x-charts@8.0.0-beta.1, plus:
@mui/x-tree-view@8.0.0-beta.1Internal changes.
@mui/x-tree-view-pro@8.0.0-beta.1 Same changes as in @mui/x-tree-view@8.0.0-beta.1.
Mar 18, 2025
We'd like to offer a big thanks to the 21 contributors who made this release possible. Here are some highlights ✨:
@mui/material version 7 in all X packages@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.
Below are the highlights of the alpha releases leading up to this beta release:
⚛️ React 19 support.
🛠️ New and improved Data Grid Toolbar component.
🎨 Improve Data Grid theming and add default background color.
📊 New Pro chart: Funnel.
📊 Add a new API to support multiple axes (decouple margin and axis-size)
🔁 Support automatic parents and children selection for the Rich Tree View components.
@mui/x-data-grid@8.0.0-beta.0toggleMenu click (#16845) @michelengelenQuickFilter debounce overriding input value (#16856) @KenanYusufprintOptions not respecting hideFooter root prop (#14863) @k-rajat19processRowUpdate() error if the row is removed before it is executed (#16741) @arminmeh@mui/x-data-grid-pro@8.0.0-beta.0 Same changes as in @mui/x-data-grid@8.0.0-beta.0, plus:
@mui/x-data-grid-premium@8.0.0-beta.0 Same changes as in @mui/x-data-grid-pro@8.0.0-beta.0, plus:
useClearableField hook has been removed.
The custom field component now receives the clearable and onClear props — Learn more.ExportedUseClearableFieldProps, UseClearableFieldSlots, UseClearableFieldSlotProps, and UseClearableFieldResponse types have been removed — Learn more.@mui/x-date-pickers@8.0.0-beta.0props.value as the source of truth when defined (#16853) @flaviendelanglefocusedView to time renderers (#16869) @LukasTyuseClearableField hook (#16859) @LukasTy@mui/x-date-pickers-pro@8.0.0-beta.0 Same changes as in @mui/x-date-pickers@8.0.0-beta.0, plus:
height 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/x-charts@8.0.0-beta.0forwardRef (#16894) @bernardobelchiorisInteracting behavior directly to community code (#16999) @JCQuintasfireEvent usage from tests (#17006) @JCQuintasuseIsClient (#16937) @bernardobelchior@mui/x-charts-pro@8.0.0-beta.0 Same changes as in @mui/x-charts@8.0.0-beta.0.
@mui/x-tree-view@8.0.0-beta.0Internal changes.
@mui/x-tree-view-pro@8.0.0-beta.0 Same changes as in @mui/x-tree-view@8.0.0-beta.0.
showQuickFilter: true toolbar prop from demos (#17003) @KenanYusuf@mui/utils dependency to only v7 (#16928) @Janpotcimg/node image version (#16964) @LukasTyTanstack query renovate group (#16989) @LukasTypull_request to pull_request_target (#16902) @michelengelenMar 7, 2025
We'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
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.
density prop. A density selector can be added to a custom toolbar passed to slots.toolbar. See Toolbar component—Settings menu for an example.slotProps={{ toolbar: { showQuickFilter: false } }} to hide it.<GridSaveAltIcon /> icon is not exported anymore. Import SaveAlt from @mui/icons-material instead.@mui/x-data-grid@8.0.0-alpha.14aria-hidden console error when scrollbar is dragged (#16829) @arminmeh<Toolbar /> component (#14611) @KenanYusuf@mui/x-data-grid-pro@8.0.0-alpha.14 Same changes as in @mui/x-data-grid@8.0.0-alpha.14.
@mui/x-data-grid-premium@8.0.0-alpha.14 Same changes as in @mui/x-data-grid-pro@8.0.0-alpha.14.
onChange when the date is partially filled — Learn more.@mui/x-date-pickers@8.0.0-alpha.14props.value as the source of truth when defined (#15875) @flaviendelanglehelperText (#16821) @LukasTyTValidationProps generic to the PickerManager interface (#16832) @flaviendelangleedge property setting in different button position cases (#16838) @LukasTyusePicker folder (#16680) @flaviendelangle@mui/x-date-pickers-pro@8.0.0-alpha.14 Same changes as in @mui/x-date-pickers@8.0.0-alpha.14.
@mui/x-charts@8.0.0-alpha.14undefined behaving differently from missing value for axis size (#16844) @bernardobelchiordefaultizeAxis function into two (#16745) @bernardobelchiortextAnchor and dominantBaseline based on angle (#16817) @bernardobelchior@mui/x-charts-pro@8.0.0-alpha.14 Same changes as in @mui/x-charts@8.0.0-alpha.14, plus:
The selectItem method has been renamed setItemSelection:
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/x-tree-view@8.0.0-alpha.14@mui/x-tree-view-pro@8.0.0-alpha.14 Same changes as in @mui/x-tree-view@8.0.0-alpha.14.
Feb 28, 2025
We'd like to offer a big thanks to the 19 contributors who made this release possible. Here are some highlights ✨:
margin and axis-size. A new API to support multiple axes (#16418) @JCQuintasSpecial 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.
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:
columnVisibilityModel is provided, it resets to that model.columnVisibilityModel is provided, it resets to the first model value.columns prop or updateColumns() API method), the reset reference point updates to the current columnVisibilityModel.To revert to the previous behavior, provide a custom component to the slots.columnsManagement.
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> }.
Using Set allows for a more efficient row selection management.
The exclude selection type allows to select all rows except the ones in the ids set.
This change impacts the following props:
rowSelectionModelonRowSelectionModelChangeinitialState.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 the gridRowSelectionManagerSelector 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 the gridRowSelectionManagerSelector or gridRowSelectionStateSelector selectors instead.
selectedGridRowsSelector has been renamed to gridRowSelectionIdsSelector.The selectedGridRowsCountSelector has been renamed to gridRowSelectionCountSelector.
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/x-data-grid@8.0.0-alpha.13showToolbar prop to enable default toolbar (#16687) @KenanYusufshowColumnVerticalBorder prop (#16715) @KenanYusufSelect menuprops onClose() (#16643) @romgrkGridSortItem internal (#16732) @arminmehsx prop usage with styled() components (#16665) @KenanYusufAutocomplete (#16390) @romgrkonDataSourceError() callback (#16718) @MBilalShafiGridSortModel (#16627) @pcorpet@mui/x-data-grid-pro@8.0.0-alpha.13 Same changes as in @mui/x-data-grid@8.0.0-alpha.13, plus:
LicenseInfo reexports (#16671) @cherniavskii@mui/x-data-grid-premium@8.0.0-alpha.13 Same changes as in @mui/x-data-grid-pro@8.0.0-alpha.13, plus:
valueGetter to get row group keys (#16016) @cherniavskii<DateRangePicker /> now uses a dialog instead of a tooltip to render their view when used with a single input range field.@mui/x-date-pickers@8.0.0-alpha.13@mui/x-date-pickers-pro@8.0.0-alpha.13 Same changes as in @mui/x-date-pickers@8.0.0-alpha.13.
Charts array inputs are now readonly. Allowing externally defined as 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 and leftAxis props by the position property in the axis config.
If you were using them to place axis, set the position property to the corresponding value 'top' | 'right' | 'bottom' | 'left'.
If you were disabling an axis by setting it to null, set its position 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 from ChartsXAxis and ChartsYAxis.
The position prop has been removed from the ChartsXAxis and ChartsYAxis 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/x-charts@8.0.0-alpha.13labelMarkType (#16739) @bernardobelchiorminTickLabelGap to x-axis (#16548) @bernardobelchiormargin and axis-size (#16418) @JCQuintastheme.shape error in the tooltip (#16748) @alexfauquettedefaultizeAxis function type-safe (#16642) @JCQuintasseries.data readonly (#16645) @JCQuintasChartsUsageDemo to TSX and removed NoSnap (#16686) @JCQuintasposition='none' axes from rendering (#16727) @JCQuintas@mui/x-charts-pro@8.0.0-alpha.13 Same changes as in @mui/x-charts@8.0.0-alpha.13, plus:
@mui/x-tree-view@8.0.0-alpha.13Internal changes.
@mui/x-tree-view-pro@8.0.0-alpha.13 Same changes as in @mui/x-tree-view@8.0.0-alpha.13.
@mui/x-codemod@8.0.0-alpha.13vitest (#16755) @JCQuintasvitest (#16757) @JCQuintasFeb 17, 2025
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: @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.
The main--hasSkeletonLoadingOverlay class has been renamed to main--hiddenContent and is now also applied when the "No columns" overlay is displayed.
The apiRef.current.forceUpdate() method was removed. Use selectors combined with useGridSelector() hook to react to changes in the state.
The selectors signature has been updated. They are only accepting apiRef as a first argument and instanceId is no longer the third argument.
-mySelector(state, arguments, instanceId)
+mySelector(apiRef, arguments)@mui/x-data-grid@8.0.0-alpha.12apiRef as first argument (#16198) @arminmehundefined value for pagination rowCount (#16488) @cherniavskiigetRowId() API method as a selector (#16487) @MBilalShafionClock prop of the base Select slot (#16557) @romgrkapiRef.current.forceUpdate() method (#16560) @MBilalShafi-1 for "All" rows per page (#16485) @nusr@mui/x-data-grid-pro@8.0.0-alpha.12 Same changes as in @mui/x-data-grid@8.0.0-alpha.12.
@mui/x-data-grid-premium@8.0.0-alpha.12 Same changes as in @mui/x-data-grid-pro@8.0.0-alpha.12, plus:
The aria-label on the <Clock /> component and Time Picker opening button has been fixed to rely on the set ampm 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 use fullTime12h and fullTime24h instead: <LocalizationProvider
dateFormats={{
- fullTime: 'LT',
+ fullTime12h: 'hh:mm A',
+ fullTime24h: 'hh:mm',
}}
>keyboardDateTime - please use keyboardDateTime12h and keyboardDateTime24h instead: <LocalizationProvider
dateFormats={{
- keyboardDateTime: 'DD.MM.YYYY | LT',
+ keyboardDateTime12h: 'DD.MM.YYYY | hh:mm A',
+ keyboardDateTime24h: 'DD.MM.YYYY | hh:mm',
}}
>@mui/x-date-pickers@8.0.0-alpha.12ampm flag value (#16572) @LukasTy@mui/x-date-pickers-pro@8.0.0-alpha.12 Same changes as in @mui/x-date-pickers@8.0.0-alpha.12, plus:
useSeries hook family has been stabilized and renamed accordingly — Learn more@mui/x-charts@8.0.0-alpha.12test:performance:browser script #16600 @bernardobelchioruseXxxSeries hooks (#16552) @JCQuintasuseXxxSeries into useXxxSeriesContext (#16546) @JCQuintasuseXxxSeries support array of ids and document them (#15545) @JCQuintasvalueFormatter (#16555) @alexfauquettecolors prop from SparkLineChart. (#16494) @bernardobelchioruseSeries, usePieSeries, etc.) (#16459) @bernardobelchior@mui/x-charts-pro@8.0.0-alpha.12 Same changes as in @mui/x-charts@8.0.0-alpha.12.
@mui/x-tree-view@8.0.0-alpha.12Internal changes.
@mui/x-tree-view-pro@8.0.0-alpha.12 Same changes as in @mui/x-tree-view@8.0.0-alpha.12.
next releases (#16423) @LukasTyFeb 7, 2025
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.
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) @lauri865Jan 30, 2025
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.
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.
Jan 24, 2025
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) @alexfauquetteJan 16, 2025
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
🔄 Data Grid Scroll restoration
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.
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) @LukasTyJan 9, 2025
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.
@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) @JCQuintasDec 26, 2024
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) @JCQuintasDec 19, 2024
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) @LukasTyDec 13, 2024
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: @k-rajat19, @nusr, @rares985, @zivl. Following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @flaviendelangle, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi.
The selectors signature has been updated due to the support of arguments in the selectors. Pass undefined as arguments if the selector doesn't use any arguments.
-mySelector(state, instanceId)
+mySelector(state, arguments, instanceId)The useGridSelector signature has been updated due to the introduction of arguments parameter in the selectors. Pass undefined as arguments if the selector doesn't use any arguments.
-const output = useGridSelector(apiRef, selector, equals)
+const output = useGridSelector(apiRef, selector, arguments, equals)The default variant for text fields and selects in the filter panel has been changed to outlined.
<DataGrid
- unstable_rowSpanning
+ rowSpanning
/>@mui/x-data-grid@8.0.0-alpha.4<GridActionsCell /> (#15867) @k-rajat19columnsManagement slot (#15817) @k-rajat19@mui/x-data-grid-pro@8.0.0-alpha.4 Same changes as in @mui/x-data-grid@8.0.0-alpha.4, plus:
@mui/x-data-grid-premium@8.0.0-alpha.4 Same changes as in @mui/x-data-grid-pro@8.0.0-alpha.4, plus:
valueOptions for singleSelect column type (#15739) @arminmeh@mui/x-date-pickers@8.0.0-alpha.4usePicker logic (#15763) @flaviendelangleownerState property from isRtl to layoutDirection (#15803) @flaviendelangleownerState in useClearableField (#15776) @flaviendelangleownerState in the toolbar components (#15777) @flaviendelangleownerState object for the clock components and the desktop / mobile wrappers (#15669) @flaviendelangle@mui/x-date-pickers-pro@8.0.0-alpha.4 Same changes as in @mui/x-date-pickers@8.0.0-alpha.4.
@mui/x-charts@8.0.0-alpha.4@mui/x-charts-pro@8.0.0-alpha.4 Same changes as in @mui/x-charts@8.0.0-alpha.4.
@mui/x-tree-view@8.0.0-alpha.4No changes, releasing to keep the versions in sync.
@mui/x-tree-view-pro@8.0.0-alpha.4 Releasing to benefit from license package fix (#15814).
updateRows method for list view demos (#15732) @KenanYusuf@type/react-test-renderer dep (#15766) @LukasTyconsole.log for the error message on CodeSandbox to avoid rendering error (#15814) @arminmehDec 5, 2024
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: @ihsanberkozcan, @k-rajat19, @perezShaked. Following are all team members who have contributed to this release: @arminmeh, @cherniavskii, @flaviendelangle, @JCQuintas, @MBilalShafi, @noraleonte.
isRowSelectable prop.rowPositionsDebounceMs prop was removed.gridRowsDataRowIdToIdLookupSelector selector was removed. Use the gridRowsLookupSelector selector in combination with the getRowId() API method instead.-const idToIdLookup = gridRowsDataRowIdToIdLookupSelector(apiRef);
-const rowId = idToIdLookup[id]
+const rowsLookup = gridRowsLookupSelector(apiRef);
+const rowId = apiRef.current.getRowId(rowsLookup[id])role attribute to treegrid if the Data Grid is used with row grouping feature.@mui/x-data-grid@8.0.0-alpha.3isRowSelectable (#15692) @MBilalShafigridRowsDataRowIdToIdLookupSelector selector (#15698) @arminmehrowPositionsDebounceMs prop (#15482) @k-rajat19@mui/x-data-grid-pro@8.0.0-alpha.3 Same changes as in @mui/x-data-grid@8.0.0-alpha.3, plus:
@mui/x-data-grid-premium@8.0.0-alpha.3 Same changes as in @mui/x-data-grid-pro@8.0.0-alpha.3, plus:
ariaV8 experimental flag (#15694) @arminmehonOpen() and onClose() methods of the usePickerContext() hook have been replaced with a single setOpen method — Learn more.@mui/x-date-pickers@8.0.0-alpha.3onOpen() and onClose() methods of usePickerContext() with a single setOpen() method. (#15701) @flaviendelangle@mui/x-date-pickers-pro@8.0.0-alpha.3 Same changes as in @mui/x-date-pickers@8.0.0-alpha.3.
@mui/x-charts@8.0.0-alpha.3pattern and gradient support (#15720) @JCQuintas@mui/x-charts-pro@8.0.0-alpha.3 Same changes as in @mui/x-charts@8.0.0-alpha.3.
@mui/x-tree-view@8.0.0-alpha.3No changes since @mui/x-tree-view-pro@v8.0.0-alpha.2.
@mui/x-tree-view-pro@8.0.0-alpha.3 Same changes as in @mui/x-tree-view@8.0.0-alpha.3.
@mui/x-tree-view-pro to releaseChangelog (#15316) @flaviendelanglepreset-safe folder exists in codemod test (#15703) @JCQuintaspreset-safe into global codemod config (#15659) @JCQuintasNov 29, 2024
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.
<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) @LukasTyNov 22, 2024
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.
@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.
width and height props from the ChartsSurface component.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) @KenanYusufNov 14, 2024
We'd like to offer a big thanks to the 22 contributors who made this release possible. Here are some highlights ✨:
📚 Documentation improvements
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 has been 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 have been deprecated in favor of highlight and fade.
The deprecated ones are now removed.xAxisKey, yAxisKey, and zAxisKey properties have been 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) @LukasTyChanges before 8.x are listed in our changelog for older versions.