Combobox
Filter Combobox
A basic combobox: the trigger shows the selection, the panel holds a filter field and the list, and the value can only come from the list.
React + Tailwind, shadcn-compatible: press “Copy for AI” and your Cursor or Claude Code agent installs it with the shadcn CLI.
What you can change
- the field caption through label and the empty text through placeholder
- the filter hint through searchPlaceholder and the screen-reader name of the filter through filterLabel
- the list content through options, the initial choice through defaultValue and the no-results text through emptyLabel
A link for your AI agent: preview, code and instructions.
Preview

Use it with AI
- 1. Copy the link.
- 2. Write to your agent in your own words and drop the link into the sentence.
- 3. The agent opens the link and installs the component from the registry.
put this on the home page as the hero:
https://vibeui.club/c/combobox-001?lang=en&theme=dark
Not sure where to paste it? Step-by-step guide
Show the full instructions
What the link says, spelled out. Use it when your agent cannot open links — paste this text instead.
Loading…
How to use
<Combobox001
label="Task status"
placeholder="Pick a status"
options={["Active", "In progress", "Done"]}
onSelect={(value) => console.log(value)}
/>A sample call. The agent installs the component itself from the registry via the “Copy for AI” link.
Settings
- Caption
label· default: Task status- Placeholder
placeholder· default: Pick a status- Panel open
defaultOpen· default: off- Accent
accent· default: theme colour- Background
background· default: theme colour
More in Combobox
FAQ
- How do I add Filter Combobox with Cursor or Claude Code?
- Press “Copy for AI” on this page and paste it into your agent's chat. The instruction contains the shadcn CLI install command, the dependencies and what to keep, so the agent installs this exact component instead of recreating a lookalike.
- What does Filter Combobox depend on?
- No npm packages beyond React and Tailwind CSS.
- What can I change in Filter Combobox?
- Adapt: the field caption through label and the empty text through placeholder; the filter hint through searchPlaceholder and the screen-reader name of the filter through filterLabel; the list content through options, the initial choice through defaultValue and the no-results text through emptyLabel. Keep as installed: the local --vibeui-combobox-001-* palette — do not swap it for your theme tokens; the split between filter and value: the text in the field must not reach the form, otherwise it is free input, not a choice from a list; the role="combobox" + aria-controls + aria-activedescendant chain: without it a screen reader never announces the row under the cursor.
- Is Filter Combobox free?
- Yes. The preview is open without an account; with a free account you can copy up to 20 components a month.
For developers
npx shadcn@latest add https://vibeui.club/r/pro/combobox-001.jsonThis command needs a signed link: sign in and open “Component source” below — it issues a working link valid for 30 minutes. All install options
Technical notes
The component is self-contained: one file, no dependencies, its own palette in the local --vibeui-combobox-001-* variables. Client component: useState holds the value, the query, the open state and the cursor index, and useEffect moves focus into the filter field on opening. The trigger button carries aria-haspopup="listbox" and aria-expanded, the field inside the panel is a role="combobox" with aria-controls and aria-activedescendant, and the list is a role="listbox" with role="option" rows and aria-selected. Keyboard: the arrows move the cursor in a loop, Home and End jump to the edges, Enter selects, Escape closes the panel and returns focus to the button. The panel lies in the flow rather than on top: a floating layer in a narrow column has nothing to position it against without measurement. Mouse selection goes through onMouseDown with preventDefault, so that the field does not lose focus before the selection.
Tags
- combobox
- filter
- keyboard
- a11y
Component source
The same file your agent installs. Here in case you would rather copy it by hand.
Loading…