# 单选组

多个选项中选择一个时使用,支持基于动态数据源和静态数据显示

# 概念说明

# 单选组属性

组件通用属性请参见组件通用说明

  • 只读:正常显示,但禁止选择或输入。

  • 禁用:置灰显示,且禁止任何交互(焦点、点击、选择、输入等)。

  • 数据源:支持动态绑定集合类型变量(List<T>)或输出参数为集合类型的逻辑。

  • 数据类型:该属性为只读状态,当数据源动态绑定集合List<T>后,会自动识别T的类型并进行展示。

  • 选项文本:集合的元素类型中,用于显示选项文本的属性名称,支持自定义变更。

  • 选项值:集合的元素类型中,用于标识选中值的属性,支持自定义变更。

  • 值:当前选择的值。

    image-20230306184131834

# 单选项属性

  • 文本:选项显示的文本内容。

  • 选项值:单选框返还的选项值。

  • 只读:正常显示,但禁止选择或输入。

  • 禁用:置灰显示,且禁止任何交互(焦点、点击、选择、输入等)。

    image-20230306184308522

# 组件事件

  • 单选组支持输入组件常见的事件:输入前,输入时,选择后,改变后。
事件名 触发条件
输入前 单选输入前触发
输入时 单选组输入后触发
选择后 单选组改变选择后触发
改变后 单选组改变选择后触发
  • 单选项支持选择前事件。
事件名 触发条件
选择前 单选项选择前触发

# 注意事项

支持动态数据和静态数据同时渲染,绑定数据源生成的节点在静态添加的节点前面显示。

image-20230301142917135

# 样式

样式说明请参见组件通用说明

# 主题样式

  • 间距
    • 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)。
上次更新: 2023年06月14日