Components

Drawer

Slides in from the sides, top or bottom of the screen.

Usage

Change the opening side with the side prop.

Add a title to the header with the header slot. A close button is automatically included in the header.

The backdrop is blurred by default. Use backdrop="transparent" to remove the blur effect.

Page scrolling is locked by default when the drawer is open. Use the scrollLock= prop to allow scrolling while the drawer is open.

backdrop="transparent"

Astro

---
import { Button, Drawer, DrawerHeader, DrawerFooter } from "@opui/astro"
---

<div class="drawer-examples">
  <Button class="top" commandfor="drawer-block-start" command="show-modal"
    >Block Start</Button
  >
  <Button class="left" commandfor="drawer-inline-start" command="show-modal"
    >Inline Start</Button
  >
  <Button class="right" commandfor="drawer-inline-end" command="show-modal"
    >Inline End</Button
  >
  <Button class="bottom" commandfor="drawer-block-end" command="show-modal"
    >Block End</Button
  >
</div>

<Drawer id="drawer-inline-start" side="inline-start" closedby="any">
  <DrawerHeader slot="header" heading="Inline Start" />
  <Fragment slot="content">
    <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod
      tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
      veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea
      commodo consequat.
    </p>
    <p>
      Duis aute irure dolor in reprehenderit in voluptate velit esse cillum
      dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
      proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
    </p>
    <p>
      Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium
      doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo
      inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
    </p>
    <p>
      Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut
      fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem
      sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit
      amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora
      incidunt ut labore et dolore magnam aliquam quaerat voluptatem.
    </p>
    <p>
      Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis
      suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem
      vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil
      molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla
      pariatur?
    </p>
  </Fragment>
  <DrawerFooter slot="footer">
    <Button size="small" commandfor="drawer-inline-start" command="close"
      >Close</Button
    >
  </DrawerFooter>
</Drawer>

<Drawer id="drawer-inline-end" side="inline-end" closedby="any">
  <DrawerHeader slot="header" heading="Inline End" />
  <Fragment slot="content">
    <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod
      tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
      veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea
      commodo consequat.
    </p>
    <p>
      Duis aute irure dolor in reprehenderit in voluptate velit esse cillum
      dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
      proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
    </p>
    <p>
      Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium
      doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo
      inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
    </p>
    <p>
      Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut
      fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem
      sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit
      amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora
      incidunt ut labore et dolore magnam aliquam quaerat voluptatem.
    </p>
    <p>
      Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis
      suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem
      vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil
      molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla
      pariatur?
    </p>
  </Fragment>
  <DrawerFooter slot="footer">
    <Button size="small" commandfor="drawer-inline-end" command="close"
      >Close</Button
    >
  </DrawerFooter>
</Drawer>

<Drawer id="drawer-block-start" side="block-start" closedby="any">
  <DrawerHeader slot="header" heading="Block Start" />
  <Fragment slot="content">
    <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod
      tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
      veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea
      commodo consequat.
    </p>
    <p>
      Duis aute irure dolor in reprehenderit in voluptate velit esse cillum
      dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
      proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
    </p>
    <p>
      Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium
      doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo
      inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
    </p>
  </Fragment>
  <DrawerFooter slot="footer">
    <Button size="small" commandfor="drawer-block-start" command="close"
      >Close</Button
    >
  </DrawerFooter>
</Drawer>

<Drawer id="drawer-block-end" side="block-end" closedby="any">
  <DrawerHeader slot="header" heading="Block End" />
  <Fragment slot="content">
    <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod
      tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
      veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea
      commodo consequat.
    </p>
    <p>
      Duis aute irure dolor in reprehenderit in voluptate velit esse cillum
      dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
      proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
    </p>
    <p>
      Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium
      doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo
      inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
    </p>
  </Fragment>
  <DrawerFooter slot="footer">
    <Button size="small" commandfor="drawer-block-end" command="close"
      >Close</Button
    >
  </DrawerFooter>
</Drawer>

<script>
  const transparentToggle = document.querySelector(
    "#backdrop-transparent-toggle",
  ) as HTMLInputElement
  const drawers = document.querySelectorAll("dialog.drawer")

  transparentToggle?.addEventListener("change", (e) => {
    const isTransparent = (e.target as HTMLInputElement).checked
    drawers.forEach((drawer) => {
      if (isTransparent) {
        drawer.classList.add("backdrop-transparent")
      } else {
        drawer.classList.remove("backdrop-transparent")
      }
    })
  })
</script>

