7.2.1

What's Changed

• [@mantine/core] Numberinput: Reduce width of the right section to match controls width (#5033)
• [@mantine/core] Popover: Add size floating-ui middleware to prevent large dropdown from exceeding screen size (#5213)
• [@mantine/code-highlight] Prevent error thowing if language is not recognized by highlight.js (#5099)
• [@mantine/notifications] Fix limit prop not working (#5105)
• [@mantine/dropzone] Allow overriding props from react-dropzone-esm with component props (#5114)
• [@mantine/core] Remove "use client"; directive from rem, createTheme and other utility theme functions (#5119)
• [@mantine/hooks] use-hash: Add option to retrieve value initially without useEffect (#5140)
• [@mantine/core] PasswordInput: Fix incorrect styles when the component is wrapper with element with data-disabled attribute (#5149)
• [@mantine/core] Add support for values separated by space to rem and em functions (#5174)
• [@mantine/code-highlight] Fix CodeHighlightTabs throwing error if language of the tab is nor specified (#5178)
• [@mantine/core] Fieldset: Fix some elements overflowing the viewport width when rendered inside fieldset (#5179)
• [@mantine/core] Modal: Fix ScrollArea not working as scroll container (#5189)
• [@mantine/core] Text: Fix inline prop not working (#5194)
• [@mantine/core] Alert: Fix incorrect styles when the component is used without children (#5196)
• [@mantine/core] Set aria-hidden on Checkbox and Radio icons to prevent them being announced by screen readers (#5202)
• [@mantine/form] Fix form.reset not reseting values to updated initialValues (#5123)

New Contributors

• @kavinda1995 made their first contribution in #5145
• @dodas made their first contribution in #5123
• @gorkunov made their first contribution in #5194
• @ranquild made their first contribution in #5213
• @SecondThundeR made their first contribution in #5210

Full Changelog: 7.2.0...7.2.1

7.2.0 ⭐

Community templates

You are welcome to share your GitHub templates with the community. Community templates are
featured on the getting started page. You can find a guide on how to
create and submit a template here.

Examples of templates that you can submit:

• Next.js pages router + MDX + Mantine blog template
• Next.js app router + Mantine + styled-components template
• Vite + Mantine + Emotion template

NumberFormatter component

New NumberFormatter component allows to format numbers
with thousands separators, decimal separators, and custom number of decimal places.
It supports the same formatting related props as NumberInput component.

import { NumberFormatter } from '@mantine/core';

function Demo() {
  return <NumberFormatter prefix="$ " value={1000000} thousandSeparator />;
}

Form actions

@mantine/form package now exports createFormActions function that
can be used to change form state from anywhere in your application.
The mechanism of form actions is similar to notifications system,
modals manager and other similar packages.

To use form actions, set name property in use-form settings:

import { useForm } from '@mantine/form';

export interface DemoFormValues {
  name: string;
  age: number;
}

function Demo() {
  const form = useForm<DemoFormValues>({
    name: 'demo-form',
    initialValues: {
      name: '',
      age: 0,
    },
  });
}

Then call createFormActions function with the same form name as specified in useForm settings:

// Import type of form values from the file where you defined useForm
import type { DemoFormValues } from './DemoForm';
import { createFormActions } from '@mantine/form';

export const demoFormActions = createFormActions<DemoFormValues>('demo-form');

After that, you can use demoFormActions to change form state from anywhere in your application.
For example, after a fetch request or after a user interaction with a component that does not have access
to the form state:

import { useEffect } from 'react';
import { Button } from '@mantine/core';
import { demoFormActions } from './demoFormActions';

function ExternalComponent() {
  useEffect(() => {
    fetch('/api/user')
      .then((res) => res.json())
      .then((res) =>
        demoFormActions.setValues({
          name: res.name,
          age: res.age,
        })
      );
  }, []);

  return <Button onClick={() => demoFormActions.reset()}>Reset demo form</Button>;
}

Table data prop

Table component now supports data prop which can be used to generate table rows
from given data:

import { Table, TableData } from '@mantine/core';

const tableData: TableData = {
  caption: 'Some elements from periodic table',
  head: ['Element position', 'Atomic mass', 'Symbol', 'Element name'],
  body: [
    [6, 12.011, 'C', 'Carbon'],
    [7, 14.007, 'N', 'Nitrogen'],
    [39, 88.906, 'Y', 'Yttrium'],
    [56, 137.33, 'Ba', 'Barium'],
    [58, 140.12, 'Ce', 'Cerium'],
  ],
};

function Demo() {
  return <Table data={tableData} />;
}

Table sticky header

Table component now supports stickyHeader prop, which can be used to make the table header
stick to the top of the table:

import { Table } from '@mantine/core';

const elements = [
  { position: 6, mass: 12.011, symbol: 'C', name: 'Carbon' },
  { position: 7, mass: 14.007, symbol: 'N', name: 'Nitrogen' },
  { position: 39, mass: 88.906, symbol: 'Y', name: 'Yttrium' },
  { position: 56, mass: 137.33, symbol: 'Ba', name: 'Barium' },
  { position: 58, mass: 140.12, symbol: 'Ce', name: 'Cerium' },
];

function Demo() {
  const rows = elements.map((element) => (
    <Table.Tr key={element.name}>
      <Table.Td>{element.position}</Table.Td>
      <Table.Td>{element.name}</Table.Td>
      <Table.Td>{element.symbol}</Table.Td>
      <Table.Td>{element.mass}</Table.Td>
    </Table.Tr>
  ));

  return (
    <Table stickyHeader stickyHeaderOffset={60}>
      <Table.Thead>
        <Table.Tr>
          <Table.Th>Element position</Table.Th>
          <Table.Th>Element name</Table.Th>
          <Table.Th>Symbol</Table.Th>
          <Table.Th>Atomic mass</Table.Th>
        </Table.Tr>
      </Table.Thead>
      <Table.Tbody>{rows}</Table.Tbody>
      <Table.Caption>Scroll page to see sticky thead</Table.Caption>
    </Table>
  );
}

Usage with Sass

It is now possible to use Mantine with Sass. You can find documentation
on this page. Note that it is still required to set up postcss-preset-mantine
in order for all functions to work properly. Sass can be used as a replacement for CSS modules
– it supports all features that CSS modules support.

You can find examples of Mantine + Sass usage in separate branches of templates:

• Next.js app router + Sass example
• Vite + Sass example

Inline loaders

Loader component now supports children prop. The prop allows overriding the default
loader with any React node. It is useful in components that support loaderProps (Button, LoadingOverlay, Dropzone, etc.)
– with loaderProps.children you can now display any React node instead of the loader.

import { useDisclosure } from '@mantine/hooks';
import { LoadingOverlay, Button, Group, Box } from '@mantine/core';

function Demo() {
  const [visible, { toggle }] = useDisclosure(false);

  return (
    <>
      <Box pos="relative">
        <LoadingOverlay visible={visible} loaderProps={{ children: 'Loading...' }} />
        {/* ...other content */}
      </Box>

      <Group position="center">
        <Button onClick={toggle}>Toggle overlay</Button>
      </Group>
    </>
  );
}

lightHidden and darkHidden props

All Mantine components now support lightHidden and darkHidden props that can be used to hide
components in a specific color scheme:

import { Button } from '@mantine/core';

function Demo() {
  return (
    <>
      <Button color="cyan" lightHidden>
        Visible in dark color scheme only
      </Button>

      <Button color="pink" darkHidden>
        Visible in light color scheme only
      </Button>
    </>
  );
}

light-root and dark-root mixins

New light-root and dark-root mixins were added to postcss-preset-mantine.
These mixins can be used to add color scheme specific styles to the :root/html element.
Note that to use these mixins, you need to update postcss-preset-mantine to 1.9.0 or higher.

:root {
  @mixin light-root {
    --color: red;
  }

  @mixin dark-root {
    --color: blue;
  }
}

Documentation updates

• New Styles overview guide
• New Usage with Sass guide
• Storybook guide was updated to use new @storybook/addon-styling-webpack with separate instructions for Vite and other frameworks
• CSS modules guide now includes new section about global class names reference with :global selector
• Getting started guide now includes new section about setting up VS Code with PostCSS Language Support and CSS Variable Autocomplete extensions
• Popover documentation now includes a guide on how to use nested popovers
• AspectRatio documentation now includes a guide on how to use it in flexbox containers
• Additional AppShell.Section documentation was added
• 8 new Checkbox examples and demos were added

Other changes

• Dropzone now supports loaderProps prop to pass props down to the Loader component
• theme.variantColorResolver now supports hoverColor prop, which allows controlling color property when the component is hovered. New property is supported in Button and ActionIcon components.
• Flex is now a polymorphic component – it accepts renderRoot and component props
• Checkbox root element now has data-checked attribute when the checkbox is checked
• Checkbox and Radio components now support changing icon color with iconColor prop
• use-form now supports `onVal...

7.1.7

What's Changed

• [@mantine/core] Change how primary color fallback is applied in default theme.variantColorResolver to allow setting custom fallback values and undefined handling
• [@mantine/core] Select: Fix error thrown on blur when given value is not in the data array
• [@mantine/core] Fix option icon being smaller when option text has multiple lines
• [@mantine/core] Spoiler: Fix unexpected empty space when hide label is null (#5126)
• [@mantine/core] Button: Fix different border width of regular and disabled buttons
• [@mantine/core] Table: Fix row background changing on hover in dark color scheme even when highlightOnHover prop is not set
• [@mantine/carousel] Fix slideSize prop not handling number values (#5050)
• [@mantine/core] Add option to keep transitions when color scheme changes in useMantineColorScheme hook (#5092)
• [@mantine/core] Improve pop-* transitions animations (#5096)
• [@mantine/hooks] use-local-storage: Fix error throwing if localStorage/sessionStorage is blocked by browser (#5091)
• [@mantine/dates] Calendar: Fix incorrect focus logic when first item is disabled (#5078)

New Contributors

• @yongwee made their first contribution in #5091
• @sartak made their first contribution in #5126
• @yogabonito made their first contribution in #5107

Full Changelog: 7.1.5...7.1.6

7.1.5

What's Changed

• [@mantine/core] HoverCard: Fix dropdown not visible when Checkbox/Switch is used as target (#5072)
• [@mantine/code-highlight] Fix code not updating when content changes (#5073)
• [@mantine/core] Highlight: Fix incorrect highlighted parts when one of the array items includes substrings of other item (#5045)
• [@mantine/core] Rating: Fix container overflow when the width of total item exceeds parent element width (#5057)
• [@mantine/core] Radio: Fix checked icon clipping and not being centered with some sizes (#5064)
• [@mantine/core] Fix incorrect callback arguments values types (#5067)
• [@mantine/core] TagsInput: Fix required prop not working correctly (#5032)

New Contributors

• @sunadoi made their first contribution in #5032
• @MarcoLotz made their first contribution in #5047
• @refansa made their first contribution in #5061
• @teh23 made their first contribution in #5064
• @hannahrfowler made their first contribution in #5057
• @wgpsutherland made their first contribution in #5045

Full Changelog: 7.1.3...7.1.5

7.1.3

What's Changed

• [@mantine/core] Paper: Fix incorrect withBorder prop cascading to nested Paper components (#4930)
• [@mantine/core] MultiSelect: Fix incorrect input styles without placeholder (#4954)
• [@mantine/core] NumberInput: Fix focus shifting from the input when one of the controls is pressed (#5013)
• [@mantine/notifications] Fix style prop breaking animations (#5007)
• [@mantine/core] Rating: Fix incorrect touch events handling (#4976)
• [@mantine/carousel] Fix onClick handler from nextControlProps being overwritten by internal props (#4985)
• [@mantine/core] MultiSelect: Fix selectFirstOptionOnChange prop not working (#4997)
• [@mantine/core] Select: Fix incorrect behavior when both searchValue and value are controlled (#4998)
• [@mantine/spotlight] Fix DOM error thrown after HMR and several other cases (#4992)
• [@mantine/hooks] use-timeout: Fix callback not running after state change (#4968)
• [@mantine/hooks] use-focus-trap: Fix incorrect input[type="radio"] handling (#4856)

New Contributors

• @spicybackend made their first contribution in #4953
• @Shresth72 made their first contribution in #4856
• @DenisBessa made their first contribution in #4992
• @thealmarques made their first contribution in #4976
• @Devon-Dickson made their first contribution in #4969

Full Changelog: 7.1.2...7.1.3

7.1.2

• [@mantine/dropzone] Fix incorrect pointer events of inner element (#4934)
• [@mantine/dropzone] Fix broken exports from react-dropzone-esm package

Full Changelog: 7.1.1...7.1.2

7.1.1

What's Changed

• [@mantine/core] Radio: Fix description and error being misaligned when the component is rendered inside Radio.Group
• [@mantine/core] HoverCard: Add missing HoverCard.extend
• [@mantine/core] Drawer: Fix incorrect transitions in rtl direction (#4917)
• [@mantine/core] TagsInput: Fix incorrect IME keyboard input handling (#4947)
• [@mantine/core] Container: Fix nested Container components inheriting some properties from parent Container component (#4859)
• [@mantine/core] Menu: Fix incorrect Menu.Item rtl styles (#4936)
• [@mantine/core] Spoiler: remove margin-bottom when "Show more" is hidden (#4928)
• [@mantine/dropzone] Migrate to react-dropzone-esm package to support frameworks that work only with esm (#4920)
• [@mantine/core] Button: Fix incorrect border-radius of loading overlay (#4939)
• [@mantine/core] Portal: Fix error when value of className prop contained whitespace (#4935)
• [@mantine/core] MultiSelect: Fix incorrect input sizes values (#4925)
• [@mantine/core] Affix: Fix position prop set as attribute on the root element (#4932)
• [@mantine/core] Update react-textarea-autosize dependency to the latest version to fix issues with edge runtime (#4923)
• [@mantine/core] Select: Fix search value not changing when component value is controlled (#4915)
• [@mantine/core] Fix incorrect ActionIcon.Group, Button.Group and Rating components RTL styles (#4907)
• [@mantine/core] TagsInput: Fix onOptionSubmit not being called when tag is submitted with Enter key (#4892)
• [@mantine/core] NumberInput: Fix value reset to zero when leading non-zero number is deleted (#4916)

New Contributors

• @ShaifArfan made their first contribution in #4916
• @Yhprum made their first contribution in #4892
• @tatthien made their first contribution in #4903
• @m074554n made their first contribution in #4907
• @Raicuparta made their first contribution in #4914
• @wuifdesign made their first contribution in #4915
• @martis900 made their first contribution in #4923
• @Jacouille made their first contribution in #4928
• @a-ryang made their first contribution in #4947

Full Changelog: 7.1.0...7.1.1

7.1.0 ⭐

CSS layers

Starting from 7.1.0 it is possible to import all @mantine/* packages styles with rules
defined in mantine CSS layer.
CSS rules within a layer are grouped together and applied before rules without a layer. This means that
even if you do not have control over styles import order, you can still override Mantine styles with
regular styles.

// If your styles are not wrapped in @layer directive,
// they will be applied after Mantine styles.
// Import order does not affect styles in this case
import classes from './Demo.module.css';
import '@mantine/core/styles.layer.css';

You can import styles within a layer by importing @mantine/*/styles.layer.css files.
Note that these files are a full replacement for @mantine/*/styles.css files –
you should not import both of them.

import '@mantine/core/styles.layer.css';
import '@mantine/dates/styles.layer.css';
// ... other styles

CSS layers are also useful if you want to combine Mantine components with other libraries which also
provide styles. You can use @layer directive to control the order of styles:

@layer base, mantine, components;

In this example, Mantine styles will take precedence over other library base styles, but other library
components styles will take precedence over Mantine component styles.

As of September 2023, CSS layers are supported in all modern browsers and have 90% browser support.

renderRoot prop

All polymorphic components now support renderRoot prop, which
is an alternative to component prop. renderRoot prop allows changing the root element
to any other component or HTML tag with a callback function. It can be used in cases when
component prop is not flexible enough:

• Target component props are incompatible with Mantine component. For example, Button component expects className
  to be a string, but react-router-dom NavLink expects
  className to be a function.
• Target component is a generic – it either accepts type as a parameter or its type changes depending
  on its props. Examples: typed Next.js Link, TanStack router Link

renderRoot example with react-router-dom NavLink:

import cx from 'clsx';
import { Button } from '@mantine/core';
import { NavLink } from 'react-router-dom';

function Demo() {
  return (
    <Button
      renderRoot={({ className, ...others }) => (
        <NavLink
          className={({ isActive }) => cx(className, { 'active-class': isActive })}
          {...others}
        />
      )}
    >
      React router NavLink
    </Button>
  );
}

renderRoot example with typed Next.js Link:

import Link from 'next/link';
import { Button } from '@mantine/core';

function Demo() {
  return (
    <Button renderRoot={(props) => <Link href="/hello" {...props} />}>
      Typed Next link button
    </Button>
  );
}

Improved ESM support

All @mantine/* packages now have improved ESM support:

• Files in esm folder now have .mjs extension
• You can use @mantine/* packages with type: module in package.json without any additional configuration
• All packages are now fully compatible with Remix v2
• Tree shaking was improved for some bundlers

CSS variables in style prop

It is now possible to define CSS variables in style prop in all Mantine components –
style prop is no longer restricted by React.CSSProperties type:

import { Box } from '@mantine/core';

function Demo() {
  return <Box style={{ '--radius': '0.5rem', borderRadius: 'var(--radius)' }} />;
}

form.setInitialValues

@mantine/form now supports form.setInitialValues method
which allows updating initial values after the form was initialized. This method is useful when you
want to update values that are used in form.reset and to compare values for dirty fields state:

import { useEffect } from 'react';
import { useForm } from '@mantine/form';

function Demo() {
  const form = useForm({
    initialValues: {
      name: '',
      email: '',
    },
  });

  useEffect(() => {
    fetch('/api/user')
      .then((res) => res.json())
      .then((data) => {
        // Update initial values after form was initialized
        // These values will be used in form.reset
        // and to compare values to get dirty state
        form.setInitialValues(data);
        form.setValues(data);
      });
  }, []);
}

7.0.2

What's Changed

• [@mantine/dates] Fix DatePickerInput and other similar inputs not having correct height when used without placeholder
• [@mantine/core] MultiSelect: Fix check icon not displayed in selected grouped options
• [@mantine/dates] Fix broken esm imports of dayjs plugins (#4875)

New Contributors

• @BengtHagemeister made their first contribution in #4875

Full Changelog: 7.0.1...7.0.2

7.0.1

What's Changed

• [@mantine/core] Loader: Make dots loader look the same as in v6 (#4801)
• [@mantine/core] Button: Fix incorrect disabled styles of outline variant (#4815)
• [@mantine/core] Fix broken theme.other type override type in .d.ts files (#4831)
• [@mantine/core] SegmentedControl: Fix error when selected item removed from the data array (#4122)
• [@mantine/core] AppShell: Fix AppShell.Main not taking up full height (#4842)
• [@mantine/core] Input: Fix incorrect focus styles when error prop is set (#4832)
• [@mantine/core] Add clearable prop back to Select, MultiSelect and TagsInput components
• [@mantine/core] Portal: Reduce output DOM structure to a single div element, add data-portal attribute to the root portal element to indentify portals in devtools
• [@mantine/code-highlight] Add missing static classes on CodeHighlight and CodeHighlightTabs components
• [@mantine/hooks] use-local-storage: Fix hook throwing error if local storage is blocked by user (#3259)
• [@mantine/tiptap] Fix onBlur called each time controls are clicked (#3209)
• [@mantine/core] Add aria-describedby and aria-labelledby attributes to Radio.Group, Checkbox.Group and Switch.Group components (#3170)
• [@mantine/core] Spoiler: Add aria-expanded and aria-controls attributes to show/hide control (#3183)
• [@mantine/core] Spoiler: Change tab order of the show/hide button to make it receive focus before the content (#3183)
• [@mantine/form] Fix incorrect values type in deeply nested validation rules (#4735)
• [@mantine/dates] DateTimePicker: Set seconds to 0 if withSecond prop is not set (#4737)
• [@mantine/dropzone] Fix Dropzone.FullScreen staying opened after file was droppped for the first time (#4580)
• [@mantine/core] Modal: Fix closeButtonProps not including CloseButtonProps (#4793)
• [@mantine/core] Select: Fix id prop not setting id attribute on the input element (#4809)
• [@mantine/core] Allow using custom keys in theme.spacing and other similar values when theme is extended with createTheme
• [@mantine/core] PasswordInput: Fix input field not taking entire width of the field in Firefox
• [@mantine/core] Add default props to Group and Stack to prevent unwanted inheritance
• [@mantine/core] Menu: Fix dropdown opening when keepMounted prop is set and outside click is registered
• [@mantine/core] Select: Fix search value not updating when data array changes (#4822)
• [@mantine/core] Fix broken colors override type (#4816)
• [@mantine/core] Table: Fix row hover not working in dark mode when striped prop is set (#4817)
• [@mantine/core] Fix styles breaking if color scheme value in local storage is not valid

New Contributors

• @jason-lee88 made their first contribution in #4778
• @suenalaba made their first contribution in #4794
• @Brucia323 made their first contribution in #4800
• @WillKirkmanM made their first contribution in #4813
• @iamtomffee made their first contribution in #4818
• @mateuscqueiros made their first contribution in #4817
• @matheusvellone made their first contribution in #4816
• @DoubleJ-G made their first contribution in #4822
• @eluce2 made their first contribution in #4835
• @MrMaina100 made their first contribution in #4848
• @RobinTTY made their first contribution in #4842
• @jonavila made their first contribution in #4801
• @Codeprinz-1 made their first contribution in #4569
• @jopesh made their first contribution in #4792
• @chrisbendel made their first contribution in #4872

Full Changelog: 7.0.0...7.0.1