# Select

Single select with native label, description, and error associations that optionally switches to a searchable combobox.

Use Select for one value from a list when showing every option at once would take too much space. Give it a visible label or an aria-label.

## API

The package declarations define these public members.

### Inherited prop contracts

- `Pick<HTMLButtonAttributes, "id" | "aria-describedby" | "aria-invalid" | "aria-label" | "aria-labelledby">` — Only the listed props from this native base are accepted.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `disabled` | `boolean` | prop | No | `false` | No additional description. |
| `emptyText` | `string` | prop | No | `'No results'` | Shown in place of the list when there is nothing to pick. |
| `error` | `string` | prop | No | `undefined` | Error message; also marks the active control invalid. |
| `hint` | `string` | prop | No | `undefined` | Helper text associated with the active control. |
| `label` | `string` | prop | No | `undefined` | Visible label associated with the active control. |
| `onValueChange` | `(value: T) => void` | callback | No | `undefined` | Fired whenever the selected value changes (alongside the bindable `value`). |
| `optionLabel` | `(value: T) => string` | callback | No | `undefined` | Resolve a display label from an option value, including reactive or localized labels. |
| `options` | `readonly T[] \| readonly SelectOption<T>[]` | prop | Yes | - | Either bare values or `{ value, label }` pairs. |
| `placeholder` | `string` | prop | No | `undefined` | Placeholder shown when nothing is selected. |
| `searchable` | `boolean` | prop | No | `false` | Render a filterable combobox instead of a plain select. |
| `value` | `T` | binding | No | `undefined as T | undefined` | The selected value. Two-way bindable. |

## Related

- [Label](/docs/components/label): Visible form label with required-state treatment.
- [Input](/docs/components/input): Single-line field with internal or external labeling, hint, error, icons, and password reveal.
- [Switch](/docs/components/switch): Bindable binary switch with visible or aria-only labeling.