Import
import 'package:flutter/widgets.dart';
import 'package:fluttyui/fluttyui.dart' as ui;API Reference
The declarations below match the current FluttyUI source. Types are shown without the optional ui. import prefix.
Combobox
const Combobox({
super.key,
this.size,
required this.options,
required this.onChanged,
this.value,
this.controller,
this.onQueryChanged,
this.focusNode,
this.autofocus = false,
this.readOnly = false,
this.autocorrect = true,
this.textInputAction,
this.textCapitalization = TextCapitalization.none,
this.autofillHints,
this.inputFormatters,
this.onEditingComplete,
this.onSubmitted,
this.placeholder = 'Select or search...',
this.backgroundColor,
this.foregroundColor,
this.placeholderColor,
this.borderColor,
this.focusColor,
this.selectedColor,
this.borderRadius,
this.menuBorderRadius,
this.menuPadding,
this.maxMenuHeight = 280,
this.padding,
this.optionPadding,
this.height,
this.fontSize,
this.optionFontSize,
this.maxOptions = 6,
this.enabled = true,
this.width,
this.optionBuilder,
});| Parameter | Type | Required | Default |
|---|---|---|---|
key | Key? | No | null |
size | ComponentSize? | No | null |
options | List<ComboboxOption<T>> | Yes | — |
onChanged | ValueChanged<T> | Yes | — |
value | T? | No | null |
controller | TextEditingController? | No | null |
onQueryChanged | ValueChanged<String>? | No | null |
focusNode | FocusNode? | No | null |
autofocus | bool | No | false |
readOnly | bool | No | false |
autocorrect | bool | No | true |
textInputAction | TextInputAction? | No | null |
textCapitalization | TextCapitalization | No | TextCapitalization.none |
autofillHints | Iterable<String>? | No | null |
inputFormatters | List<TextInputFormatter>? | No | null |
onEditingComplete | VoidCallback? | No | null |
onSubmitted | ValueChanged<String>? | No | null |
placeholder | String | No | 'Select or search...' |
backgroundColor | Color? | No | null |
foregroundColor | Color? | No | null |
placeholderColor | Color? | No | null |
borderColor | Color? | No | null |
focusColor | Color? | No | null |
selectedColor | Color? | No | null |
borderRadius | double? | No | null |
menuBorderRadius | double? | No | null |
menuPadding | EdgeInsetsGeometry? | No | null |
maxMenuHeight | double | No | 280 |
padding | EdgeInsetsGeometry? | No | null |
optionPadding | EdgeInsetsGeometry? | No | null |
height | double? | No | null |
fontSize | double? | No | null |
optionFontSize | double? | No | null |
maxOptions | int | No | 6 |
enabled | bool | No | true |
width | double? | No | null |
optionBuilder | Widget Function(BuildContext context, ComboboxOption<T> option)? | No | null |
Application Setup
Place components under FluttyApp to provide theme, navigation, localization, and overlay defaults. Use theme tokens for shared appearance settings.
Source
lib/src/widgets/forms/combobox/combobox.dart
This reference is generated from the Combobox declaration in the FluttyUI core checkout. The component catalog lists the other available building blocks.

