Combobox
Windowed List
A combobox for a directory of hundreds of rows: only a window of the first matches is rendered, with an honest "showing N of M" line and a coverage bar below.
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 directory content through options and the window size through visibleLimit
- the counter hint through hintLabel and the counter itself through countText: {shown} and {total} are filled with numbers
- the field caption through label and the placeholder through placeholder
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-007?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
<Combobox007
label="Part number"
options={catalog}
visibleLimit={40}
onSelect={(value) => console.log(value)}
/>A sample call. The agent installs the component itself from the registry via the “Copy for AI” link.
Settings
- Window size
visibleLimit· default: 40- Counter hint
hintLabel· default: narrow the query- Accent
accent· default: theme colour- Background
background· default: theme colour
More in Combobox
FAQ
- How do I add Windowed List 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 Windowed List depend on?
- No npm packages beyond React and Tailwind CSS.
- What can I change in Windowed List?
- Adapt: the directory content through options and the window size through visibleLimit; the counter hint through hintLabel and the counter itself through countText: {shown} and {total} are filled with numbers; the field caption through label and the placeholder through placeholder. Keep as installed: the local --vibeui-combobox-007-* palette — do not swap it for your theme tokens; the cut to visibleLimit: hundreds of rows in the DOM slow scrolling and bloat the accessibility tree; the "showing N of M" line — without it people assume there are only forty matches and stop searching.
- Is Windowed List 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-007.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-007-* palette. Client component: useMemo filters the list and cuts it to visibleLimit, while useState holds the query, the value and the cursor. No more than visibleLimit rows reach the DOM — a cheap substitute for virtualisation with no external library and no height measurement. The "showing N of M" caption lies in an aria-live="polite" region and is linked to the field through aria-describedby: it explains why the one being looked for is not on screen. The bar under the list shows the share that is displayed and carries no text, hence aria-hidden. The keyboard adds PageDown and PageUp — a jump of ten rows, without which a long list cannot be paged through.
Tags
- combobox
- long list
- window
- performance
Component source
The same file your agent installs. Here in case you would rather copy it by hand.
Loading…