---
url: "https://vueda.dev/v3/reference/api/vue/Select.md"
title: "Select"
---

# Select

## Overview

Root of a Select widget. Wrap with SelectTrigger and SelectContent.

## Props

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| <span id="prop-modelValue">modelValue</span> | `string\|number\|boolean\|object\|array` |  | `undefined` | The controlled value. Can be bound with v-model. |
| <span id="prop-defaultValue">defaultValue</span> | `string\|number\|boolean\|object\|array` |  | `undefined` | Initial value when uncontrolled. |
| <span id="prop-open">open</span> | `boolean` |  | `undefined` | The controlled open state. Can be bound with v-model:open. |
| <span id="prop-defaultOpen">defaultOpen</span> | `boolean` |  | `undefined` | Initial open state when uncontrolled. |
| <span id="prop-by">by</span> | `string\|func` |  | `undefined` | Field for object comparison, or a custom comparison function. |
| <span id="prop-dir">dir</span> | `string` |  | `undefined` | Reading direction. |
| <span id="prop-multiple">multiple</span> | `boolean` |  | `undefined` | Whether multiple options can be selected. |
| <span id="prop-autocomplete">autocomplete</span> | `string` |  | `undefined` | Native autocomplete attribute. |
| <span id="prop-disabled">disabled</span> | `boolean` |  | `undefined` | When true, prevents user interaction. |
| <span id="prop-name">name</span> | `string` |  | `undefined` | Name for form submission. |
| <span id="prop-required">required</span> | `boolean` |  | `undefined` | Whether the field is required. |

## Slots

### `default` {#slot-default}

Scoped slot.

## Events

| Name | Description |
| --- | --- |
| `update:modelValue` | Emitted when the value changes. |
| `update:open` | Emitted when the open state changes. |

[Full event reference](/v3/reference/api/vue/Select/events.md)

## Source

`client/lib/controls/select/Select.vue`