Skip to content

Radio 单选框

在一组备选项中进行单选。

实现原理

使用 MouseRegion 嵌套 GestureDetector、Container、Text 等组件实现单选功能,通过 InheritedWidget 实现 RadioGroup 的状态共享。

基础用法

使用 valuelabel 属性来定义单选框的值和标签。

查看代码

禁用状态

使用 disabled 属性来控制单选框是否为禁用状态。

查看代码

单选框组

结合 ERadioGroupERadio 组件组合使用实现单选框组。

查看代码

不同尺寸

使用 size 属性来定义单选框的尺寸, 也可以通过 customFontSize 属性来定义单选框的文字大小。

查看代码

带边框

设置 border 属性为 true 可以渲染为带有边框的单选框。

查看代码

API

Radio 属性

customFontSize 和 fontColorType 等属性可以定义在 ERadioGroup 中,这样所有子元素都会继承这些属性。

属性名说明类型默认值
value单选框的值String?-
label单选框的标签String?-
disabled是否禁用booleanfalse
border是否显示边框booleanfalse
size单选框的尺寸ESizeItemESizeItem.medium
name原生 name 属性String?-
customFontSize自定义文字大小double?-
fontColorType文字颜色类型EColorTypeEColorType.primary
fontCustomColor文字颜色Color?-
iconColorType图标颜色类型EColorTypeEColorType.primary
iconCustomColor图标颜色Color?-

RadioGroup 属性

属性名说明类型默认值
value绑定值String?-
disabled是否禁用booleanfalse
size单选框的尺寸ESizeItemESizeItem.medium
customFontSize自定义文字大小double?-
fontColorType文字颜色类型EColorTypeEColorType.primary
fontCustomColor文字颜色Color?-
iconColorType图标颜色类型EColorTypeEColorType.primary
iconCustomColor图标颜色Color?-
children子组件列表List<Widget>-
onChanged值变化时触发ValueChanged<String>?-

RadioGroup 事件

事件名说明参数
onChanged选中值变化时触发(String value) => void

基于 MIT 协议发布