Drawer

Usage

import { useState } from 'react';
import { Drawer, Button, Group } from '@mantine/core';

function Demo() {
  const [opened, setOpened] = useState(false);

  return (
    <>
      <Drawer
        opened={opened}
        onClose={() => setOpened(false)}
        title="Register"
        padding="xl"
        size="xl"
      >
        {/* Drawer content */}
      </Drawer>

      <Group position="center">
        <Button onClick={() => setOpened(true)}>Open Drawer</Button>
      </Group>
    </>
  );
}

Position

Drawer can be placed on left (default), top, right and bottom. Control drawer position with position prop:

<Drawer position="right" />

Customize overlay

Drawer uses Overlay component, you can change overlay opacity, blur and color:

import { Drawer, useMantineTheme } from '@mantine/core';

function Demo() {
  const theme = useMantineTheme();

  return (
    <Drawer
      overlayColor={theme.colorScheme === 'dark' ? theme.colors.dark[9] : theme.colors.gray[2]}
      overlayOpacity={0.55}
      overlayBlur={3}
    >
      {/* Drawer content */}
    </Drawer>
  );
}

Sizes

Control drawer size by setting size prop. You can use predefined values (xs, sm, md, lg, xl, full) or set drawer body size with any valid css value, for example, 200px, 25%, calc(100% - 100px). Size controls width for left and right positions and height for top and bottom. Size cannot exceed 100% of width and 100vh of height.

<Drawer position="right" size="xl" /> // predefined xl width
<Drawer position="top" size={200} /> // 200px width
<Drawer position="left" size="75%" /> // 75% width

Change transition

Drawer is built with Transition component. You can customize transition, timing function and duration:

<Drawer
  transition="rotate-left"
  transitionDuration={250}
  transitionTimingFunction="ease"
/>

Accessibility and usability

By default:

• When drawer is opened focus is trapped inside and document.body scroll is locked in current position
• When user clicks on overlay or presses escape drawer is closed
• Drawer transitions use disabled when user prefers to reduce motion
• Drawer body has aria-modal and role="dialog" attributes

Add aria-labelledby, aria-describedby and closeButtonLabel props for better screen readers support:

<Drawer
  aria-labelledby="drawer-title"
  aria-describedby="drawer-body"
  closeButtonLabel="Close drawer"
>
  <h1 id="drawer-title">Title</h1>
  <div id="drawer-body">Body</div>
</Drawer>

Initial focus

Drawer uses use-focus-trap to manage focus. To specify initial focus element add data-autofocus attribute:

<Drawer>
  <input />
  {/* Second input in modal will have initial focus */}
  <input data-autofocus />
  <input />
</Drawer>