Combobox
Grouped Sections
A combobox with sections: group headings label the rows, empty groups disappear while filtering, and the arrow keys step straight past the headings.
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 sections and their rows through groups
- the field caption through label and the empty text through placeholder
- the empty-result 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-002?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
<Combobox002
label="Section"
placeholder="Find a section"
groups={[{ label: "Sales", options: ["New deal", "Client list"] }]}
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: Section- Placeholder
placeholder· default: Find a section- Accent
accent· default: theme colour- Background
background· default: theme colour
More in Combobox
FAQ
- How do I add Grouped Sections 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 Grouped Sections depend on?
- No npm packages beyond React and Tailwind CSS.
- What can I change in Grouped Sections?
- Adapt: the sections and their rows through groups; the field caption through label and the empty text through placeholder; the empty-result text through emptyLabel. Keep as installed: the local --vibeui-combobox-002-* palette — do not swap it for your theme tokens; the flat row numbering: the cursor index is counted over the flattened list, otherwise aria-activedescendant points at the wrong row; role="presentation" on the group heading — a heading with the option role breaks both the arrows and the "row N of M" count.
- Is Grouped Sections 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-002.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 --vibeui-combobox-002-* palette. Client component: useState holds the query, the value and the cursor index, and useMemo rebuilds the groups and the flat row order. The markup is nested: an outer ul with role="listbox", inside it li elements with role="presentation" holding a ul with role="group" and an aria-labelledby pointing at the heading. A group heading is an li with role="presentation", so it does not count towards the rows and the arrows jump over it; the option numbering is continuous and aria-activedescendant rests on it. The counter beside a heading shows how many rows are left in the section after filtering. A group with no matches is dropped entirely: an empty heading misleads more than its absence.
Tags
- combobox
- groups
- sections
- keyboard
Component source
The same file your agent installs. Here in case you would rather copy it by hand.
Loading…