跳到主要内容

单选框组

用于从一组选项中选择一个值，所有选项始终可见。

一、何时使用​

  • 用户需在多个互斥选项中选择一个
  • 场景中选项数量较少（建议不超过 6 项）
  • 与下拉框不同，单选框组可同时展示所有选项
  • 典型应用：性别、支付方式、收货方式等选择项

二、属性配置​

1. 数据源绑定​

单选框组支持以下三种方式绑定数据：

  • 接口绑定
  • 数据绑定
  • 模型绑定

详见：数据绑定。

数据源配置

2. 数据设置​

数据设置

字段说明
选项名称显示在单选框上的文本
选项值被选中后提交或存储的实际值
数据绑定绑定外部数据源（详见数据绑定）
初始值默认选中的选项值

3. 外观设置​

3.1 排列方式​

单选项的排列方式支持：

  • 水平排列：横向依次排列（适用于空间充足的表单）
  • 垂直排列：纵向展示（适用于移动端或长列表）

排列方式设置
排列方式效果

3.2 选中样式​

支持两种样式：

  • 圆形勾选：适用于传统表单
  • 方形勾选：适用于更现代或自定义风格的页面

选中样式设置
选中样式效果

4. 状态设置​

无特殊状态，详见：通用状态。

三、样式设置​

无组件特有样式设置，详见：通用样式。

四、常见使用场景​

1. 性别选择​

性别选择示例

2. 支付方式选择​

支付方式示例

3. 收货方式选择​

收货方式示例