Skip to main content
The Dialog component displays content in a modal overlay, with backdrop dimming and smooth animations.

Installation

Usage

Components

Dialog (Root)

boolean
Controlled open state.
boolean
Default open state for uncontrolled usage.
function
Callback when open state changes.

DialogTrigger

string
Additional CSS classes.
The trigger element that opens the dialog when clicked.

DialogBackdrop

string
Additional CSS classes.
The backdrop overlay with blur effect.

DialogPopup

string
Additional CSS classes.
The dialog content container with border, shadow, and animations.

DialogTitle

string
Additional CSS classes.
Required for accessibility - provides the dialog’s accessible name.

DialogDescription

string
Additional CSS classes.
Provides the dialog’s accessible description.

DialogClose

string
Additional CSS classes.
Closes the dialog when clicked.

DialogFooter

Helper component for footer layout.

Examples

Confirmation Dialog

Controlled Dialog

Accessibility

  • Built on @base-ui/react for ARIA compliance
  • Traps focus within the dialog
  • Closes on Escape key
  • Returns focus to trigger on close
  • Requires DialogTitle for accessible name
  • Backdrop prevents interaction with background