> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# 单选
> 本页面介绍了单选组件的功能与使用方法，包括排列方式、自定义选项、关联选项设置、支持反选等功能，并提供了关于选项类型、彩色显示以及批量编辑的具体说明。
单选组件可用于在有限的相关选项中选择其中一个选项，比如选择性别、运动类型等场景。
注意：单选组件的选项值的长度最大不能超过 255 个字符
## 排列方式
选项可以设置排列方式，目前支持水平排列、垂直排列，效果如图：
## 自定义选项
选项值和显示值可以不同，你可以去自定义显示值和选项值。
* 显示值 ：我们在表单页面所看到的内容就是显示值
* 选项值 ：数据联动的条件匹配所使用到的值就属于选项值，选项值和显示值默认是一样的，也可单独设置选项值
## 关联选项设置 - 字段显隐
选项关联适用场景：当想要实现选择某一选项后，展示该选项所对应的值时，可以使用选项关联，适用于合同管理、物品领用、采购等场景，效果如图：
## 支持反选
开启反选功能即可实现再次点击该选项就取消选择
以下视频展示了开启和关闭的效果对比：
## 选项类型
单选组件支持以下 4 种选项类型：
* 自定义：根据自身需求自定义选项内容；
* 关联其他表单数据：通过关联设置，去获取到被关联的表单的一个数据作为当前表单的数据；
* 数据联动：当表单中某个字段的数据改变时，该表单中另一个字段的数据也会随之改变，一般用于设置组件的默认值；
* 网关数据： 接口必须是外网支持调用，同时返回的接口格式为 \[\{"text":"111","value":"111"}]
## 彩色
单选、复选、下拉单选、下拉复选组件均支持开启彩色按钮，开启后会根据选项不同则不同颜色展示，并且可以自定义颜色。
## 添加其他
若选项不确定时，可以开启添加其他功能，在遇到不符合的选项时就可以选择其他这一选项进行手动输入内容
## 批量编辑
在维护单选、多选、下拉单选、下拉多选的自定义选项时，你可以使用批量编辑功能进行编辑。
| **功能入口** | **编辑界面** |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
|  |  |
* 仅编辑显示值：由于宜搭选项支持自定义选项值、显示值，为了方便不同场景的需求并考虑使用方便程度，批量编辑的格式支持多种形式，可灵活选取适合自己需求的格式使用。
```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
选项1
选项2
选项3
```
* 同时编辑显示值和选项值：每个选项的显示值和选项值是一致的。
```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
选项1 | A
选项2 | B
选项3 | C
```
* 国际化文案：此时 A、B、C 即为每个选项的选项值。
```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
i18n-xxx | A
i18n-xxx | B
i18n-xxx | C
```
由于国际化文案需要统一维护，为避免编辑格式过于复杂，这种显示值不支持批量编辑。
连接符号为英文输入状态下的竖线`|`。
## 常见问题
Q：单选组件里面，设置几个选项，如图，当选择【其他】的时候，可以输入填写内容，这个诉求要在一个组件里面实现（不想用关联选项，因为需要再设置其他组件），通过代码可以实现吗？或者其他组件能否实现这个场景？
答：可以通过代码实现， 绑定 onchange 事件，动态控制输入内容组件的组件状态。
```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
export function onChange({ value }) {
if (value == "其他") {
this.$('numberField_krbd7ly0').setBehavior('NORMAL')//对应显示隐藏的组件唯一标识
} else {
this.$('numberField_krbd7ly0').setBehavior('HIDDEN')
}
}
```