Copy to clipboard
No results found.
https://shop.vade.org/
https://www.vade.org/
https://www.vade.org/membership
<Combobox
options={[
{ value: "Vale Shop", label: "https://shop.vade.org/" },
{ value: "Vade.org", label: "https://www.vade.org/" },
{ value: "Vale Membership", label: "https://www.vade.org/membership" },
]}
placeholder="Select a domain"
/>
<Combobox
options={[
{ value: "Vale Shop", label: "https://shop.vade.org/" },
{ value: "Vade.org", label: "https://www.vade.org/" },
{ value: "Vale Membership", label: "https://www.vade.org/membership" },
]}
placeholder="Select a domain"
/><Combobox
options={[
{ value: "Vale Shop", label: "https://shop.vade.org/" },
{ value: "Vade.org", label: "https://www.vade.org/" },
{ value: "Vale Membership", label: "https://www.vade.org/membership" },
]}
placeholder="Select a domain"
/>
Installation
npm install @vds-testing/react @vds-testing/stylesnpm install @vds-testing/elements @vds-testing/stylesSee Installation for CSS setup.
Usage
React:
import { Combobox } from "@vds-testing/react"<Combobox
options={[
{ value: "Vale Shop", label: "https://shop.vade.org/" },
{ value: "Vade.org", label: "https://www.vade.org/" },
]}
placeholder="Select a domain"
/>Web Components:
<script type="module">
import "@vds-testing/elements";
</script>
<vds-combobox
placeholder="Select a domain"
options='[{"value":"lexington","label":"lexingtonthemes.com"},{"value":"colors-fonts","label":"colorsandfonts.com"}]'
></vds-combobox>Examples
Clearable
Copy to clipboard
No results found.
https://shop.vade.org/
https://www.vade.org/
https://www.vade.org/membership
<Combobox
value="colors-fonts"
clearable
options={[
{ value: "Vale Shop", label: "https://shop.vade.org/" },
{ value: "Vade.org", label: "https://www.vade.org/" },
{ value: "Vale Membership", label: "https://www.vade.org/membership" },
]}
placeholder="Select a domain"
/>
<Combobox
value="colors-fonts"
clearable
options={[
{ value: "Vale Shop", label: "https://shop.vade.org/" },
{ value: "Vade.org", label: "https://www.vade.org/" },
{ value: "Vale Membership", label: "https://www.vade.org/membership" },
]}
placeholder="Select a domain"
/><Combobox
value="colors-fonts"
clearable
options={[
{ value: "Vale Shop", label: "https://shop.vade.org/" },
{ value: "Vade.org", label: "https://www.vade.org/" },
{ value: "Vale Membership", label: "https://www.vade.org/membership" },
]}
placeholder="Select a domain"
/>
Grouped options
Copy to clipboard
No results found.
Marketplace
https://shop.vade.org/
https://www.vade.org/
UI
https://www.vade.org/membership
<Combobox
options={[
{
heading: "Marketplace",
options: [
{ value: "Vale Shop", label: "https://shop.vade.org/" },
{ value: "Vade.org", label: "https://www.vade.org/" },
],
},
{
heading: "UI",
options: [
{ value: "Vale Membership", label: "https://www.vade.org/membership" },
],
},
]}
placeholder="Select a domain"
/>
<Combobox
options={[
{
heading: "Marketplace",
options: [
{ value: "Vale Shop", label: "https://shop.vade.org/" },
{ value: "Vade.org", label: "https://www.vade.org/" },
],
},
{
heading: "UI",
options: [
{ value: "Vale Membership", label: "https://www.vade.org/membership" },
],
},
]}
placeholder="Select a domain"
/><Combobox
options={[
{
heading: "Marketplace",
options: [
{ value: "Vale Shop", label: "https://shop.vade.org/" },
{ value: "Vade.org", label: "https://www.vade.org/" },
],
},
{
heading: "UI",
options: [
{ value: "Vale Membership", label: "https://www.vade.org/membership" },
],
},
]}
placeholder="Select a domain"
/>
Rich items
Copy to clipboard
No results found.
New York OfficeEastern Time
NYLondon OfficeGreenwich Mean Time
LDNBerlin OfficeCentral European Time
BERSingapore OfficeSingapore Time
SGTokyo OfficeJapan Standard Time
TYO<Combobox
options={[
{
value: "nyc",
label: "New York Office",
description: "Eastern Time",
meta: "NY",
},
{
value: "london",
label: "London Office",
description: "Greenwich Mean Time",
meta: "LDN",
},
{
value: "tokyo",
label: "Tokyo Office",
description: "Japan Standard Time",
meta: "TYO",
},
]}
placeholder="Search offices..."
/>
<Combobox
options={[
{
value: "nyc",
label: "New York Office",
description: "Eastern Time",
meta: "NY",
},
{
value: "london",
label: "London Office",
description: "Greenwich Mean Time",
meta: "LDN",
},
{
value: "tokyo",
label: "Tokyo Office",
description: "Japan Standard Time",
meta: "TYO",
},
]}
placeholder="Search offices..."
/><Combobox
options={[
{
value: "nyc",
label: "New York Office",
description: "Eastern Time",
meta: "NY",
},
{
value: "london",
label: "London Office",
description: "Greenwich Mean Time",
meta: "LDN",
},
{
value: "tokyo",
label: "Tokyo Office",
description: "Japan Standard Time",
meta: "TYO",
},
]}
placeholder="Search offices..."
/>
Input-group addon
Copy to clipboard
No results found.
(GMT-8) Los Angeles
(GMT-5) New York
(GMT+0) London
(GMT+1) Paris
(GMT+9) Tokyo
<InputGroup class="w-[320px]">
<InputGroupAddon align="inline-start">
<HugeIcon icon={Globe02Icon} size="sm" />
</InputGroupAddon>
<Combobox
inputGroupControl
value="gmt-MinusSignIcon-5"
options={[
{ value: "gmt-MinusSignIcon-8", label: "(GMT-8) Los Angeles" },
{ value: "gmt-MinusSignIcon-5", label: "(GMT-5) New York" },
{ value: "gmt-PlusSignIcon-0", label: "(GMT+0) London" },
{ value: "gmt-PlusSignIcon-9", label: "(GMT+9) Tokyo" },
]}
placeholder="Select a timezone"
/>
</InputGroup>
<InputGroup class="w-[320px]">
<InputGroupAddon align="inline-start">
<HugeIcon icon={Globe02Icon} size="sm" />
</InputGroupAddon>
<Combobox
inputGroupControl
value="gmt-MinusSignIcon-5"
options={[
{ value: "gmt-MinusSignIcon-8", label: "(GMT-8) Los Angeles" },
{ value: "gmt-MinusSignIcon-5", label: "(GMT-5) New York" },
{ value: "gmt-PlusSignIcon-0", label: "(GMT+0) London" },
{ value: "gmt-PlusSignIcon-9", label: "(GMT+9) Tokyo" },
]}
placeholder="Select a timezone"
/>
</InputGroup><InputGroup class="w-[320px]">
<InputGroupAddon align="inline-start">
<HugeIcon icon={Globe02Icon} size="sm" />
</InputGroupAddon>
<Combobox
inputGroupControl
value="gmt-MinusSignIcon-5"
options={[
{ value: "gmt-MinusSignIcon-8", label: "(GMT-8) Los Angeles" },
{ value: "gmt-MinusSignIcon-5", label: "(GMT-5) New York" },
{ value: "gmt-PlusSignIcon-0", label: "(GMT+0) London" },
{ value: "gmt-PlusSignIcon-9", label: "(GMT+9) Tokyo" },
]}
placeholder="Select a timezone"
/>
</InputGroup>
Anatomy
Combobox- Root searchable select component.ComboboxTrigger- Trigger button for opening the options list.ComboboxContent- Popover content container.ComboboxItem- Selectable option row.
Props
Combobox
| Prop | Type | Default | Description |
|---|---|---|---|
| options | ComboboxOption[] | ComboboxGroup[] |
[] | Flat options or grouped options |
| value | string | “” | Initial selected value |
| name | string | - | Hidden input name for form submissions |
| placeholder | string | “Select an option” | Trigger placeholder text |
| searchPlaceholder | string | “Search…” | Search input placeholder |
| emptyMessage | string | “No results found.” | Empty state label |
| disabled | boolean | false | Disables trigger and selection |
| clearable | boolean | false | Shows clear action when a value is selected |
| inputGroupControl | boolean | false | Adapts trigger for InputGroup composition |
| class | string | - | Additional CSS classes |
| onValueChange | (detail: { value, label }) => void |
- | React only. Astro/elements emit combobox-change. |
Web Components pass options as a JSON string attribute. Kebab-case attrs: search-placeholder, empty-message, input-group-control.
Events
combobox-change- Emitted on selection with{ value, label }detail.