shadcn.io is not affiliated with official shadcn/ui
Command examples · Dialog
Command Dialog with Descriptions for React
A Search Contacts button that opens a command dialog of contact details, each with a muted line naming what it is.
Four contact details, each with a muted second line that says what it is: a job title, Email, Mobile or Location. Add a second line when the labels alone could be mistaken for one another. The Search Contacts button opens the menu in a CommandDialog over the page, and Escape closes it. In React, Base UI handles the keyboard navigation.
Preview
Installation
FAQ
How does this dialog open?
The Search Contacts button sets an open state to true, and CommandDialog takes that state with its change handler, so Escape or a click outside sets it back. The dialog has a visually hidden title and description.
The Command goes straight inside CommandDialog.
How does each contact get a second line?
The name and the detail sit in a div with flex flex-col. The detail is a span with text-muted-foreground text-xs: Software Engineer under John Doe, Email under jane@example.com, Mobile under the phone number, and Location under San Francisco, CA. The search matches the first line only.
What are the icons beside the contacts?
User, Mail, Phone and MapPin, the first child of each CommandItem. They're decorative and hidden from screen readers, and the item centers each one against the two lines.
What appears when nothing matches the search?
CommandEmpty in the list says "No contacts found." It shows only when the search leaves nothing.
How do I run an item from this dialog in React?
These items don't run anything yet.
Pass onSelect to each CommandItem. Close the dialog in the same handler.
How do the keys work in this dialog?
The arrow keys move through the items, Enter runs the highlighted one, and typing filters the list. Escape closes CommandDialog, and focus goes back to the button. CommandInput shows "Search contacts..." until someone types.
Command filters and ranks the items by their text on its own.
Related
- Command with DescriptionsAn inline command menu of contact
- Command Popover with DescriptionsA Search Contacts button that opens a
- Command with BadgesAn inline command menu of components
- Command Dialog Actions MenuA Quick Actions button that opens a
- Items with Descriptions ComboboxA combobox of integrations with a
- Command Dialog with BadgesA Browse Components button that opens a