Skip to content
shadcn.io

shadcn.io is not affiliated with official shadcn/ui

Command examples · Dialog

Command Dialog with Badges for React

A Browse Components button that opens a command dialog where each component carries a Stable or Beta badge.

Framework
UI library

Four components, each tagged Stable or Beta with a Badge at the end of its row. Use a badge when people should know an item's state before they pick it, and keep its text to a word. The Browse Components button opens the menu in a CommandDialog over the page, and Escape closes it. In React, Base UI handles the keyboard navigation.

Preview

Preview width

Installation

Sign in to get your install command
Free with an account. It carries your token, so the CLI installs everything in one go.

FAQ

How does this dialog open?

The Browse Components 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 Stable or Beta sit at the end of the row?

The name's span has flex-1, so it fills the row and pushes the Badge to the end. Button and Input read Stable with variant="secondary", and Table and DataGrid read Beta with variant="outline". The status and the variant sit in the data beside each name.

Which icon goes with each component?

FileText is Button, Code is Input, Database is Table, and Package is DataGrid. The icon is the first child of CommandItem and is hidden from screen readers, since the name says the same thing.

What appears when nothing matches the search?

CommandEmpty in the list says "No components 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 components..." until someone types. Command filters and ranks the items by their text on its own.