VDS

Select

Dropdown for selecting one option.

Installation

pnpm install @vds-testing/react @vds-testing/styles
pnpm install @vds-testing/elements @vds-testing/styles

See 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

Disabled

Grouped options

Anatomy

  • Select - Native select with shared VDS styles
  • SelectOption - Option helper (React / Astro); use native <option> with Web Components
  • SelectGroup - 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).