@mui/x-date-pickers - npm Package Versions

8.0.0-alpha.13

Feb 28, 2025

We'd like to offer a big thanks to the 19 contributors who made this release possible. Here are some highlights ✨:

• 📊 Decouple margin and axis-size. A new API to support multiple axes (#16418) @JCQuintas
• 🗺️ Added Bangla (bn-BD) locale
• 🗺️ Improve Russian (ru-RU) and Hungarian (hu-HU) locale on the Data Grid

Special thanks go out to the community members for their contributions: @denpiligrim, @lhilgert9, @noherczeg, @officialkidmax, @pcorpet. Following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @flaviendelangle, @hasdfa, @Janpot, @JCQuintas, @KenanYusuf, @LukasTy, @michelengelen, @MBilalShafi, @oliviertassinari, @romgrk.

<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->

Data Grid

Breaking changes

• The slots.baseFormControl component was removed.

• The "Reset" button in the column visibility panel now resets to the initial column visibility model. Previously it was reset to the model that was active at the time the panel was opened. The reset behavior follows these rules:

  1. If an initial columnVisibilityModel is provided, it resets to that model.
  2. If a controlled columnVisibilityModel is provided, it resets to the first model value.
  3. When the columns are updated (via the 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:

  • rowSelectionModel
  • onRowSelectionModelChange
  • initialState.rowSelectionModel

  - const [rowSelectionModel, setRowSelectionModel] = React.useState<GridRowSelectionModel>([]);
  + const [rowSelectionModel, setRowSelectionModel] = React.useState<GridRowSelectionModel>({ type: 'include', ids: new Set() });
  

  This change also impacts the gridRowSelectionStateSelector selector. For convenience, use 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.

• The 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,
  -  }}
   />
  

8.0.0-alpha.12

Feb 17, 2025

We'd like to offer a big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:

• 📦 Data Grid data source is now available in the Community plan
• ⚡ Improve Data Grid Excel export serialization performance
• 🚫 Add "No columns" overlay to Data Grid
• 🌍 Improve Polish (pl-PL) and Ukrainian (uk-UA) locales on the Data Grid
• 🐞 Bugfixes

Special thanks go out to the community contributors who have helped make this release possible: @Neonin, @nusr, and @pawelkula. Following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @Janpot, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi, @michelengelen, @oliviertassinari, @romgrk, and @mapache-salvaje.

Data Grid

Breaking changes

• The main--hasSkeletonLoadingOverlay class has been renamed 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)
  

8.0.0-alpha.11

Feb 7, 2025

We'd like to offer a big thanks to the 11 contributors who made this release possible. Here are some highlights ✨:

• ⚡ Mount and resize performance improvements for the Data Grid

Special thanks go out to the community contributors who have helped make this release possible: @lauri865. Following are all team members who have contributed to this release: @alexfauquette, @arminmeh, @bernardobelchior, @flaviendelangle, @Janpot, @KenanYusuf, @LukasTy, @MBilalShafi, @noraleonte, @romgrk.

<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->

Data Grid

Breaking changes

• 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;
  

8.0.0-alpha.10

Jan 30, 2025

We'd like to offer a big thanks to the 10 contributors who made this release possible. Here are some highlights ✨:

• 🎨 Data Grid theming improvements and default background color
• 📚 Documentation improvements
• 🐞 Bugfixes

Special thanks go out to the community contributors who have helped make this release possible: @k-rajat19, @lauri865, @mateuseap. Following are all team members who have contributed to this release: @alexfauquette, @flaviendelangle, @JCQuintas, @KenanYusuf, @MBilalShafi, @romgrk, @arminmeh.

<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->

Data Grid

Breaking changes

• 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:

  • Use optional chaining
  • Use non-null assertion operator if you are sure your code is always executed when the apiRef is not null
  • Return early if apiRef is null
  • Throw an error if apiRef is null

@mui/x-data-grid@8.0.0-alpha.10