<style>
  .drawer-examples {
    display: grid;
    grid-template-areas:
      ". top ."
      "left . right"
      ". bottom .";
    gap: var(--size-3);
    justify-items: center;
    align-items: center;
    margin: var(--size-8) auto;
    width: fit-content;
  }

  .top {
    grid-area: top;
  }
  .left {
    grid-area: left;
  }
  .right {
    grid-area: right;
  }
  .bottom {
    grid-area: bottom;
  }
</style>

Output

<script type="module">
  const a = document.querySelector("#backdrop-transparent-toggle"),
    n = document.querySelectorAll("dialog.drawer");
  a?.addEventListener("change", (r) => {
    const t = r.target.checked;
    n.forEach((e) => {
      t
        ? e.classList.add("backdrop-transparent")
        : e.classList.remove("backdrop-transparent");
    });
  });
</script>
<div class="drawer-examples">
  <button
    commandfor="drawer-block-start"
    command="show-modal"
    class="button top"
  >
    Block Start</button
  ><button
    commandfor="drawer-inline-start"
    command="show-modal"
    class="button left"
  >
    Inline Start</button
  ><button
    commandfor="drawer-inline-end"
    command="show-modal"
    class="button right"
  >
    Inline End</button
  ><button
    commandfor="drawer-block-end"
    command="show-modal"
    class="button bottom"
  >
    Block End
  </button>
</div>
<dialog
  closedby="any"
  class="drawer inline-start scroll-lock"
  id="drawer-inline-start"
>
  <div class="header" slot="header">
    <span>Inline Start</span
    ><button
      onclick="this.closest('dialog').close()"
      title="Close"
      class="icon-button"
    >
      <svg
        xmlns="http://www.w3.org/2000/svg"
        width="32"
        height="32"
        viewBox="0 0 32 32"
      >
        <path
          fill="currentColor"
          d="M26.29 4.293a1 1 0 1 1 1.414 1.414L17.413 16l10.291 10.29a1 1 0 1 1-1.414 1.414L16 17.413L5.707 27.704a1 1 0 0 1-1.414-1.414L14.585 16L4.293 5.707a1 1 0 0 1 1.414-1.414L16 14.584z"
        ></path>
      </svg>
    </button>
  </div>
  <div class="content">
    <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod
      tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
      veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea
      commodo consequat.
    </p>
    <p>
      Duis aute irure dolor in reprehenderit in voluptate velit esse cillum
      dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
      proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
    </p>
    <p>
      Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium
      doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo
      inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
    </p>
    <p>
      Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut
      fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem
      sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit
      amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora
      incidunt ut labore et dolore magnam aliquam quaerat voluptatem.
    </p>
    <p>
      Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis
      suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem
      vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil
      molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla
      pariatur?
    </p>
  </div>
  <div class="footer" slot="footer">
    <button
      commandfor="drawer-inline-start"
      command="close"
      class="button small"
    >
      Close
    </button>
  </div>
</dialog>
<dialog
  closedby="any"
  class="drawer inline-end scroll-lock"
  id="drawer-inline-end"
>
  <div class="header" slot="header">
    <span>Inline End</span
    ><button
      onclick="this.closest('dialog').close()"
      title="Close"
      class="icon-button"
    >
      <svg
        xmlns="http://www.w3.org/2000/svg"
        width="32"
        height="32"
        viewBox="0 0 32 32"
      >
        <path
          fill="currentColor"
          d="M26.29 4.293a1 1 0 1 1 1.414 1.414L17.413 16l10.291 10.29a1 1 0 1 1-1.414 1.414L16 17.413L5.707 27.704a1 1 0 0 1-1.414-1.414L14.585 16L4.293 5.707a1 1 0 0 1 1.414-1.414L16 14.584z"
        ></path>
      </svg>
    </button>
  </div>
  <div class="content">
    <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod
      tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
      veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea
      commodo consequat.
    </p>
    <p>
      Duis aute irure dolor in reprehenderit in voluptate velit esse cillum
      dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
      proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
    </p>
    <p>
      Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium
      doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo
      inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
    </p>
    <p>
      Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut
      fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem
      sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit
      amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora
      incidunt ut labore et dolore magnam aliquam quaerat voluptatem.
    </p>
    <p>
      Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis
      suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem
      vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil
      molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla
      pariatur?
    </p>
  </div>
  <div class="footer" slot="footer">
    <button commandfor="drawer-inline-end" command="close" class="button small">
      Close
    </button>
  </div>
</dialog>
<dialog
  closedby="any"
  class="drawer block-start scroll-lock"
  id="drawer-block-start"
