ComboboxField
Labelled searchable combobox field — wraps the Combobox primitive cluster with a label, help text, and error state
Interactive-mode
Examples
Default combobox field
Combobox field with help text and error state
Please assign a team member.
API
The element family below can be composed together. Click an element to jump to its properties.
| Element | Purpose |
|---|---|
| ComboboxField | A labelled searchable combobox field chunk. Wraps the Combobox primitive cluster inside a space-y-1.5 envelope with an optional FormLabel, the combobox input and items with filter support, and optional help text. |
ComboboxField
A labelled searchable combobox field chunk. Wraps the Combobox primitive cluster inside a space-y-1.5 envelope with an optional FormLabel, the combobox input and items with filter support, and optional help text.
| Property | Type | Required | Description |
|---|---|---|---|
| Label | string? | Label text rendered above the combobox via FormLabel. Omit to hide the label. | |
| HelpText | string? | Helper text rendered below the combobox. Shown in text-danger-fg when Error is true, otherwise text-muted-foreground. | |
| Error | bool | Applies error styling to the label and help text. Default: false. | |
| Required | bool | Appends a red asterisk to the label via FormLabel. Default: false. | |
| Disabled | bool | Disables the underlying combobox. Default: false. | |
| Id | string | HTML id wired to the label's for attribute. Auto-generated by default. | |
| Value | string? | Currently selected value. Use @bind-Value for two-way binding. | |
| ValueChanged | EventCallback<string?> | Fires when the selected value changes. Part of the @bind-Value pair. | |
| Placeholder | string? | Placeholder text shown in the search input when empty. | |
| Items | IList<ComboboxField.ComboboxFieldItem>? | The list of options to render. Each item has Value and Label properties. Items are filtered by the user's typed text. |