Dialog displays important content in a layer above the page for confirmations, edits, or focused tasks.
Modal dialog traps focus inside. Escape closes it. Focus returns to the trigger. Title and description are linked via aria-labelledby and aria-describedby.
<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>Non-modal dialog does NOT trap focus. Background content remains interactive. Uses modal={false}.
<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>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>Dialog containing form elements. Focus should move to the first focusable element. Tab order stays within the dialog.
<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>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>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>