>
  <div class="header" slot="header">
    <span>Block Start</span
    ><button
      onclick="this.closest('dialog').close()"
      title="Close"
      class="icon-button"
    >
      <svg
        xmlns="http://www.w3.org/2000/svg"
        width="32"
        height="32"
        viewBox="0 0 32 32"
      >
        <path
          fill="currentColor"
          d="M26.29 4.293a1 1 0 1 1 1.414 1.414L17.413 16l10.291 10.29a1 1 0 1 1-1.414 1.414L16 17.413L5.707 27.704a1 1 0 0 1-1.414-1.414L14.585 16L4.293 5.707a1 1 0 0 1 1.414-1.414L16 14.584z"
        ></path>
      </svg>
    </button>
  </div>
  <div class="content">
    <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod
      tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
      veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea
      commodo consequat.
    </p>
    <p>
      Duis aute irure dolor in reprehenderit in voluptate velit esse cillum
      dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
      proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
    </p>
    <p>
      Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium
      doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo
      inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
    </p>
  </div>
  <div class="footer" slot="footer">
    <button
      commandfor="drawer-block-start"
      command="close"
      class="button small"
    >
      Close
    </button>
  </div>
</dialog>
<dialog
  closedby="any"
  class="drawer block-end scroll-lock"
  id="drawer-block-end"
>
  <div class="header" slot="header">
    <span>Block End</span
    ><button
      onclick="this.closest('dialog').close()"
      title="Close"
      class="icon-button"
    >
      <svg
        xmlns="http://www.w3.org/2000/svg"
        width="32"
        height="32"
        viewBox="0 0 32 32"
      >
        <path
          fill="currentColor"
          d="M26.29 4.293a1 1 0 1 1 1.414 1.414L17.413 16l10.291 10.29a1 1 0 1 1-1.414 1.414L16 17.413L5.707 27.704a1 1 0 0 1-1.414-1.414L14.585 16L4.293 5.707a1 1 0 0 1 1.414-1.414L16 14.584z"
        ></path>
      </svg>
    </button>
  </div>
  <div class="content">
    <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod
      tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
      veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea
      commodo consequat.
    </p>
    <p>
      Duis aute irure dolor in reprehenderit in voluptate velit esse cillum
      dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
      proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
    </p>
    <p>
      Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium
      doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo
      inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
    </p>
  </div>
  <div class="footer" slot="footer">
    <button commandfor="drawer-block-end" command="close" class="button small">
      Close
    </button>
  </div>
</dialog>

How to close a drawer

Use the closedby prop to control the closing behavior.

Prop	Description
`closedby="any"`	Click anywhere outside of the drawer to close it.
`closedby="closerequest"`	Device-specific way to close, ex: `Esc` on desktop, back button on mobile, and whatever dismiss action assistive tools use.
`closedby="none"`	You have to handroll a closing solution yourself.

Accessibility

The autofocus attribute should be added to the element the user is expected to interact with immediately upon opening a modal dialog. If no other element involves more immediate interaction, it is recommended to add autofocus to the close button inside the dialog, or the dialog itself if the user is expected to click/activate it to dismiss.
Do not add the tabindex property to the <dialog> element as it is not interactive and does not receive focus. The dialog's contents, including the close button contained in the dialog, can receive focus and be interactive.

Source: MDN

Role & attributes

Role/attribute	Usage
`role="dialog"`	Identifies the element that serves as the drawer container.
`aria-labelledby="IDREF"`	Gives the drawer an accessible name by referring to the element that provides the drawer title.
`aria-describedby="IDREF"`	Gives the drawer an accessible description by referring to the drawer content that describes the primary message or purpose of the drawer.
`aria-modal="true"`	Tells assistive technologies that the windows underneath the current drawer are not available for interaction (inert).

Keyboard support

Key	Function
`Tab`	Moves focus to next focusable element inside the drawer. When focus is on the last focusable element in the drawer, moves focus to the first focusable element in the drawer.
`Shift + Tab`	Moves focus to previous focusable element inside the drawer. When focus is on the first focusable element in the drawer, moves focus to the last focusable element in the drawer.
`Esc`	Closes the drawer.

API

Props

Prop	Type	Default	Description
`id`	`string`	auto-generated	Unique identifier. Defaults to a stable auto-generated id when omitted.
`side`	`"inline-start"`, `"inline-end"`, `"block-start"`, `"block-end"`	`"inline-start"`	The side it opens from.
`backdrop`	`"transparent"`, `"blurred"`	`"blurred"`	The backdrop style.
`scrollLock`	`boolean`	`true`	Whether to lock page scroll.
`class`	`string`	-	Optional CSS class.
`closedby`	`"any"`, `"closerequest"`, `"none"`	`"any"`	How the drawer is closed.

