What's Changed

• [@mantine/charts] LineChart: Fix gridColor prop being passed down to the root DOM node
• [@mantine/carousel] Add data-type="next" and data-type="previous" to controls
• [@mantine/hooks] use-scroll-spy: Add offset prop support (#8209)
• [@mantine/core] ScrollArea: Fix incorrect horizontal size calculations in ScrollArea.Autosize (#8199)
• [@mantine/core] JsonInput: Fix font-size not scaling with size prop (#8206)
• [@mantine/hooks] Fix incorrect ESM exports for nodenext module resolution (#8211)
• [@mantine/hooks] use-document-visibility: Fix initial document visibility state not being set (#8215)
• [@mantine/dates] DateTimePicker: Fix onDropdownClose not working (#8212)

New Contributors

• @k-utsumi made their first contribution in #8212
• @sky0014 made their first contribution in #8215
• @seanwu1105 made their first contribution in #8211
• @nayounsang made their first contribution in #8199
• @andreaspersson-sciber made their first contribution in #8209

Full Changelog: 8.2.7...8.2.8

• [@mantine/hooks] use-media-query: Fix hook crashing inside iframe in Safari (#8189)
• [@mantine/hooks] use-debounced-value: Make cancel a stable reference (#8181)
• [@mantine/core] Combobox: Fix incorrect flipping logic (#8179, #8194)
• [@mantine/core] InputBase: Fix broken padding in multiline inputs (#8177)

What's Changed

• [@mantine/core] ScrollArea: Fix ScrollArea.Autosize not resizing when width of children changes (#8160)
• [@mantine/core] ScrollArea: Fix scrollbars not resizing correctly with dynamic content (#8162)
• [@mantine/core] TagsInput: Fix backspace key removing values with readOnly prop set (#8066)
• [@mantine/core] NumberInput: Fix incorrect trailing zeros handling for decimal values (#8089)
• [@mantine/core] Fix incorrect padding of multiline inputs (#8156)
• [@mantine/hooks] use-list-state: Update types to allow state function initializer (#8157)

New Contributors

• @Jannchie made their first contribution in #8156
• @mrdjohnson made their first contribution in #8169
• @davlatsultonov made their first contribution in #8168
• @brofar made their first contribution in #8163
• @monam2 made their first contribution in #8162
• @pgrones made their first contribution in #8160

Full Changelog: 8.2.4...8.2.5

What's Changed

• [@mantine/dates] DateInput: Fix disabled and clearable props collision (#8098)
• [@mantine/modals] Fix incorrect confirmProps and cancelProps types (#8099)
• [@mantine/dates] TimePicker: Fix controlled incorrect controlled value updates handling (#8108)
• [@mantine/core] NumberInput: Fix incorrect value sanitization in onBlur for max value clamping (#8114)
• [@mantine/core] Fix MultiSelect and TagsInput pills not being centered (#8145)
• [@mantine/core] Table: Fix 1px gap on thead with sticky + withTableBorder combination (#8109)
• [@mantine/core] Fix caret being invisible in some inputs (#8149)
• [@mantine/tiptap] Fix controls props being overridden by default props (#8148)
• [@mantine/code-highlight] Fix aria-label not being set on the copy button (#8130)
• [@mantine/code-highlight] Fix incorrect overscroll behavior

New Contributors

• @M1n01 made their first contribution in #8130
• @vicke4 made their first contribution in #8148
• @EdwardEB made their first contribution in #8149
• @themm-s made their first contribution in #8109

Full Changelog: 8.2.3...8.2.4

What's Changed

• [@mantine/dates] DatePickerInput: Fix incorrect handling of multiline values (#8116)
• [@mantine/code-highlight] Fix gradient of expand button not being visible on mobile Safari
• [@mantine/core] Combobox: Fix Combobox.Group not having aria-labelledby attribute
• [@mantine/core] Switch: Fix tap highlight color not being disabled on touch devices
• [@mantine/core] Remove transition with loader in ActionIcon and Button components if loading prop is not set to improve performance
• [@mantine/core] Combobox: Fix unexpected closed dropdown position calculation reducing performance
• [@mantine/charts] Fix tooltip not being aligned for some fonts
• [@mantine/dates] DatePickerInput: Fix incorrect Styles API selectors
• [@mantine/core] Table: Fix missing border when rowspan is set (#8137)
• [@mantine/hooks] use-move: Fix error dsiplayed in console for touch devices (#8065)
• [@mantine/dates] Fix incorrect props assigned to CalendarAriaLables props

New Contributors

• @sublimemm made their first contribution in #8124
• @TheMineWay made their first contribution in #8137

Full Changelog: 8.2.2...8.2.3

What's Changed

• [@mantine/core] Menu: Fix incorrect overflow handling of submenu (#8123)
• [@mantine/hooks] use-merged-ref: Fix incorrect handling of React 19 cleanup ref callback (#8118)
• [@mantine/dates] TimePicker: Fix incorrect leading zero handling in 12h format (#8120)
• [@mantine/dates] TimePicker: Fix min/max values not being enforced for 12h time format (#8107)
• [@mantine/core] HoverCard: Improve outside clicks handling (#8097)
• [@mantine/dates] Add month and year switching with keyboard to Calendar-based components (#7959)
• [@mantine/core] ScrollArea: Add onOverflowChange prop support to ScrollArea.Autosize (#7972)
• [@mantine/core] MultiSelect: Add clearSearchOnChange prop support (#8068)
• [@mantine/core] Select: Fix caret being visible in Firefox when the component is read only (#8063)

New Contributors

• @pradip-v2 made their first contribution in #8083
• @MidnightDesign made their first contribution in #8071
• @jobrk made their first contribution in #8068
• @amansachdev made their first contribution in #7959
• @idealconceptz made their first contribution in #8107
• @seansps made their first contribution in #8118

Full Changelog: 8.2.0...8.2.2

View changelog with demos on mantine.dev website

Styles API attributes

You now can pass attributes to inner elements of all components that support Styles API with attributes prop.
For example, it can be used to add data attributes for testing purposes:

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

function Demo() {
  return (
    <Button
      attributes={{
        root: { 'data-test-id': 'root' },
        label: { 'data-test-id': 'label' },
        inner: { 'data-test-id': 'inner' },
      }}
    >
      Button
    </Button>
  );
}

Container grid strategy

Container now supports strategy="grid" prop which enables more
features.

Differences from the default strategy="block":

• Uses display: grid instead of display: block
• Does not include default inline padding
• Does not set max-width on the root element (uses grid template columns instead)

Features supported by strategy="grid":

• Everything that is supported by strategy="block"
• Children with data-breakout attribute take the entire width of the container's parent element
• Children with data-container inside data-breakout have the same width as the main grid column

Example of using breakout feature:

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

function Demo() {
  return (
    <Container strategy="grid" size={500}>
      <Box bg="var(--mantine-color-indigo-light)" h={50}>
        Main content
      </Box>

      <Box data-breakout bg="var(--mantine-color-indigo-light)" mt="xs">
        <div>Breakout</div>

        <Box data-container bg="indigo" c="white" h={50}>
          <div>Container inside breakout</div>
        </Box>
      </Box>
    </Container>
  );
}

Tooltip target

New Tooltip target prop is an alternative to children. It accepts a string (selector),
an HTML element or a ref object with HTML element. Use target prop when you do
not render tooltip target as JSX element.

Example of using target prop with a string selector:

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

function Demo() {
  return (
    <>
      <Tooltip target="#hover-me" label="Tooltip over button" />
      <Button id="hover-me">Hover me to see tooltip</Button>
    </>
  );
}

HoverCard.Group

HoverCard now supports delay synchronization between multiple instances using HoverCard.Group component:

import { HoverCard, Button, Text, Group } from '@mantine/core';

function Demo() {
  return (
    <HoverCard.Group openDelay={500} closeDelay={100}>
      <Group justify="center">
        <HoverCard shadow="md">
          <HoverCard.Target>
            <Button>First</Button>
          </HoverCard.Target>
          <HoverCard.Dropdown>
            <Text size="sm">First hover card content</Text>
          </HoverCard.Dropdown>
        </HoverCard>

        <HoverCard shadow="md">
          <HoverCard.Target>
            <Button>Second</Button>
          </HoverCard.Target>
          <HoverCard.Dropdown>
            <Text size="sm">Second hover card content</Text>
          </HoverCard.Dropdown>
        </HoverCard>

        <HoverCard shadow="md">
          <HoverCard.Target>
            <Button>Third</Button>
          </HoverCard.Target>
          <HoverCard.Dropdown>
            <Text size="sm">Third hover card content</Text>
          </HoverCard.Dropdown>
        </HoverCard>
      </Group>
    </HoverCard.Group>
  );
}

use-selection hook

New use-selection hook:

import { Checkbox, Table } from '@mantine/core';
import { useSelection } from '@mantine/hooks';

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 positions = useMemo(() => elements.map((element) => element.position), [elements]);

  const [selection, handlers] = useSelection({
    data: positions,
    defaultSelection: [39, 56],
  });

  const rows = elements.map((element) => {
    const isSelected = selection.includes(element.position);
    return (
      <Table.Tr key={element.name} bg={isSelected ? 'var(--mantine-color-blue-light)' : undefined}>
        <Table.Td>
          <Checkbox
            aria-label="Select row"
            checked={isSelected}
            onChange={(event) => {
              if (event.target.checked) {
                handlers.select(element.position);
              } else {
                handlers.deselect(element.position);
              }
            }}
          />
        </Table.Td>
        <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>
      <Table.Thead>
        <Table.Tr>
          <Table.Th>
            <Checkbox
              aria-label="Select deselect all rows"
              indeterminate={handlers.isSomeSelected()}
              checked={handlers.isAllSelected()}
              onChange={() => {
                if (handlers.isAllSelected()) {
                  handlers.resetSelection();
                } else {
                  handlers.setSelection(elements.map((el) => el.position));
                }
              }}
            />
          </Table.Th>
          <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>
  );
}

autoSelectOnBlur prop

Select and Autocomplete components now support autoSelectOnBlur prop.
Use it to automatically select the highlighted option when the input loses focus.
To see this feature in action: select an option with up/down arrows, then click outside the input:

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

function Demo() {
  return (
    <Select
      label="Your favorite library"
      placeholder="Pick value"
      autoSelectOnBlur
      searchable
      data={['React', 'Angular', 'Vue', 'Svelte']}
    />
  );
}

Source edit mode in RichTextEditor

RichTextEditor now supports source edit mode:

import { useEditor } from '@tiptap/react';
import StarterKit from '@tiptap/starter-kit';
import { RichTextEditor } from '@mantine/tiptap';
import { useState } from 'react';

function Demo() {
  const [isSourceCodeModeActive, onSourceCodeTextSwitch] = useState(false)

  const editor = useEditor({
    extensions: [StarterKit],
    content: '<p>Source code control example</p><p>New line with <strong>bold text</strong></p><p>New line with <em>italic</em> <em>text</em></p>',
  });

  return (
    <RichTextEditor editor={editor} onSourceCodeTextSwitch={onSourceCodeTextSwitch}>
      <RichTextEditor.Toolbar>
        <RichTextEditor.ControlsGroup>
          <RichTextEditor.SourceCode icon={BoldIcon} />
        </RichTextEditor.ControlsGroup>
        {!isSourceCodeModeActive && (
          <RichTextEditor.ControlsGroup>
            <RichTextEditor.Blockquote />
            <RichTextEditor.Bold />
            <RichTextEditor.Italic />
            <RichTextEditor.Underline />
            <RichTextEditor.Strikethrough />
            <RichTextEditor.ClearFormatting />
            <RichTextEditor.Highlight />
          </RichTextEditor.ControlsGroup>
        )}
      </RichTextEditor.Toolbar>

      <RichTextEditor.Content />
    </RichTextEditor>
  );
}

Recharts 3 support

You can now use the latest Recharts 3 version with Mantine charts.
@mantine/charts package was validated to work with both Recharts 2 and Recharts 3 versions.
Note that, there might still be some minor issues with Recharts 3, you are welcome to report issues on GitHub.

Other changes

• Accordion default chevronSize prop value was changed to auto to allow using dynamic icon sizes
• Accordion now supports chevronIconSize prop to configure size of the default chevron icon
• AffixPosition type is now exported from @mantine/core package
• errorProps, labelProps and descriptionProps props of all inputs now have stricter types and better IDE autocomplete
• TypographyStylesProvider was renamed to just Typography to simplify usage. TypographyStylesProvider name is still available but marked as deprecated – it will be removed in 9.0.0 release.
• Slider and RangeSlider components now have separate documentation pages

What's Changed

• [@mantine/core] Container: Fix base responsive props value not being handled correctly (#8054)
• [@mantine/form] Fix type errors with read only array types (#7950)
• [@mantine/core] Fix incorrect disabled border color of Checkbox, Radio and Slider (#8053)
• [@mantine/core] Combobox: Fix aria-expanded attribute not being assigned correctly to combobox target
• [@mantine/core] Menu: Fix SubMenu having visual arrow offset when default props are set for Popover on theme (#8027)
• [@mantine/form] Fix form.resetField not updating DOM with mode: 'uncontrolled' (#8050)
• [@mantine/form] Add option to trigger watch callbacks when nested field value changes (#8026)
• [@mantine/hooks] use-move: Fix React 18 compatibility (#8018)
• [@mantine/dates] DateTimePicker: Add defaultDate prop support (#8023)
• [@mantine/dates] DatePickerInput: Fix size="xs being slightly different from other inputs
• [@mantine/dates] TimePicker: Fix dropdown being visible even when withDropdown={false} is set
• [@mantine/core] Popover: Fix onClick not firing on the child of Popover.Target
• [@mantine/spotlight] Fix incorrect query prop with empty string handling
• [@mantine/core] Text: Fix autocomplete not working for size prop
• [@mantine/hooks] use-debounced-callback: Fix incorrect leading behavior (#8021)
• [@mantine/core] Collapse: Add keepMounted prop support (#8013)
• [@mantine/date] TimePicker: Fix disabled and readOnly props not working (#8011)

New Contributors

• @Retwix made their first contribution in #8032
• @crehard made their first contribution in #8018
• @erwijet made their first contribution in #8026
• @evantrimboli made their first contribution in #7950

Full Changelog: 8.1.2...8.1.3

What's Changed

• [@mantine/dates] DatePickerInput: Fix incorrect presets handling
• [@mantine/dates] DatePickerInput: Fix onDropdownClose not being called in some cases
• [@mantine/hooks] use-scroll-spy: Add scrollHost option support (#8003)
• [@mantine/core] PinInput: Fix incorrect default size (#7990)
• [@mantine/core] Fix bdrs prop not working (#7996)
• [@mantine/core] Fix env prop not being available on HeadlessMantineProvider (#7992)
• [@mantine/core] Fix placeholder overflowing MultiSelect and TagsInput components
• [@mantine/core] Popover: fix autoUpdate triggering extra rerenders with keepMounted (#7983)

New Contributors

• @chumba-wamba made their first contribution in #7992

Full Changelog: 8.1.1...8.1.2

What's Changed

• [@mantine/hooks] use-set: Fix union method not working correctly (#7981)
• [@mantine/core] Popover: Fix incorrect position handling (#7955, #7953)
• [@mantine/dates] TimePicker: Fix incorrect empty string handling (#7927)
• [@mantine/dates] DatePickerInput: Fix incorrect onChange type (#7943)
• [@mantine/dates] TimePicker: Fix incorrect handling of min/max values in some cases (#7904)
• [@mantine/hooks] use-hotkeys: Fix Escape key not being handled correctly in some browsers (#7928)
• [@mantine/core] Tree: Fix detached DOM nodes memory leak (#7940)
• [@mantine/hooks] use-debounced-callback: Add cancel method support (#7965)
• [@mantine/dates] DatePicker: Fix incorrect value type for type="range" (#7937)
• [@mantine/dates] DatePicker: Fix className and style props not working when presets prop is set (#7960)

New Contributors

• @JeonJaewon made their first contribution in #7978
• @KevinLu made their first contribution in #7942

Full Changelog: 8.1.0...8.1.1