Skip to main content
← All Demos

Dialog

Dialog displays important content in a layer above the page for confirmations, edits, or focused tasks.

1. Basic Modal Dialog

Modal dialog traps focus inside. Escape closes it. Focus returns to the trigger. Title and description are linked via aria-labelledby and aria-describedby.

Keyboard: Enter/Space to open → Tab cycles within dialog → Escape to close → Focus returns to trigger
<Dialog.Root>
  <Dialog.Trigger>Open Modal Dialog</Dialog.Trigger>
  <Dialog.Overlay />
  <Dialog.Content>
    <Dialog.Title>Confirm Action</Dialog.Title>
    <Dialog.Description>Are you sure you want to proceed?</Dialog.Description>
    <Dialog.Close>Cancel</Dialog.Close>
  </Dialog.Content>
</Dialog.Root>

2. Non-modal Dialog

Non-modal dialog does NOT trap focus. Background content remains interactive. Uses modal={false}.

Expected: Tab can leave the dialog to page content.
<Dialog.Root modal={false}>
  <Dialog.Trigger>Open Non-modal Dialog</Dialog.Trigger>
  <Dialog.Content>
    <Dialog.Title>Info Panel</Dialog.Title>
    <Dialog.Description>Background stays interactive.</Dialog.Description>
    <Dialog.Close>Close</Dialog.Close>
  </Dialog.Content>
</Dialog.Root>

3. Controlled Dialog

Parent manages open state. Can be opened/closed programmatically.

const [open, setOpen] = useState(false);

<Dialog.Root open={open} onOpenChange={(o)=>setOpen(o)}>
  <Dialog.Trigger>Open Controlled Dialog</Dialog.Trigger>
  <Dialog.Overlay />
  <Dialog.Content>
    <Dialog.Title>Controlled Dialog</Dialog.Title>
    <Dialog.Close>Close</Dialog.Close>
  </Dialog.Content>
</Dialog.Root>

4. Dialog with Interactive Form

Dialog containing form elements. Focus should move to the first focusable element. Tab order stays within the dialog.

Focus test: Tab should cycle through Name → Email → Bio → Cancel → Save → back to Name
<Dialog.Root>
  <Dialog.Trigger>Edit Profile</Dialog.Trigger>
  <Dialog.Overlay />
  <Dialog.Content>
    <Dialog.Title>Edit Profile</Dialog.Title>
    <input type='text' placeholder='Your name' />
    <input type='email' placeholder='your@email.com' />
    <Dialog.Close>Save</Dialog.Close>
  </Dialog.Content>
</Dialog.Root>

5. Disabled Trigger

Dialog trigger can be disabled to prevent opening.

<Dialog.Root disabled>
  <Dialog.Trigger>Disabled Trigger</Dialog.Trigger>
  <Dialog.Overlay />
  <Dialog.Content>
    <Dialog.Title>Should not open</Dialog.Title>
  </Dialog.Content>
</Dialog.Root>

6. Render Props Pattern

Trigger exposes render props to show open/close state.

<Dialog.Root>
  <Dialog.Trigger>
    {({ isOpen }) => (isOpen ? 'Close dialog' : 'Open dialog')}
  </Dialog.Trigger>
  <Dialog.Overlay />
  <Dialog.Content>
    <Dialog.Title>Render Props Demo</Dialog.Title>
    <Dialog.Close>Close</Dialog.Close>
  </Dialog.Content>
</Dialog.Root>
← All Demos