MRT logoMaterial React Table

On This Page

    Changelog

    Version 2

    Version 2.4.0 - 2024-01-04

    • Upgraded to TanStack Table v8.11.3 for bug fixes with expanding and row selection

    • Added 'datetime', 'datetime-range', 'time', and 'time-range' filter variants

    • Added Tooltips to pagination buttons

    • Added new MRT_ColumnVirtualizer and MRT_RowVirtualizer types

    • Added behavior to not render Save Row button unless either onCreatingRowSave or onEditingRowSave is provided

    • Allowed muiColumnActionsButtonProps.children to be overridden with a custom icon

    • Fixed issue with Sticky Row Pinning and Row Virtualization

    Version 2.3.1 - 2024-01-02

    • disable row selection for creating row

    • fixed virtualized column index warning

    Version 2.3.0 - 2024-01-02

    • Added new visibleInShowHideMenu column option to allow for columns to be hidden from the show/hide columns menu, regardless of column visibility state.

    • Fixed bug where the Show All button in the show/hide columns menu did not properly skip columns with enableHiding: false set.

    • Fixed bug where creatingRow did not work with virtualization enabled.

    Version 2.2.0 - 2024-01-01

    • Added new useMRT_Rows, useMRT_ColumnVirtualizer, and useMRT_RowVirtualizer hooks to allow for more advanced use cases for headless mode.

    • Fixed possible duplicate table body row keys warning

    Version 2.1.0 - 2023-12-22

    • Upgraded to TanStack Table v8.11.2 for new columnResizeDirection table option

    • Added proper column resizing support for right-to-left languages

    • Updated French locale

    • Fixed warning on edit textfield with outlined variant

    Version 2.0.6 - 2023-12-15

    • Fixed horizontal scrollbar showing up in layoutMode grid with column resizing enabled

    • add disabled prop to muiTablePaginationProps

    Version 2.0.5 - 2023-12-05

    • Upgraded to TanStack Virtual v3.0.1 stable release

    • Added MuiTablePagination-root class to mrt pagination root element for easier styling

    • Fixed potential duplicate key warning while rendering skeleton rows when getRowId table option is provided and doesn't properly return undefined

    • Fixed muiSearchTextFieldProps.InputProps now able to partially overridden

    Version 2.0.4 - 2023-11-09

    • Add support for 'all' rows pagination option

    • Added muiPaginationProps.SelectProps support back to allow for native select

    Version 2.0.3 - 2023-11-06

    • Locale updates

    Version 2.0.2 - 2023-11-01

    • Fixed bug with popover filters null ref focus

    Version 2.0.1 - 2023-10-31

    • Fixed bug where edit row action menu was created for all editDisplayModes

    • Fixed rest spread on table head row

    • Changed pagination text to a span instead of with hardcoded 0 margin and padding

    Version 2.0.0 - 2023-10-27

    • Made MaterialReactTable a named export instead of a default export.

    • Made @mui/x-date-pickers a required peer dependency.

    • Added new useMaterialReactTable hook to replace the need for the tableInstanceRef prop.

    • Now exporting all MRT_* sub-components and utility functions from material-react-table package to allow for easier building of custom UIs in headless mode.

    • Added createMRTColumnHelper utility function to help with creating columns with slightly more type-safety.

    • Added new mrtTheme table option to allow for changing some basic mui theme colors that are hard to target with CSS or the mui theme provider.

    • Added new layoutMode: 'grid-no-grow' option for better column resizing behavior.

    • Improved column resizing UI.

    • Added new columnFilterDisplayMode option to allow for different filter UIs.

    • Added new createDisplayMode table option to allow for different create/editing UIs. Added new functionality for creating new rows in the table.

    • Renamed editMode prop to editDisplayMode table option.

    • Added new paginationDisplayMode option to allow for different pagination UIs.

    • Added new rowPinningDisplayMode table option and row pinning features.

    • Added new "autocomplete" filterVariant.

    • Added new "date" filterVariant.

    • Added new "date-range" filterVariant.

    • Added new loading overlay UI features when isLoading or showLoadingOverlay are true Progress bars no longer show when isLoading is true.

    • Changed the default sort icon and show it as visible with a low opacity by default in table header cells.

    • Changed the filter label icon to show before the sort icon in table header cells.

    • Changed the default global filter search box UI to be compact and outlined.

    • Changed edit text field UI to be more compact by default.

    • Changed the default rowNumberDisplayMode to "static".

    • Changed how the full screen table UI works internally. (No more mui full screen dialog, just simple CSS)

    • Upgraded to TanStack Table v8.10.7

    • Upgraded to TanStack Virtual v3.0.0-beta.68

    • Renamed options

      • editingMode -> editDisplayMode

      • rowNumberMode -> rowNumberDisplayMode

      • enablePinning -> enableColumnPinning and enableRowPinning

      • virtualizerInstanceRef split into columnVirtualizerRef and rowVirtualizerRef

      • virtualizerProps split into columnVirtualizerOptions and rowVirtualizerOptions

      • columnVirtualizerProps -> columnVirtualizerOptions

      • rowVirtualizerProps -> rowVirtualizerOptions

      • muiTablePaginationProps -> muiPaginationProps

      • muiTableBodyCellCopyButtonProps -> muiCopyButtonProps

      • muiTableBodyCellEditTextFieldProps -> muiEditTextFieldProps

      • muiTableBodyCellSkeletonProps -> muiSkeletonProps

      • muiTableBodyRowDragHandleProps -> muiRowDragHandleProps

      • muiTableDetailPanelProps -> muiDetailPanelProps

      • muiTableHeadCellColumnActionsButtonProps -> muiColumnActionsButtonProps

      • muiTableHeadCellDragHandleProps -> muiColumnDragHandleProps

      • muiTableHeadCellFilterCheckboxProps -> muiFilterCheckboxProps

      • muiTableHeadCellFilterTextFieldProps -> muiFilterTextFieldProps

      • muiTableHeadCellFilterSliderProps -> muiFilterSliderProps

      • MRT_FilterFnsState -> MRT_ColumnFilterFns

      • MaterialReactTableProps -> MRT_TableOptions

      • MRT_FullScreenToggleButton => MRT_ToggleFullScreenButton

    Is anything missing from this v2 changelog? Make a PR or join the Discord to discuss.

    Version 1

    See the old V1 Changelog

    Roadmap

    Version 2 Roadmap (2023)

    Material React Table V2 was a big release months in the making that mostly focussed on the new useMaterialReactTable hook and paradigms. New features will be added and many bug fixes around virtualization compatibility with advanced features will be prioritized first.

    A lighter weight useMaterialReactTableLight hook is also being considered in the near future that will be a bit more bare-bones and tree-shakable. All features will be opt-in and will not be enabled by default.