|
5 | 5 | All notable changes to this project will be documented in this file.
|
6 | 6 | See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
7 | 7 |
|
| 8 | +## 8.0.0-beta.0 |
| 9 | + |
| 10 | +<img width="100%" alt="MUI X v8 Beta is live" src="https://github.com/user-attachments/assets/61ec4dd8-c946-456b-8b45-d51de8772f5d"> |
| 11 | + |
| 12 | +_Mar 18, 2025_ |
| 13 | + |
| 14 | +We'd like to offer a big thanks to the 21 contributors who made this release possible. Here are some highlights ✨: |
| 15 | + |
| 16 | +- 🚀 Add [Time Range Picker](https://next.mui.com/x/react-date-pickers/time-range-picker/) component |
| 17 | +- 🎁 Add support for `@mui/material` version 7 in all X packages |
| 18 | +- 🐞 Bugfixes |
| 19 | +- 🌍 Improve Chinese (zh-CN), (zh-HK), (zh-TW), Czech (cs-CZ), Korean (ko-KR) and Slovak (sk-Sk) locales on the Data Grid |
| 20 | +- 🌍 Improve Chinese (zh-CN), (zh-HK) and (zh-TW) locales on the Pickers |
| 21 | + |
| 22 | +## Breaking changes |
| 23 | + |
| 24 | +- ℹ️ The peer dependency on `@mui/material` has been updated to accept only v7. |
| 25 | + This has been done to increase the adoption rate of ESM. |
| 26 | + 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. |
| 27 | + |
| 28 | +Special thanks go out to the community members for their valuable contributions: |
| 29 | +@Blake-McCullough, @hlavacz, @k-rajat19, @layerok, @nusr, @owais635, @yelahj. |
| 30 | +Following are all team members who have contributed to this release: |
| 31 | +@alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @DiegoAndai, @flaviendelangle, @Janpot, @JCQuintas, @KenanYusuf, @LukasTy, @MBilalShafi, @michelengelen, @noraleonte, @romgrk. |
| 32 | + |
| 33 | +<!--/ HIGHLIGHT_ABOVE_SEPARATOR /--> |
| 34 | + |
| 35 | +## Alpha release highlights |
| 36 | + |
| 37 | +Below are the highlights of the alpha releases leading up to this beta release: |
| 38 | + |
| 39 | +- ⚛️ React 19 support. |
| 40 | + |
| 41 | +- 🛠️ New and improved Data Grid [Toolbar component](https://next.mui.com/x/react-data-grid/components/toolbar/). |
| 42 | +- 📦 Data Grid [data source](https://next.mui.com/x/react-data-grid/server-side-data/) is now available in the Community plan. |
| 43 | +- 🚫 Add ["No columns" overlay](https://next.mui.com/x/react-data-grid/overlays/#no-columns-overlay) to Data Grid. |
| 44 | +- 🍬 Improved design for Data Grid [Header filters](https://next.mui.com/x/react-data-grid/filtering/header-filters/). |
| 45 | +- 🔄 Add Data Grid [Scroll restoration](https://next.mui.com/x/react-data-grid/scrolling/#scroll-restoration). |
| 46 | +- 💫 Support [aggregation with server-side data](https://next.mui.com/x/react-data-grid/server-side-data/aggregation/). |
| 47 | +- 🎁 Support [Server-side lazy loading](https://next.mui.com/x/react-data-grid/server-side-data/lazy-loading/) on the Data Grid. |
| 48 | +- 🎯 Improved [data caching](https://next.mui.com/x/react-data-grid/server-side-data/#data-caching). |
| 49 | +- 🏎️ Improve Data Grid aggregation, Excel export serialization, mount, resize and scrolling performance. |
| 50 | +- 🎨 Improve Data Grid theming and add default background color. |
| 51 | + |
| 52 | +- 📊 New Pro chart: [Funnel](https://next.mui.com/x/react-charts/funnel/). |
| 53 | +- 📊 New Community chart: [Radar](https://next.mui.com/x/react-charts/radar/) is available in preview for testing. |
| 54 | +- 📊 Charts legend is now an HTML element which can be styled more easily. |
| 55 | +- 📊 Create [custom HTML components](https://next.mui.com/x/react-charts/components/#html-components) using chart data. |
| 56 | +- 📊 Refactor Charts [Tooltip customization](https://next.mui.com/x/react-charts/tooltip/#overriding-content). |
| 57 | +- 📊 Improve Charts [composition](https://next.mui.com/x/react-charts/composition/#overview). |
| 58 | +- 📊 Charts support server-side rendering under [some conditions](https://next.mui.com/x/react-charts/getting-started/#server-side-rendering). |
| 59 | +- 📊 Add a new API to support multiple axes (decouple `margin` and `axis-size`) |
| 60 | + |
| 61 | +- 🔁 Support [automatic parents and children selection](https://next.mui.com/x/react-tree-view/rich-tree-view/selection/#automatic-parents-and-children-selection) for the Rich Tree View components. |
| 62 | + |
| 63 | +### Data Grid |
| 64 | + |
| 65 | + |
| 66 | + |
| 67 | +- [DataGrid] Add a slot for unsort icon in column menu (#16918) @layerok |
| 68 | +- [DataGrid] Add click propagation and prevents default on `toggleMenu` click (#16845) @michelengelen |
| 69 | +- [DataGrid] Anchor preference panel to columns/filter trigger (#16953) @KenanYusuf |
| 70 | +- [DataGrid] Fix `QuickFilter` debounce overriding input value (#16856) @KenanYusuf |
| 71 | +- [DataGrid] Fix `printOptions` not respecting `hideFooter` root prop (#14863) @k-rajat19 |
| 72 | +- [DataGrid] Fix `processRowUpdate()` error if the row is removed before it is executed (#16741) @arminmeh |
| 73 | +- [DataGrid] Fix bug with adding and removing columns in active edit state (#16888) @Blake-McCullough |
| 74 | +- [DataGrid] Fix columns update not restoring column definition defaults (#16970) @cherniavskii |
| 75 | +- [DataGrid] Fix page scrolling when preference panel is opened (#17004) @KenanYusuf |
| 76 | +- [DataGrid] Fix visual issue with pinned columns and row spanning (#16923) @MBilalShafi |
| 77 | +- [DataGrid] Make column header menu button aria-labels unique (#16796) @owais635 |
| 78 | +- [DataGrid] Refactor: create base Pagination (#16759) @romgrk |
| 79 | +- [DataGrid] Update CSS variable naming convention to singular (#16993) @KenanYusuf |
| 80 | +- [DataGrid] Use Material UI CSS vars (#16962) @KenanYusuf |
| 81 | +- [l10n] Improve Chinese (zh-CN), (zh-HK) and (zh-TW) locales (#15230, #16898 and #16966) @nusr |
| 82 | +- [l10n] Improve Czech (cs-CZ) and Slovak (sk-Sk) locales (#16968) @hlavacz |
| 83 | +- [l10n] Improve Korean (ko-KR) locale (#16807) @yelahj |
| 84 | + |
| 85 | +#### `@mui/[email protected]` [](https://mui.com/r/x-pro-svg-link 'Pro plan') |
| 86 | + |
| 87 | +Same changes as in `@mui/[email protected]`, plus: |
| 88 | + |
| 89 | +- [DataGridPro] Fix header filters not displaying restored values (#16855) @MBilalShafi |
| 90 | +- [DataGridPro] Fix infinite loading not reacting when scrolling to the end (#16926) @arminmeh |
| 91 | + |
| 92 | +#### `@mui/[email protected]` [](https://mui.com/r/x-premium-svg-link 'Premium plan') |
| 93 | + |
| 94 | +Same changes as in `@mui/[email protected]`, plus: |
| 95 | + |
| 96 | +- [DataGridPremium] Fix selection propagation issues with controlled state (#16810) @MBilalShafi |
| 97 | + |
| 98 | +### Date and Time Pickers |
| 99 | + |
| 100 | +#### Breaking changes |
| 101 | + |
| 102 | +- The `useClearableField` hook has been removed. |
| 103 | + The custom field component now receives the `clearable` and `onClear` props — [Learn more](https://next.mui.com/x/migration/migration-pickers-v7/#useclearablefield). |
| 104 | +- The `ExportedUseClearableFieldProps`, `UseClearableFieldSlots`, `UseClearableFieldSlotProps`, and `UseClearableFieldResponse` types have been removed — [Learn more](https://next.mui.com/x/migration/migration-pickers-v7/#removed-types). |
| 105 | + |
| 106 | + |
| 107 | + |
| 108 | +- [l10n] Improve Chinese (zh-CN), (zh-HK) and (zh-TW) locales (#16966) @nusr |
| 109 | +- [pickers] Add the Time Range Picker component (#9431) @LukasTy and @flaviendelangle |
| 110 | +- [pickers] Add valid aria labels to the range picker opening button (#16799) @flaviendelangle |
| 111 | +- [pickers] Always use `props.value` as the source of truth when defined (#16853) @flaviendelangle |
| 112 | +- [pickers] Avoid passing unexpected `focusedView` to time renderers (#16869) @LukasTy |
| 113 | +- [pickers] Improve JSDoc (#16858) @flaviendelangle |
| 114 | +- [pickers] Remove `useClearableField` hook (#16859) @LukasTy |
| 115 | + |
| 116 | +#### `@mui/[email protected]` [](https://mui.com/r/x-pro-svg-link 'Pro plan') |
| 117 | + |
| 118 | +Same changes as in `@mui/[email protected]`, plus: |
| 119 | + |
| 120 | +- [DateRangeCalendar] Do not update the previewed day when hovering a day and the value is empty (#16892) @flaviendelangle |
| 121 | +- [TimeRangePicker] Shift popper between start and end input on multi input field (#16920) @LukasTy |
| 122 | + |
| 123 | +### Charts |
| 124 | + |
| 125 | +#### Breaking changes |
| 126 | + |
| 127 | +- Tick labels in the x-axis of cartesian charts will now have an ellipsis applied to prevent overflow. |
| 128 | + If your tick labels are being clipped sooner than you would like, you can increase the x-axis size by increasing its `height` property. |
| 129 | + 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. |
| 130 | + |
| 131 | + |
| 132 | + |
| 133 | +- [charts] Add axis highlight to the radar (#16868) @alexfauquette |
| 134 | +- [charts] Add radar labels (#16839) @alexfauquette |
| 135 | +- [charts] Allow breaking line for radar labels (#16947) @alexfauquette |
| 136 | +- [charts] Allow circular grid on radar chart (#16870) @alexfauquette |
| 137 | +- [charts] Allow customizing shape in scatter charts (#16640) @bernardobelchior |
| 138 | +- [charts] Avoid spreading props in demos (#16857) @bernardobelchior |
| 139 | +- [charts] Fix React 18 tests failing due to missing `forwardRef` (#16894) @bernardobelchior |
| 140 | +- [charts] Fix line highlight position with RTL (#16994) @alexfauquette |
| 141 | +- [charts] Fix interaction performance (#16897) @JCQuintas |
| 142 | +- [charts] Fix x-axis tick label overflow (#16709) @bernardobelchior |
| 143 | +- [charts] Grid support time step below 1s (#16957) @alexfauquette |
| 144 | +- [charts] Improve radar slice (#16932) @alexfauquette |
| 145 | +- [charts] Radar add option to highlighting series (#16940) @alexfauquette |
| 146 | +- [charts] Refactor zoom `isInteracting` behavior directly to community code (#16999) @JCQuintas |
| 147 | +- [charts] Remove `fireEvent` usage from tests (#17006) @JCQuintas |
| 148 | +- [charts] Remove dead voronoi code (#16886) @JCQuintas |
| 149 | +- [charts] Remove the polar axis plugin from the default plugins of the ChartContainer (#16936) @alexfauquette |
| 150 | +- [charts] Rename `useIsClient` (#16937) @bernardobelchior |
| 151 | + |
| 152 | +#### `@mui/[email protected]` [](https://mui.com/r/x-pro-svg-link 'Pro plan') |
| 153 | + |
| 154 | +Same changes as in `@mui/[email protected]`. |
| 155 | + |
| 156 | +### Tree View |
| 157 | + |
| 158 | + |
| 159 | + |
| 160 | +Internal changes. |
| 161 | + |
| 162 | +#### `@mui/[email protected]` [](https://mui.com/r/x-pro-svg-link 'Pro plan') |
| 163 | + |
| 164 | +Same changes as in `@mui/[email protected]`. |
| 165 | + |
| 166 | +### Docs |
| 167 | + |
| 168 | +- [docs] Add the Time Range Picker to relevant validation demos (#16919) @LukasTy |
| 169 | +- [docs] Adjust Picker field lifecycle explanation (#16901) @LukasTy |
| 170 | +- [docs] Fix custom detail panel toggle state update (#16929) @nusr |
| 171 | +- [docs] Fix Pickers custom field with Autocomplete demo (#16863) @LukasTy |
| 172 | +- [docs] Fix link to the lazy loading demo for the DataGrid (#16907) @nusr |
| 173 | +- [docs] Improve sparkline demo (#16911) @alexfauquette |
| 174 | +- [docs] Remove `showQuickFilter: true` toolbar prop from demos (#17003) @KenanYusuf |
| 175 | + |
| 176 | +### Core |
| 177 | + |
| 178 | +- [core] Fix proptypes and API docs after merge (#16934) @LukasTy |
| 179 | +- [core] Update `@mui/utils` dependency to only v7 (#16928) @Janpot |
| 180 | +- [core] Use MUI Core v7 libraries in packages and docs (#16771) @DiegoAndai |
| 181 | +- [code-infra] Avoid loading package.json with relative path (#16931) @Janpot |
| 182 | +- [code-infra] Bump `cimg/node` image version (#16964) @LukasTy |
| 183 | +- [code-infra] Create `Tanstack query` renovate group (#16989) @LukasTy |
| 184 | +- [code-infra] Fix inconsistent argos test (#16921) @JCQuintas |
| 185 | +- [infra] Added issue permission to workflow (#16865) @michelengelen |
| 186 | +- [infra] Make tests on React 18 part of pipeline (#16933) @LukasTy |
| 187 | +- [infra] changed event trigger from `pull_request` to `pull_request_target` (#16902) @michelengelen |
| 188 | +- [test] Fix Apple M3 failing to execute unit test cases (#16959) @nusr |
| 189 | + |
8 | 190 | ## 8.0.0-alpha.14
|
9 | 191 |
|
10 | 192 | _Mar 7, 2025_
|
|
97 | 279 |
|
98 | 280 | ```diff
|
99 | 281 | const { publicAPI } = useTreeItemUtils();
|
100 |
| - |
| 282 | + |
101 | 283 | const handleSelectItem() {
|
102 | 284 | - publicAPI.selectItem({ event, itemId: props.itemId, shouldBeSelected: true })
|
103 | 285 | + publicAPI.setItemSelection({ event, itemId: props.itemId, shouldBeSelected: true })
|
|
108 | 290 |
|
109 | 291 | ```diff
|
110 | 292 | const { publicAPI } = useTreeItemUtils();
|
111 |
| - |
| 293 | + |
112 | 294 | const handleExpandItem() {
|
113 | 295 | - publicAPI.setItemExpansion(event, props.itemId, true)
|
114 | 296 | + publicAPI.setItemExpansion({ event, itemId: props.itemId, shouldBeExpanded: true })
|
|
0 commit comments