7 9 0

import { BarChartDemos, EmotionDemos, FieldDemos, StylesDemos, } from '@docs/demos'; import { Layout } from '@/layout'; import { MDX_DATA } from '@/mdx';

export default Layout(MDX_DATA.Changelog790);

@mantine/emotion package

New @mantine/emotion package is now available to simplify migration from 6.x to 7.x. It includes createStyles function and additional functionality for sx and styles props for all components similar to what was available in @mantine/core package in v6.

If you still haven't migrated to 7.x because of the change in styling approach, you can now have a smoother transition by using @mantine/emotion package. To learn more about the package, visit the documentation page and updated 6.x to 7.x migration guide.

React 18.3 support

All @mantine/* components and hooks have been updated to support React 18.3. It is recommended to update your application as well to prepare for the upcoming React 19 release.

use-field hook

New use-field hook is now available in @mantine/form package. It can be used as a simpler alternative to use-form hook to manage state of a single input without the need to create a form. The hook supports most of use-form hook features: validation with function, touched and dirty state, error message, validation on change/blur and more.

use-field hook also supports async validation:

Custom PostCSS mixins

You can now define custom mixins that are not included in mantine-postcss-preset by specifying them in the mixins option. To learn about mixins syntax, follow postcss-mixins documentation. Note that this feature is available in postcss-preset-mantine starting from version 1.15.0.

Example of adding clearfix and circle mixins:

module.exports = {
  plugins: {
    'postcss-preset-mantine': {
      autoRem: true,
      mixins: {
        clearfix: {
          '&::after': {
            content: '""',
            display: 'table',
            clear: 'both',
          },
        },
        circle: (_mixin, size) => ({
          borderRadius: '50%',
          width: size,
          height: size,
        }),
      },
    },
    // ... Other plugins
  },
};

Then you can use these mixins in your styles:

.demo {
  @mixin clearfix;
  @mixin circle 100px;
}

use-matches hook

New use-matches hook exported from @mantine/core is an alternative to use-media-query if you need to match multiple media queries and values. It accepts an object with media queries as keys and values at given breakpoint as values.

Note that use-matches hook uses the same logic as use-media-query under the hood, it is not recommended to be used as a primary source of responsive styles, especially if you have ssr in your application.

In the following example:

• Starting from theme.breakpoints.lg, color will be red.9
• Between theme.breakpoints.sm and theme.breakpoints.lg, color will be orange.9
• Below theme.breakpoints.sm, color will be blue.9

BarChart value label

BarChart now supports withBarValueLabel prop that allows displaying value label on top of each bar:

Documentation updates

• New usage with emotion guide
• 6.x -> 7.x guide has been updated to include migration to @mantine/emotion package
• use-field hook documentation
• Uncontrolled form mode examples now include usage of form.key() function
• Custom PostCSS mixins documentation
• use-matches hook documentation has been added to the responsive guide

Other changes

• Advanced templates now include GitHub workflows to run tests on CI
• AspectRatio component has been migrated to aspect-ratio CSS property