# 变更记录
| 产品版本 | 更新内容 | 更新日期 |
| --- | --- | --- |
| V7.0.1 | 增加了单选字段，展示为平铺选项组，用户可针对选项组设置标题、必录、风格等；满足用户使用场景，降低开发成本，视觉效果更佳 | 2024-10-24 |
# 1 功能介绍
可以选择单个选项的组件。结合字段布局面板控件使用可以得到最佳的布局体验。
# 2 控件对象
`kd.bos.form.field.RadioOptGroupEdit`
# 3 视觉展示
# 4 属性说明
## 4.1 通用属性
>通用属性包含字段和控件的一些公有的属性，如宽高，帮助文本等等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976)
## 4.2 样式属性
>样式属性是每个控件在设计器右侧样式栏可以设置的属性，请参考[样式属性](https://vip.kingdee.com/article/252017936767406336)
## 4.3 业务属性
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| 平铺选项风格 | 下拉 | 默认 | 设置选项风格为默认或标签 |
| 平铺选项布局 | 下拉 | 横向 | 设置选项布局为横向布局或纵向布局 |
| 选项设置 | 弹框选择 | - | 设置单选字段选项信息，可配置标题，内容 |
| 校验选项值 | 复选框 | false | 给单选赋值时，校验此值是否在单选中存在 |
| 选项显示方式 | 下拉 | - | 可以通过控制该选项将单选字段切换为下拉字段，不支持通过指令切换 |
### 4.3.1 平铺选项数量限制
单选字段最多只展示100个选项，若选项较多的场景，建议使用下拉字段。
### 4.3.2 快捷键操作
1、操作【Tab】可切换下一个字段，操作【Shift+Tab】可切换上一个字段
2、操作【上箭头↑】或【左箭头←】可切换上一个选项并选中，通过【下箭头↓】或【右箭头→】可切换下一个选项并选中
3、操作【空格键】可选中选项
注：表格字段暂不支持通过快捷键进行操作
# 5 单选字段接口介绍
## 5.1 控件编程模型
单选字段，继承自下拉列表字段，控件模型也继承下拉列表字段控件模型，RadioOptGroupEdit
RadioOptGroupEdit可以控制下拉选项的锁定属性，kd.bos.form.field.ComboEidt#setComboItems这个方法，该方法的入参是一个ComboItem集合，ComboItem提供了一个属性disable，代表是否可选，插件只需要调用控件的这个方法传入参数即可
## 5.2 数据模型
单选控件的属性对象为 `RadioOptGroupEdit`类型，继承自 `ComboProp`，存储单选选项的值，String类型：
```java
package kd.bos.entity.property;
/**
* 单选字段 - 表单运行时元数据-实体的下级属性对象
*/
public class RadioOptGroupProp extends ComboProp {
}
```
## 5.3 插件事件
单选字段，继承了字段值改变事件，未增加其他插件事件
