Skip to content

Select 选择器

用于在多个选项中选择单个或多个值。

实现原理

基于 Dropdown、ListView、Text、Icon 等组件实现,支持单选、多选、禁用、可清空、自定义头部、前后缀等功能。

基础用法

使用 valueoptionsonChanged 属性实现基本的选择功能。

查看代码

单选和多选

通过 multiple 属性切换单选和多选,单选时 valueString?,多选时为 List<String>?

查看代码

禁用状态

使用 disabled 属性禁用选择器。

查看代码

可清空

使用 clearable 属性启用清空功能。

查看代码

前缀/后缀/插槽

通过 prefixsuffixprependappend 属性自定义前缀、后缀和插槽内容。

查看代码

有禁用选项

SelectOption 支持 disabled 字段,可设置部分选项不可选。

查看代码

自定义头部

通过 header 属性自定义下拉面板头部内容。

查看代码

API 调用

支持 onChangedonClear 等事件。

查看代码

API

Select 属性

属性名说明类型默认值
value当前选中值(单选/多选)String?/List<String>?-
options选项列表List<SelectOption>-
placeholder占位符文本String?"请选择"
size选择器尺寸ESizeItemESizeItem.medium
customHeight自定义高度double?-
customFontSize自定义字体大小double?-
customBorderRadius自定义圆角double?-
multiple是否多选boolfalse
disabled是否禁用boolfalse
clearable是否可清空boolfalse
prefix前缀Widget?-
suffix后缀(可替换默认箭头)Widget?-
prepend头部插槽Widget?-
append尾部插槽Widget?-
header自定义下拉面板头部Widget?-
onChanged选中值变化时回调Function(dynamic)-
onClear清空时回调VoidCallback?-

SelectOption 属性

属性名说明类型默认值
value选项值String-
label选项文本String-
disabled是否禁用boolfalse

Select 事件

事件名说明参数
onChanged选中值变化时dynamic
onClear清空时触发-

</rewritten_file>

基于 MIT 协议发布