# 单选组
多个选项中选择一个时使用,支持基于动态数据源和静态数据显示
# 概念说明
# 单选组属性
组件通用属性请参见组件通用说明。
只读:正常显示,但禁止选择或输入。
禁用:置灰显示,且禁止任何交互(焦点、点击、选择、输入等)。
数据源:支持动态绑定集合类型变量(List<T>)或输出参数为集合类型的逻辑。
数据类型:该属性为只读状态,当数据源动态绑定集合List<T>后,会自动识别T的类型并进行展示。
选项文本:集合的元素类型中,用于显示选项文本的属性名称,支持自定义变更。
选项值:集合的元素类型中,用于标识选中值的属性,支持自定义变更。
值:当前选择的值。
# 单选项属性
文本:选项显示的文本内容。
选项值:单选框返还的选项值。
只读:正常显示,但禁止选择或输入。
禁用:置灰显示,且禁止任何交互(焦点、点击、选择、输入等)。
# 组件事件
- 单选组支持输入组件常见的事件:输入前,输入时,选择后,改变后。
事件名 | 触发条件 |
---|---|
输入前 | 单选输入前触发 |
输入时 | 单选组输入后触发 |
选择后 | 单选组改变选择后触发 |
改变后 | 单选组改变选择后触发 |
- 单选项支持选择前事件。
事件名 | 触发条件 |
---|---|
选择前 | 单选项选择前触发 |
# 注意事项
支持动态数据和静态数据同时渲染,绑定数据源生成的节点在静态添加的节点前面显示。
# 样式
样式说明请参见组件通用说明。
# 主题样式
- 间距
- space-x:单选项之间的间距,如 1px。默认值32px。
- 大小
- size:单选项按钮大小,如 1px。默认值16px。
- 背景色
- background:单选项按钮背景色,如 #223325。默认值white。
- 边框阴影
- box-shadow-focus:鼠标聚焦到单选按钮时边框的阴影效果值,如 2px 2px 2px 1px rgba(0, 0, 0, 0.2)。默认值00 0 0 2px rgba(77, 136, 255, 0.2)。