---
title: "select"
image: "https://adonia.pages.dev/og.png"
version: "next"
---

> Documentation Index
> Fetch the complete documentation index at: https://adonia.pages.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# select

<!-- Generated by `pnpm docs:fields` from packages/core/src/schema/fields/select.ts. Edit the TSDoc, not this file. -->

Dropdown bound to a scalar attribute, or — after `multiple()` — to an
array attribute.

| | |
| --- | --- |
| Builder | `F.select(attribute: string): Select` |
| Wire type key | `select` |
| Class chain | `Select` → `ChoiceField` → `Field` |
| Detail projection | `text-entry` |
| Column counterpart | `text` cell, i.e. `C.text(attribute)` |

::: tip The projection is a per-instance decision
`badge-entry` for a coloured option set, `text-entry` otherwise (protocol §8).
:::

## Example

```ts
import { F } from '@adonia/core'

F.select('status')
  .options([
{ value: 'draft', label: 'Draft', color: 'gray' },
{ value: 'published', label: 'Published', color: 'green' },
  ])
  .required()

F.select('tags').options({ news: 'News', howto: 'How-to' }).multiple().native()
```

## Props

Beyond the shared [field DSL](/reference/fields#the-shared-field-dsl):

| Prop | Declared on | Behaviour |
| --- | --- | --- |
| `multiple(): this` | `Select` | Allows several selections (§7.3 `multiple()`). The form state becomes an array, and §11.1's `vine.enum` is lifted into `vine.array(vine.enum)`. |
| `native(): this` | `Select` | Renders the platform `<select>` instead of the custom listbox (§7.3 `native()`). Purely presentational — validation and state are identical. |
| `options(input: OptionsInput): this` | `ChoiceField` | Declares the static option list (§7.3 `options()`). |

### Introspection

Read-only members this type adds — used by the compiler, the table derivation and
tests rather than by a schema author.

| Member | Declared on | Behaviour |
| --- | --- | --- |
| `get isMultiple(): boolean` | `Select` | Whether this select accepts several values. |
| `get declaredOptions(): readonly FieldOption[]` | `ChoiceField` | The declared static options, in declaration order. |
| `get optionValues(): ChoiceValue[]` | `ChoiceField` | The declared option values — the §11.1 enum members. |
| `get hasColoredOptions(): boolean` | `ChoiceField` | Whether any declared option carries a colour. The single input to the `badge-entry`/`badge` projection decision (protocol §8, §7.5). |
| `get displayType(): string` | `ChoiceField` | `badge-entry` for a coloured option set, `text-entry` otherwise (protocol §8). |
| `get columnType(): string \| undefined` | `ChoiceField` | `badge` cell for a coloured option set, `text` otherwise (§7.5). |
| `detailProps(): JsonObject` | `ChoiceField` | Chrome plus the value→presentation maps the chosen entry needs (protocol §8). |

## Validation

Vine base: `vine.string()`, `vine.enum(this.optionValues)`.

§11.1 mapping: `vine.enum(options)`, or `vine.array(vine.enum(options))`
when `multiple()`. Selection COUNT bounds are `F.checkboxList`'s
`minSelected`/`maxSelected`; a select constrains membership only.

Contributed by `Select.vineSchema()` in `packages/core/src/schema/fields/select.ts`. The shared modifiers (`required`, `nullable`, `requiredWhen`, `unique`, optionality) are applied on top by `Field.buildValidation`, and a `rules()` override replaces the base entirely — the validator compiler never branches on the field class.

## Declared in

- `packages/core/src/schema/fields/select.ts` — `Select`
- `packages/core/src/schema/fields/choice.ts` — `ChoiceField`

Source: https://adonia.pages.dev/reference/fields/select/index.mdx