bmates-uiBMates UI
Latest
/Components

Dialog

A modal surface for focused, blocking tasks.

A modal surface for focused, blocking tasks.

Import

import { Dialog, DialogToggle, DialogContent, DialogClose } from 'bmates-ui';

Basic usage

The example below mirrors the primary Storybook composition and can be used as a starting point.

<Dialog>
  <DialogToggle>Open dialog</DialogToggle>
  <DialogContent>
    <h2>Delete project?</h2>
    <p>This action cannot be undone.</p>
    <DialogClose>Cancel</DialogClose>
  </DialogContent>
</Dialog>

Preview

Dialog

Prop previews

The examples below isolate the props that change visual output or interaction.

Hidden close control

Hidden close control

Outside click

Outside click

Component API

Dialog

Root dialog context.

DialogToggle

Opens or closes the dialog.

DialogContent

Modal content surface.

DialogClose

Closes the active dialog.

DialogContent.outEvent

Closes the dialog when its backdrop is clicked.

DialogContent.hideClose

Hides the built-in close button.

DialogContent.maxWidth

Maximum width of the dialog content.

Usage notes

  • Every component in the table is exported from bmates-ui.
  • Unless noted otherwise, a component also accepts the standard props of its underlying HTML element.
  • For application-owned state, use a controlled value and its change handler instead of only a default* prop.