跳到主要内容

单选框组

多个单选框的组合。

何时使用​

  • 在多个选项中选择单个状态。
  • 与 下拉框 区别在于 单选框组 所有选项可见。
  • 选项不宜过多。

一、属性​

1. 数据源​

单选框组提供了接口绑定、数据绑定、模型绑定三种绑定方式。详细绑定方式参考 数据绑定。

数据源

2. 数据​

数据配置

  • 选项名称：单选框组展示出来的名称。
  • 选项值：选择了单选框之后，实际发送给后端的值。
  • 数据绑定：详见 数据绑定。
  • 初始值：单选框组默认选中的值。

3. 外观​

排列方式​

选项排列样式可更改为水平排列或垂直排列。

排列方式

  • 水平排列：默认选择，横向水平排列。
  • 垂直排列：纵向垂直排列。

展示效果如下：

排列效果

类型​

可更改单选框组的类型，提供默认与按钮两种类型。

类型选择

  • 默认：默认选择，圆点样式的组合。
  • 按钮：按钮样式的组合。

样式示例：

按钮样式

尺寸​

仅在选择按钮类型后可配置，小、默认、大三种尺寸可选。

尺寸配置 尺寸效果

激活样式​

仅在选择按钮类型后可配置：

激活样式配置

  • 描边（默认）：选中的选项有边框高亮。

    描边样式

  • 填色：选中的选项背景填充为实色。

    填色样式

4. 状态​

禁用：设置为不可选中状态。

禁用状态

隐藏：设置为隐藏状态。

隐藏状态

二、样式​

无特殊样式，详见 通用样式。

三、常见使用场景​

  1. 普通使用，如性别选择

性别选择示例