Flutter DropdownTextfield
DropdownTextfield 是一个 Material Design 文本框。DropDownButton 是一个我们可以用来从一组值中选择一个唯一值或多个值的控件。
主要特点
- 可搜索下拉框
- 单选和多选
- Material 下拉框
- 易于定制的 UI
- 在 StatelessWidget 中轻松实现
- 多选下拉项的工具提示对话框。
示例
| 单选下拉框 | 带搜索选项的单选下拉框 | 带清除选项的单选下拉框 |
 |
 |
 |
| 多选下拉框 | 已选所有项目的多选下拉框 |
 |
 |
控制器
单选和多选下拉控制器，必须是 SingleValueDropDownController 或 MultiValueDropDownController 类型。
dropdownRadius
定义下拉列表的半径，默认为 12
initialValue
初始值，如果值为 null 或在 dropDownList 中不存在，则不显示该值。
dropDownList
下拉列表，下拉值列表
onChanged
它将监听并返回从下拉列表中选择的项目的返回值。对于单选下拉框，它将返回一个 Single DropDownValueModel 对象；对于多选下拉框，它将返回一个 DropDownValueModel 对象列表。
textFieldDecoration
覆盖默认文本框装饰
dropDownIconProperty
自定义下拉图标的大小和颜色
isEnabled
isEnabled=false 可禁用文本框，默认值为 true
enableSearch
enableSearch=true 可在下拉框中启用搜索选项，目前此功能仅对单选下拉框启用
displayCompleteItem
如果希望在文本框中显示所有选定项目的完整列表，请设置 displayCompleteItem=true，否则将显示“已选项目数 item selected”
dropDownItemCount
显示的最大下拉项数量，默认为 6
searchKeyboardType
覆盖默认搜索键盘类型，仅当 enableSearch=true 时适用。
searchAutofocus
searchAutofocus=true 可自动对焦搜索文本框，仅当 enableSearch=true 时适用，默认为 false
searchShowCursor
searchShowCursor=false 可隐藏搜索文本框的光标，仅当 enableSearch=true 时适用。
clearOption
clearOption=false 可隐藏文本框中的清除后缀图标按钮。
clearIconProperty
自定义清除图标的大小和颜色
listSpace
文本框和列表之间的间距，默认为 0
listPadding
下拉列表项的填充
submitButtonText
多选下拉框提交按钮文本
submitButtonColor
多选下拉框提交按钮颜色
submitButtonTextStyle
多选下拉框提交按钮文本样式
listTextStyle
下拉列表项文本样式
checkBoxProperty
自定义多选复选框属性
dropdownColor
自定义下拉覆盖颜色
