Skip to content

Checkbox 多选框

常用的多选框组件。

实现原理

基于 MouseRegion、GestureDetector、Container、Icon、Text 等组件实现交互和样式,支持单选、多选、禁用、自定义颜色、尺寸、全选等多种用法。

基础用法

通过 label 属性设置文本,onChange 监听选中状态变化。

查看代码

自定义样式

通过 fontColorTypeiconColorTypefontCustomColoriconCustomColor 属性自定义文字和图标颜色。

查看代码

尺寸/字体

通过 size 属性设置多选框尺寸,通过 customFontSize 自定义字体大小, customIconSize 自定义图标大小。

查看代码

禁用状态

通过 disabled 属性设置禁用状态。

查看代码

组合/组

通过 ECheckboxGroup 组件实现多选组,value 绑定选中项,onChange 监听变化。

查看代码

边框

通过 border 属性显示边框样式。

查看代码

全选

通过控制 value 实现全选/反选。

查看代码

API

Checkbox 属性

属性名说明类型默认值
label选项文本String?-
value当前选中状态bool?-
checked初始选中状态boolfalse
disabled是否禁用boolfalse
border是否显示边框boolfalse
size尺寸ESizeItemmedium
fontColorType文字颜色类型EColorTypeprimary
fontCustomColor自定义文字颜色Color?-
iconColorType图标颜色类型EColorTypeprimary
iconCustomColor自定义图标颜色Color?-
customFontSize自定义字体大小double?-
customIconSize自定义图标大小double?-

Checkbox 事件

事件名说明参数
onChange状态变化时触发bool value

CheckboxGroup 属性

属性名说明类型默认值
value选中项List<String>-
size尺寸ESizeItemmedium
disabled是否禁用boolfalse
children子组件List<Widget>[]

CheckboxGroup 事件

事件名说明参数
onChange选中项变化时触发List<String>

基于 MIT 协议发布