shadcn.io is an independent project built on shadcn/ui
English is selected from the first render. The button shows English, and the list marks that row. The other languages are still there to search.
Use it for a setting with a sensible default, or to show a value saved earlier. A field that must start empty is a Select with a placeholder. In React, Ark UI shows that initial value on the button.
Installation
Anatomy
Usage
<Combobox
collection={collection}
onInputValueChange={handleInputValueChange}
onValueChange={handleValueChange}
positioning={{ getAnchorElement: () => triggerRef.current }}
selectionBehavior="clear"
value={value}
>
<ComboboxTrigger
className={cn(
buttonVariants({ variant: "outline" }),
"w-[200px] justify-between"
)}
ref={triggerRef}
>
{selected ? selected.label : "Select language..."}
</ComboboxTrigger>
<ComboboxContent>
<ComboboxInput
className="w-full"
placeholder="Search language..."
showTrigger={false}
/>
<ComboboxEmpty>No language found.</ComboboxEmpty>
<ComboboxList>
{collection.items.map((item) => (
<ComboboxItem item={item} key={item.value}>
{item.label}
</ComboboxItem>
))}
</ComboboxList>
{/* The rest of the file is under Installation. */}FAQ
How is English selected on first render?
The demo holds the value and starts it at ["en"]. The value is an array of item values.
Can it be changed afterwards?
Yes. The default is only the starting point. Picking another language replaces it.
Which languages are in the list?
English, Spanish, French, German and Italian. The search box says Search language..., and No language found. shows when nothing matches.
How is English marked when the list opens?
ComboboxItem shows its check on the selected row, so English has it until another language is picked.
API Reference
Combobox
Sets collection={collection}, onInputValueChange={handleInputValueChange}, onValueChange={handleValueChange}, positioning, getAnchorElement and cn. The rest is on the Combobox page.
