ReferenceComponentsForms and controls
Select
Select component API, behavior, and executable example.
Loading executable example…
API and events
Connect semantic terminal controls to typed form state, validation, descriptions, errors, hints, and submission.
export function Select<T extends string>({
options,
value,
defaultValue,
onValueChange,
field: adaptedField,
validators,
onBlur,
open,
defaultOpen = false,
onOpenChange,
placeholder = "Select…",
searchable = false,
autoFocus,
slots,
slotProps,
disabled = false,
readOnly = false,
...props
}: SelectProps<T>): ReactNode;Props, functions, and events
| Member | Type | Required | Description | Related types |
|---|---|---|---|---|
value | T | undefined | No | The value member uses the T | undefined contract. | — |
defaultValue | T | undefined | No | The defaultValue member uses the T | undefined contract. | — |
onValueChange | ((value: T) => void | Promise<void>) | undefined | No | The onValueChange member uses the ((value: T) => void | Promise<void>) | undefined contract. | — |
field | AdaptedTanStackField<T | undefined> | undefined | No | The field member uses the AdaptedTanStackField<T | undefined> | undefined contract. | AdaptedTanStackField |
validators | FieldValidators<T | undefined> | undefined | No | The validators member uses the FieldValidators<T | undefined> | undefined contract. | FieldValidators |
onBlur | (() => void | Promise<void>) | undefined | No | The onBlur member uses the (() => void | Promise<void>) | undefined contract. | — |
open | boolean | undefined | No | The open member uses the boolean | undefined contract. | — |
defaultOpen | boolean | undefined | No | The defaultOpen member uses the boolean | undefined contract. | — |
onOpenChange | ((open: boolean) => void | Promise<void>) | undefined | No | The onOpenChange member uses the ((open: boolean) => void | Promise<void>) | undefined contract. | — |
options | readonly SelectOption<T>[] | Yes | The options member uses the readonly SelectOption<T>[] contract. | — |
placeholder | string | undefined | No | The placeholder member uses the string | undefined contract. | — |
searchable | boolean | undefined | No | The searchable member uses the boolean | undefined contract. | — |
autoFocus | boolean | undefined | No | The autoFocus member uses the boolean | undefined contract. | — |
variant | string | undefined | No | The variant member uses the string | undefined contract. | — |
size | "sm" | "md" | "lg" | undefined | No | The size member uses the "sm" | "md" | "lg" | undefined contract. | — |
unstyled | boolean | undefined | No | The unstyled member uses the boolean | undefined contract. | — |
className | string | undefined | No | The className member uses the string | undefined contract. | — |
layout | Partial<Omit<LayoutNodeInput, "id" | "children" | "semantics">> | undefined | No | The layout member uses the Partial<Omit<LayoutNodeInput, "id" | "children" | "semantics">> | undefined contract. | — |
id | string | undefined | No | The id member uses the string | undefined contract. | — |
testId | string | undefined | No | The testId member uses the string | undefined contract. | — |
role | SemanticRole | undefined | No | The role member uses the SemanticRole | undefined contract. | SemanticRole |
label | string | undefined | No | The label member uses the string | undefined contract. | — |
description | string | undefined | No | The description member uses the string | undefined contract. | — |
disabled | boolean | undefined | No | The disabled member uses the boolean | undefined contract. | — |
readOnly | boolean | undefined | No | The readOnly member uses the boolean | undefined contract. | — |
selected | boolean | undefined | No | The selected member uses the boolean | undefined contract. | — |
checked | boolean | undefined | No | The checked member uses the boolean | undefined contract. | — |
expanded | boolean | undefined | No | The expanded member uses the boolean | undefined contract. | — |
valueText | string | undefined | No | The valueText member uses the string | undefined contract. | — |
slots | Partial<SlotComponents<{ root: import("ink").BoxProps; indicator: import("ink").TextProps; list: import("ink").BoxProps; option: import("ink").TextProps; empty: import("ink").TextProps; }>> | undefined | No | The slots member uses the Partial<SlotComponents<{ root: import("ink").BoxProps; indicator: import("ink").TextProps; list: import("ink").BoxProps; option: import("ink").TextProps; empty: import("ink").TextProps; }>> | undefined contract. | BoxProps, SlotComponents, TextProps |
slotProps | Partial<SlotProps<{ root: import("ink").BoxProps; indicator: import("ink").TextProps; list: import("ink").BoxProps; option: import("ink").TextProps; empty: import("ink").TextProps; }, object>> | undefined | No | The slotProps member uses the Partial<SlotProps<{ root: import("ink").BoxProps; indicator: import("ink").TextProps; list: import("ink").BoxProps; option: import("ink").TextProps; empty: import("ink").TextProps; }, object>> | undefined contract. | BoxProps, SlotProps, TextProps |
Controls expose onValueChange, onSubmit, focus, selection, and validation callbacks.
Callback props run after the documented input is accepted. Callbacks are not cancellable unless their return type or description states otherwise.
Interaction and capabilities
Text controls edit directly; choice controls use arrows and Space or Enter; Form coordinates validation and submission.
The published manifest records keyboard, focus, pointer, theme, terminal, semantic, event, and dependency requirements.
Complete import
import { Select } from "@/components/tuil/forms/controls";