• [DataGrid] Fix renderContext calculation with scroll bounce / over-scroll (#16297) @lauri865
• [DataGrid] Remove unused classes from gridClasses (#16256) @mateuseap
• [DataGrid] Add default background color to grid (#16066) @KenanYusuf
• [DataGrid] Add missing style overrides (#16272) @KenanYusuf
• [DataGrid] Add possibility of null in the return type of the useGridApiRef() hook (#16353) @arminmeh
• [DataGrid] Fix header filters keyboard navigation when there are no rows (#16126) @k-rajat19
• [DataGrid] Fix order of onClick prop on toolbar buttons (#16356) @KenanYusuf
• [DataGrid] Refactor row state propagation (#15627) @lauri865
• [DataGrid] Refactor: create TextField props (#16174) @romgrk
• [DataGrid] Remove outdated warning (#16360) @MBilalShafi
• [DataGrid] Respect width of iconContainer 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:

• [DataGridPro] Fetch new rows only once when multiple models are changed in one cycle (#16101) @arminmeh
• [DataGridPro] Fix the return type of 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.

Date and Time Pickers

Breaking changes

• The component passed to the field slot no longer receives the ref, disabled, className, sx, label, name, formatDensity, enableAccessibleFieldDOMStructure, selectedSections, onSelectedSectionsChange and inputRef props — Learn more
• The MuiPickersPopper 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

• [pickers] Clean the internals and the public API of <PickersPopper /> (#16319) @flaviendelangle
• [pickers] Improve the JSDoc of the PickerContextValue properties (#16327) @flaviendelangle
• [pickers] Move more field props to the context (#16278) @flaviendelangle
• [pickers] Do not close the picker when doing keyboard editing (#16402) @flaviendelangle

@mui/x-date-pickers-pro@8.0.0-alpha.10

Same changes as in @mui/x-date-pickers@8.0.0-alpha.10.

Charts

Breaking changes

• Replace 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.
• The default colors have changed. To keep using the old palette. It is possible to import blueberryTwilightPalette from @mui/x-charts/colorPalettes and set it on the colors property of charts.
• The id property is now optional on the Pie and Scatter data types.

@mui/x-charts@8.0.0-alpha.10

• [charts] Add new bumpX and bumpY curve options (#16318) @JCQuintas
• [charts] Move tooltipGetter to seriesConfig (#16331) @JCQuintas
• [charts] Move item highligh feature to plugin system (#16211) @alexfauquette
• [charts] Replace legend.position.horizontal from "left" | "middle" | "right" to "start" | "center" | "end" (#16315) @JCQuintas
• [charts] New default colors (#16373) @JCQuintas
• [charts] Make id 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.

Tree View

@mui/x-tree-view@8.0.0-alpha.10

Internal changes.

@mui/x-tree-view-pro@8.0.0-alpha.10

Same changes as in @mui/x-tree-view@8.0.0-alpha.10.

Docs

• [docs] Improve release documentation (#16321) @MBilalShafi

Core

• [core] Reduce chart perf benchmark weight (#16374) @alexfauquette
• [test] Fix console warnings while executing tests with React 18 (#16386) @arminmeh
• [test] Fix flaky data source tests in DataGrid (#16395) @lauri865

7.25.0

Jan 31, 2025

We'd like to offer a big thanks to the 5 contributors who made this release possible. Here are some highlights ✨:

• 🐞 Bugfixes

Special thanks go out to the community contributors who have helped make this release possible: @k-rajat19, @lauri865. Following are all team members who have contributed to this release: @KenanYusuf, @MBilalShafi, @arminmeh.

<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->

Data Grid

@mui/x-data-grid@7.25.0

• [DataGrid] Fix renderContext calculation with scroll bounce / over-scroll (#16368) @lauri865
• [DataGrid] Refactor row state propagation (#16351) @lauri865
• [DataGrid] Add missing style overrides (#16272) (#16358) @KenanYusuf
• [DataGrid] Fix header filters keyboard navigation when there are no rows (#16369) @k-rajat19
• [DataGrid] Fix order of onClick prop on toolbar buttons (#16364) @KenanYusuf
• [DataGrid] Improve test coverage of server side data source (#15988) @MBilalShafi
• [DataGrid] Remove outdated warning (#16370) @MBilalShafi
• [DataGrid] Respect width of iconContainer during autosizing (#16409) @michelengelen

@mui/x-data-grid-pro@7.25.0

Same changes as in @mui/x-data-grid@7.25.0, plus:

• [DataGridPro] Fix the return type of useGridApiRef for Pro and Premium packages on React < 19 (#16348) @arminmeh
• [DataGridPro] Fetch new rows only once when multiple models are changed in one cycle (#16382) @arminmeh

@mui/x-data-grid-premium@7.25.0

Same changes as in @mui/x-data-grid-pro@7.25.0.

Date and Time Pickers

@mui/x-date-pickers@7.25.0

Internal changes.

@mui/x-date-pickers-pro@7.25.0

Same changes as in @mui/x-date-pickers@7.25.0.

Charts

@mui/x-charts@7.25.0

Internal changes.

@mui/x-charts-pro@7.25.0

Same changes as in @mui/x-charts@7.25.0.

Tree View

@mui/x-tree-view@7.25.0

Internal changes.

@mui/x-tree-view-pro@7.25.0

Same changes as in @mui/x-tree-view@7.25.0.

Docs

• [docs] Improve release documentation (#16322) @MBilalShafi

Core

• [test] Fix flaky data source tests in DataGrid (#16382) @lauri865

8.0.0-alpha.9

Jan 24, 2025

We'd like to offer a big thanks to the 10 contributors who made this release possible. Here are some highlights ✨:

• 🌍 Improve Persian (fa-IR) and Urdu (ur-PK) locales on the Data Grid
• 📚 Documentation improvements
• 🐞 Bugfixes

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.

Data Grid

7.24.1

Jan 24, 2025

We'd like to offer a big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:

• 🐞 Bugfixes
• 🌍 Improve Persian (fa-IR) locale on the Data Grid

Special thanks go out to the community contributors who have helped make this release possible: @mostafaRoosta74, @lauri865.

Following are all team members who have contributed to this release: @alexfauquette, @JCQuintas, @cherniavskii, @LukasTy, @arminmeh.

Data Grid