Copy to clipboard
<Select placeholder="Relevance">
<option value="relevance">Relevance</option>
<option value="popular">Most popular</option>
<option value="price-low">Price Low - High</option>
<option value="price-high">Price High - Low</option>
<option value="newest">Newest first</option>
</Select>
<Select placeholder="Relevance">
<option value="relevance">Relevance</option>
<option value="popular">Most popular</option>
<option value="price-low">Price Low - High</option>
<option value="price-high">Price High - Low</option>
<option value="newest">Newest first</option>
</Select><Select placeholder="Relevance">
<option value="relevance">Relevance</option>
<option value="popular">Most popular</option>
<option value="price-low">Price Low - High</option>
<option value="price-high">Price High - Low</option>
<option value="newest">Newest first</option>
</Select>
Installation
pnpm install @vds-testing/react @vds-testing/stylespnpm install @vds-testing/elements @vds-testing/stylesSee Installation for CSS setup.
Usage
React:
import { Select, SelectOption, SelectGroup } from "@vds-testing/react"<Select placeholder="Relevance">
<SelectOption value="relevance">Relevance</SelectOption>
<SelectOption value="popular">Most popular</SelectOption>
<SelectOption value="price-low">Price Low - High</SelectOption>
<SelectOption value="price-high">Price High - Low</SelectOption>
<SelectOption value="newest">Newest first</SelectOption>
</Select>Web Components:
<script type="module">
import "@vds-testing/elements";
</script>
<vds-select placeholder="Relevance">
<option value="relevance">Relevance</option>
<option value="popular">Most popular</option>
<option value="price-low">Price Low - High</option>
<option value="price-high">Price High - Low</option>
<option value="newest">Newest first</option>
</vds-select>Examples
With label
Copy to clipboard
<div class="grid gap-2 w-[200px]">
<Label for="sort">Sort by</Label>
<Select id="sort" placeholder="Relevance">
<option value="relevance">Relevance</option>
<option value="popular">Most popular</option>
<option value="price-low">Price Low - High</option>
<option value="price-high">Price High - Low</option>
<option value="newest">Newest first</option>
</Select>
</div>
<div class="grid gap-2 w-[200px]">
<Label for="sort">Sort by</Label>
<Select id="sort" placeholder="Relevance">
<option value="relevance">Relevance</option>
<option value="popular">Most popular</option>
<option value="price-low">Price Low - High</option>
<option value="price-high">Price High - Low</option>
<option value="newest">Newest first</option>
</Select>
</div><div class="grid gap-2 w-[200px]">
<Label for="sort">Sort by</Label>
<Select id="sort" placeholder="Relevance">
<option value="relevance">Relevance</option>
<option value="popular">Most popular</option>
<option value="price-low">Price Low - High</option>
<option value="price-high">Price High - Low</option>
<option value="newest">Newest first</option>
</Select>
</div>
Disabled
Copy to clipboard
<Select disabled placeholder="Disabled">
<option value="one">Option One</option>
</Select>
<Select disabled placeholder="Disabled">
<option value="one">Option One</option>
</Select><Select disabled placeholder="Disabled">
<option value="one">Option One</option>
</Select>
Grouped options
Copy to clipboard
<Select placeholder="Select a domain" class="w-[240px]">
<SelectGroup label="Products">
<option value="lexingtonthemes.com">lexingtonthemes.com</option>
<option value="oxbowui.com">oxbowui.com</option>
</SelectGroup>
<SelectGroup label="Tools">
<option value="colorsandfonts.com">colorsandfonts.com</option>
<option value="example.com">example.com</option>
</SelectGroup>
</Select>
<Select placeholder="Select a domain" class="w-[240px]">
<SelectGroup label="Products">
<option value="lexingtonthemes.com">lexingtonthemes.com</option>
<option value="oxbowui.com">oxbowui.com</option>
</SelectGroup>
<SelectGroup label="Tools">
<option value="colorsandfonts.com">colorsandfonts.com</option>
<option value="example.com">example.com</option>
</SelectGroup>
</Select><Select placeholder="Select a domain" class="w-[240px]">
<SelectGroup label="Products">
<option value="lexingtonthemes.com">lexingtonthemes.com</option>
<option value="oxbowui.com">oxbowui.com</option>
</SelectGroup>
<SelectGroup label="Tools">
<option value="colorsandfonts.com">colorsandfonts.com</option>
<option value="example.com">example.com</option>
</SelectGroup>
</Select>
Anatomy
Select- Native select with shared VDS stylesSelectOption- Option helper (React / Astro); use native<option>with Web ComponentsSelectGroup- Optgroup helper for related options
Accessibility
Select is shape-based (bg-background + border) on a light surface, so it uses the shared focus-shape double outline (yellow inside, black outside).
Props
Select
| Prop | Type | Default | Description |
|---|---|---|---|
| id | string | - | Element ID for label association |
| name | string | - | Form field name |
| placeholder | string | - | Placeholder option text |
| disabled | boolean | false | Disables the select |
| required | boolean | false | Makes selection required |
| value | string | - | Controlled value (React); attribute on vds-select |
| class / className | string | - | Additional CSS classes |
SelectGroup
| Prop | Type | Default | Description |
|---|---|---|---|
| label | string | required | Optgroup label |
Web Components use kebab-case attributes on vds-select (placeholder, disabled, required).