# Combobox API

> Auto-generated API reference for `Combobox` from @vuetify/v0 (Vuetify0).
> Source of truth: https://0.vuetifyjs.com/api/combobox

## Related

- https://0.vuetifyjs.com/components/forms/combobox
- https://0.vuetifyjs.com/composables/forms/create-combobox
- https://0.vuetifyjs.com/composables/selection/create-selection
- https://0.vuetifyjs.com/composables/system/use-virtual-focus
- https://0.vuetifyjs.com/components/disclosure/popover
- https://0.vuetifyjs.com/components/forms/select

## Combobox.Root

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:combobox"` | no | Namespace for dependency injection |
| `id` | `string \| undefined` | — | no | Unique identifier (auto-generated if not provided) |
| `name` | `string \| undefined` | — | no | Form field name — auto-renders hidden input when provided |
| `form` | `string \| undefined` | — | no | Associate with a form by ID |
| `disabled` | `boolean \| undefined` | `false` | no | Disables the entire combobox |
| `multiple` | `boolean \| undefined` | `false` | no | Enable multi-selection mode |
| `mandatory` | `boolean \| undefined` | `false` | no | Controls mandatory selection behavior: - false (default): No mandatory selection enforcement - true: Prevents deselecting the last selected item |
| `strict` | `boolean \| undefined` | `false` | no | Strict mode: reverts query to selected value on close if no match |
| `error` | `boolean \| undefined` | `false` | no | Manual error state override — forces invalid regardless of error messages |
| `errorMessages` | `any` | — | no | Manual error messages |
| `adapter` | `any` | — | no | Filtering/loading adapter (client-side or server-side) |
| `displayValue` | `((value: unknown) => string) \| undefined` | — | no | Maps selected value to input display text. Defaults to String(value). |
| `modelValue` | `T \| T[] \| undefined` | — | no | — |

### Events

| Name | Type | Description |
|---|---|---|
| `update:model-value` | `[value: T \| T[]]` | — |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `ComboboxRootSlotProps` | — |

## Combobox.Activator

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:combobox"` | no | Namespace for dependency injection |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `ComboboxActivatorSlotProps` | — |

## Combobox.Content

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:combobox"` | no | Namespace for dependency injection |
| `eager` | `boolean \| undefined` | `false` | no | Render content immediately without waiting for first open |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `ComboboxContentSlotProps` | — |

## Combobox.Control

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:combobox"` | no | Namespace for dependency injection |
| `openOn` | `"focus" \| "input" \| undefined` | `"focus"` | no | When to open the dropdown |
| `placeholder` | `string \| undefined` | — | no | Placeholder text |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `ComboboxControlSlotProps` | — |

## Combobox.Cue

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:combobox"` | no | — |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `ComboboxCueSlotProps` | — |

## Combobox.Description

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:combobox"` | no | Namespace for connecting to parent Combobox.Root |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `ComboboxDescriptionSlotProps` | — |

## Combobox.Empty

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:combobox"` | no | Namespace for dependency injection |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `ComboboxEmptySlotProps` | — |

## Combobox.Error

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:combobox"` | no | Namespace for connecting to parent Combobox.Root |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `ComboboxErrorSlotProps` | — |

## Combobox.HiddenInput

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:combobox"` | no | — |

## Combobox.Item

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:combobox"` | no | Namespace for dependency injection |
| `id` | `string \| undefined` | — | no | Unique identifier (auto-generated if not provided) |
| `value` | `V \| undefined` | — | no | Value associated with this option |
| `disabled` | `MaybeRefOrGetter<boolean> \| undefined` | — | no | Disables this specific option |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `ComboboxItemSlotProps<V>` | — |