github mui-org/material-ui v5.0.0-alpha.25

Feb 11, 2021

Big thanks to the 30 contributors who made this release possible. Here are some highlights ✨:

  • 👩‍🎤 Convert 32 components to emotion. Around 64% of the components have been migrated so far, thanks to the help of the community. We aim to migrate them all before the end of Q1 2021.
    The podium of the most active community members in the migration 🏆:

    1. @natac13 x17
    2. @vicasas x5
    3. @kodai3 x4
  • 📐 Add a subset of the system as flattened props on Typography (#24496) @mnajdova.
    Now, you can do:

  <Typography padding={2} color="text.secondary" />
  • 📅 Focus on the date pickers, 5 fixes and 3 docs improvements.
  • 💅 Provide a new darkScrollbar() CSS utility to improve the native scrollbar in dark mode. The documentation uses it.


Breaking changes

  • Increase the minimum version of TypeScript supported from v3.2 to v3.5. (#24795) @petyosi

We try to align with types released from DefinitelyTyped (i.e. packages published on npm under the @types namespace).
We will not change the minimum supported version in a major version of Material-UI.
However, we generally recommend to not use a TypeScript version older than the lowest supported version of DefinitelyTyped.


  • [ImageList] Migrate to emotion (#24615) @kodai3
  • [Dialog] Migrate DialogTitle to emotion (#24623) @vicasas
  • [TextField] Prepare removal of labelWidth prop (#24595) @oliviertassinari
  • [ImageList] Migrate ImageListItem to emotion (#24619) @kodai3
  • [Card] Migrate CardMedia to emotion (#24625) @natac13
  • [Card] Migrate CardHeader to emotion (#24626) @natac13
  • [TextField] Migrate FilledInput to emotion (#24634) @mnajdova
  • [Fab] Migrate to emotion (#24618) @natac13
  • [ClickAwayListener] Fix children and onClickAway types (#24565) @eps1lon
  • [List] Migrate ListItemIcon to emotion (#24630) @vicasas
  • [Card] Migrate CardActionArea to emotion (#24636) @natac13
  • [DataTable] Add example in docs for data table (#24428) @DanailH
  • [CircularProgress] Migrate to emotion (#24622) @natac13
  • [ImageList] Migrate ImageListItemBar to emotion (#24632) @kodai3
  • [TextField] Migrate Input component to emotion (#24638) @duganbrett
  • [Tab] Migrate to emotion (#24651) @natac13
  • [Table] Migrate to emotion (#24657) @natac13
  • [List] Migrate ListItemAvatar to emotion (#24656) @vicasas
  • [TextField] Migrate FormControl to emotion (#24659) @duganbrett
  • [Table] Migrate TableContainer to emotion (#24666) @natac13
  • [Tab] Migrate TabScrollButton to emotion (#24654) @natac13
  • [Card] Warn on raised + outlined (#24648) @sumarlidason
  • [TextField] Migrate FormHelperText to emotion (#24661) @duganbrett
  • [Dialog] Migrate DialogContent to emotion (#24670) @vicasas
  • [Typography] Add system props (#24496) @mnajdova
  • [Paper] Improve warning on invalid combinations of variant and elevation (#24667) @eps1lon
  • [Chip] Migrate to emotion (#24649) @natac13
  • [ToggleButton] Migrate to emotion (#24674) @natac13
  • [Step] Migrate to emotion (#24678) @natac13
  • [Link] Fix CSS prefix property casing with emotion (#24701) @idanrozin
  • [Card] Use the default elevation (#24733) @oliviertassinari
  • [Typography] Remove align inherit noise (#24717) @oliviertassinari
  • [Dialog] Convert role none presentation to presentation (#24500) @hallzac2
  • [TextField] Improve baseline alignment with start adornment (#24742) @praveenkumar-kalidass
  • [Popper] Fix usage of ownerDocument with anchorEl (#24753) @ruppysuppy
  • [Table] Migrate TableBody to emotion (#24703) @natac13
  • [Table] Migrate TableRow to emotion (#24687) @natac13
  • [TextField] Migrate FormGroup to emotion (#24685) @vicasas
  • [CssBaseline] Make dark mode scrollbar overrides an optional function (#24780) @dborstelmann
  • [ButtonGroup] Migrate ButtonGroup to emotion (#24775) @mirefly
  • [Checkbox] Migrate to emotion (#24702) @natac13
  • [Table] Migrate TableHead to emotion (#24686) @natac13
  • [Table] Migrate TableFooter to emotion (#24684) @natac13
  • [Skeleton] Migrate to emotion (#24652) @kodai3


Breaking changes

  • [system] Use spacing unit in gap, rowGap, and columnGap (#24794) @ruppysuppy

If you were using a number previously, you need to provide the value in px to bypass the new transformation with theme.spacing. The change was done for consistency with the Grid spacing prop and the other system spacing properties, e.g. <Box padding={2}>.

  - gap={2}
  + gap="2px"


  • [styled-engine] Fix GlobalStyles not to throw when no theme is available (#24671) @mnajdova


Breaking changes

  • [types] Rename the exported Omit type in @material-ui/types. (#24795) @petyosi
    The module is now called DistributiveOmit. The change removes the confusion with the built-in Omit helper introduced in TypeScript v3.5. The built-in Omit, while similar, is non-distributive. This leads to differences when applied to union types. See this StackOverflow answer for further details.
-import { Omit } from '@material-ui/types';
+import { DistributiveOmit } from '@material-ui/types';


  • [types] Remove implicit children from PropInjector (#24746) @eps1lon


  • [Pickers] Fix role attribute (#24621) @EkaterinaMozheiko
  • [Pickers] Fix showTodayButton not returning the current time (#24650) @anthonyraymond
  • [Pickers] Ensure components have a display name in DEV (#24676) @eps1lon
  • [Pickers] Fix more name inconsistencies (#24734) @oliviertassinari
  • [Pickers] Dismiss on clickaway when using the desktop variant (#24653) @eps1lon
  • [Pickers] Add missing periods at end of some descriptions (#24791) @fulin426
  • [Pickers] Enable YearPicker documentation (#24830) @oliviertassinari
  • [Pickers] Fix useState related console warnings in examples (#24848) @ydubinskyi


  • [docs] Add sorting section (#24637) @dtassone
  • [docs] Include in docs directive to silence eslint erroneous warning (#24644) @silviot
  • [docs] Clarifying the documentation about Chip behavior (#24645) @KarimOurrai
  • [docs] Update Typography in migration guide (#24662) @mbrookes
  • [examples] Update examples to use StyledEngineProvider (#24489) @mnajdova
  • [docs] Add API documentation for *DatePicker components (#24655) @eps1lon
  • [docs] Add HoodieBees to sponsors (#24735) @mbrookes
  • [docs] Fix indent @oliviertassinari
  • [docs] Make
    responsive to font size (#24531) @eps1lon
  • [docs] Follow similar demo pattern for date and time pickers (#24739) @eps1lon
  • [docs] Add information about local dev environment (#24771) @plug-n-play
  • [docs] Add tcespal to Showcase (#24793) @ArnaultNouvel
  • [docs] Fix CssBaseline typography description (#24802) @xiaoyu-tamu
  • [docs] Add 'playlist' synonym to 'menu' (#24754) @Lagicrus
  • [docs] Add more similar icons (#24799) @oliviertassinari
  • [docs] Fix typo in the error message generated by createMuiTheme (#24827) @mbrookes
  • [examples] Align more with the v5 recommended approach (#24798) @Tejaswiangotu123
  • [docs] Update ButtonGroup demos to match v5 (#24797) @SCollinA
  • [docs] Fix formatting of mask prop description (#24842) @eps1lon
  • [docs] Add read synonym to drafts (#24854) @Lagicrus


  • [core] Fix release:tag pushing to material-ui-docs (#24633) @eps1lon
  • [core] Fix next using stale pages (#24635) @eps1lon
  • [test] Skip JSDOM in style related conformance tests (#24668) @mnajdova
  • [test] Conformance to handle wrapped elements (#24679) @natac13
  • [core] Batch small changes (#24705) @oliviertassinari
  • [test] Run more tests in Strict Mode (#24646) @oliviertassinari
  • [test] Avoid visual flakiness (#24737) @oliviertassinari
  • [core] Remove deprecated SimplifiedPropsOf/Simplify types (#24750) @petyosi
  • [core] Disable type-checking of .propTypes (#24747) @eps1lon
  • [test] Allow setting react-dist-tag via pipeline parameter (#24755) @eps1lon
  • [test] Don't run dev CI for dependabot pushes (#24833) @eps1lon
  • [test] Isolate Tooltip tests more (#24834) @eps1lon
  • [test] Clear emotion cache between tests (#24837) @eps1lon
  • [core] Save/restore actual yarn cache folder (#24844) @eps1lon
  • [test] Increase timeout to 4000ms for screenshots (#24850) @oliviertassinari

All contributors of this release in alphabetical order: @anthonyraymond, @ArnaultNouvel, @DanailH, @dborstelmann, @dtassone, @duganbrett, @EkaterinaMozheiko, @eps1lon, @fulin426, @hallzac2, @idanrozin, @KarimOurrai, @kodai3, @Lagicrus, @mbrookes, @mirefly, @mnajdova, @natac13, @oliviertassinari, @petyosi, @plug-n-play, @praveenkumar-kalidass, @ruppysuppy, @SCollinA, @silviot, @sumarlidason, @Tejaswiangotu123, @vicasas, @xiaoyu-tamu, @ydubinskyi

latest releases: v4.12.2, v5.0.0-beta.1, v4.12.1...
pre-release5 months ago