# 设置UI引擎前端页面单选框组组件属性
单选框组组件用于实现单选操作，用户必须且只能从一组互斥选项中选择一个。该组件支持标准单选框和按钮式两种展示形式，适用于设备运行模式选择、工艺路线指定、操作权限级别设置等需要唯一性选择的工业应用场景。
#### 前提条件
已在当前页面添加"单选框组"组件，具体操作请参见[为UI引擎前端页面添加物料组件](https://support.huaweicloud.com/usermanual-idme/idme_ui_0016.html)。
#### 配置入口
1. 在页面设计器的中心画布区，单击选中"单选框组"组件。
2. 在右侧设置面板中，单击![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002535447127.png)，即可展开"属性"设置面板。
 
#### 基础属性
| 属性名称 | 说明                                                                                                                                                                                                                                                                                                                                                                                     | 是否支持变量绑定 |
|:---|:---|:---|
| 绑定值  | 组件当前选中选项的绑定值，用于反映和控制单选框组的选中状态。                                                                                                                                                                                                                                                                                                                                                         | 是        |
| 数据列表 | 单选功能的备选项数据源，格式为符合组件要求的结构化数据列表。                                                                                                                                                                                                                                                                                                                                                         | 是        |
| 禁用   | 是否禁用整个单选框组。禁用后，组内所有选项均无法进行交互操作。                                                                                                                                                                                                                                                                                                                                                        | 是        |
| 是否只读 | 是否将组件设置为只读模式。只读状态下，选项可展示但无法修改选中状态。                                                                                                                                                                                                                                                                                                                                                     | 是        |
| 展示形式 | 单选备选项的显示样式，可选值： - radio：原生单选框样式，适用于配置表单。默认为"radio"。  - button：按钮式单选，适用于操作面板、模式切换。   | 是        |
| 垂直显示 | 设置组内选项的排列方式。开启后选项将垂直分布，关闭时为水平分布。                                                                                                                                                                                                                                                                                                                                                       | 是        |
   
#### 按钮模式配置项
仅当"展示形式"设置为"button"时，以下配置项生效。
| 属性名称 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 是否支持变量绑定 |
|:---|:---|:---|
| 激活颜色 | 选中选项时，按钮的背景色。 支持颜色单词、RGB格式和十六进制格式。                                                                                                                                                                                                                                                                                                                                                                              | 是        |
| 文本颜色 | 选中选项时，按钮内文字的颜色。 支持颜色单词、RGB格式和十六进制格式。                                                                                                                                                                                                                                                                                                                                                                              | 是        |
| 尺寸   | 按钮形式的单选框尺寸。 - medium：标准操作面板  - small：紧凑型仪表盘  - large：触屏操作界面   | 否        |
   
#### 其他
如下属性适用于UI引擎所有组件，用于精细化控制。
| 属性名称   | 说明                                                                                                                                 | 是否支持变量绑定 |
|:---|:---|:---|
| 元素id值  | 对应HTML标签的"id"属性，同一页面内必须唯一。                                                                                                         | 是        |
| 样式类    | 对应HTML标签的"class"属性，为空格分隔的类名列表，用于自定义组件样式。默认为"component-base-style"。                                                                 | 是        |
| ref引用类 | 对应Vue的"ref"属性，用于注册模板引用以访问组件实例方法。 如果为"数据源表单"组件，会自动填充默认值。 | 是        |