Slots

Slot	-	-	Description
`heading`	-	-	The drawer title.
`default`	-	-	Main content area.
`actions`	-	-	Bottom action area.

actions The bottom actions area, wrapped in a div with an actions class.

Browser support

See also the full browser support guide.

Installation

drawer.css

@layer components.root {
  :where(dialog.drawer) {
    --_backdrop-bg-color: transparent;
    --_backdrop-blur: blur(2px);
    --_bg-color: var(--surface-default);
    --_block-size: min(80vb, 650px);
    --_border-color: var(--border-color);
    --_border-width: var(--border-width);
    --_color: var(--text-primary);
    --_content-padding: var(--size-4);
    --_footer-gap: var(--size-3);
    --_footer-padding: var(--size-3);
    --_header-font-size: var(--font-size-3);
    --_header-padding: var(--size-3);
    --_inline-size: min(375px, 100vi);
    --_shadow: var(--shadow-2);
    --_transition-duration: 0.2s;
    --_transition-timing: var(--ease-out-3);

    background-color: var(--_bg-color);
    border: none;
    box-shadow: var(--_shadow);
    color: var(--_color);
    display: flex;
    flex-direction: column;
    margin: 0;
    max-inline-size: 100%;
    padding: 0;
    position: fixed;
    transition:
      display var(--_transition-duration) allow-discrete,
      overlay var(--_transition-duration) allow-discrete,
      translate var(--_transition-duration) var(--_transition-timing);
    z-index: 1000;

    &::backdrop {
      backdrop-filter: var(--_backdrop-blur);
      background-color: var(--_backdrop-bg-color);
      opacity: 0;
      transition:
        display var(--_transition-duration) allow-discrete,
        overlay var(--_transition-duration) allow-discrete,
        opacity var(--_transition-duration) var(--_transition-timing);
    }

    &.backdrop-transparent {
      --_backdrop-blur: none;
    }

    .header {
      align-items: center;
      border-block-end: var(--_border-width) solid var(--_border-color);
      display: flex;
      padding: var(--_header-padding);

      :where(h1, h2, h3, h4, h5, h6) {
        font-size: var(--_header-font-size);
        margin: 0;
      }

      :where(.icon-button) {
        margin-inline-start: auto;
      }
    }

    .content {
      flex: 1;
      overflow-y: auto;
      padding: var(--_content-padding);
    }

    .footer {
      border-block-start: var(--_border-width) solid var(--_border-color);
      display: flex;
      gap: var(--_footer-gap);
      justify-content: end;
      padding: var(--_footer-padding);
    }

    &.inline-start,
    &.inline-end {
      block-size: 100dvb;
      inline-size: var(--_inline-size);
      inset-block: 0;
      max-block-size: 100%;
    }

    &.inline-start {
      border-inline-end: var(--_border-width) solid var(--_border-color);
      inset-inline-end: auto;
      inset-inline-start: 0;
      translate: -100% 0;
    }

    &.inline-end {
      border-inline-start: var(--_border-width) solid var(--_border-color);
      inset-inline-end: 0;
      inset-inline-start: auto;
      translate: 100% 0;

      .footer {
        justify-content: start;
      }
    }

    &.block-start,
    &.block-end {
      block-size: var(--_block-size);
      inline-size: 100dvi;
      inset-inline: 0;
      max-block-size: 80dvb;
    }

    &.block-start {
      border-block-end: var(--_border-width) solid var(--_border-color);
      inset-block-end: auto;
      inset-block-start: 0;
      translate: 0 -100%;
    }

    &.block-end {
      border-block-start: var(--_border-width) solid var(--_border-color);
      inset-block-end: 0;
      inset-block-start: auto;
      translate: 0 100%;
    }

    &[open] {
      translate: 0 0;

      &::backdrop {
        opacity: 1;
      }

      @starting-style {
        &::backdrop {
          opacity: 0;
        }

        &.inline-start {
          translate: -100% 0;
        }

        &.inline-end {
          translate: 100% 0;
        }

        &.block-start {
          translate: 0 -100%;
        }

        &.block-end {
          translate: 0 100%;
        }
      }
    }
  }

  /* Scroll-lock is provided by the shared `.scroll-lock` utility in core/utils.css.
     This carve-out re-enables page scrolling when a transparent-backdrop drawer is
     open on wide viewports (where the drawer doesn't visually cover the page). */
  html:has(dialog.drawer.scroll-lock[open].backdrop-transparent) {
    overflow: unset;
    overscroll-behavior: auto;

    @media (width < 500px) {
      overflow: clip;
      overscroll-behavior: contain;
    }
  }
}