> ## 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.
# 下拉单选
> 本文档介绍了下拉单选组件的适用场景、基础功能以及常见问题，包括如何设置默认值、选项值与显示值的区别、与关联表单组件的不同之处等。
## 1. 适用场景
从多个下拉选项中选择其中一项，适用于选项较多的时候，可自定义选项内容，也可用于 [**数据联动**](/zh/yida/form/arpur0) 或 [**关联其他表单**](/zh/yida/form/tg64d5) 等多个场景，比如选择请假表单内的请假类型、性别等字段的时候，可以用下拉单选组件。
如果需要选项来源于其他表，且在选择完选项后，将选项相关的信息填充至表单（数据关联类的场景）比如合同管理场景中，在创建合同/订单时，将关联表单组件的选项与客户表关联，关联出客户信息等。建议使用 [**关联表单**](/zh/yida/form/agd540) 组件。
**注意：下拉单选组件的选项值的长度最大不能超过 255 个字符**
组件属性以及使用和示例请[**点击此处**](/zh/open/yida/components/interface)查看
## 2. 基础功能
### 2.1 清除按钮
清除选项框内的内容
组件的清除按钮
**效果如下：**
### 2.2 可搜索
允许对选项做搜索，当下拉选项内容过多时，可以通过搜索快速定位内容。
可搜索组件内容
**效果如下：**
### 2.3 无数据时显示内容
当可搜索按钮开启的时候，提交页面是支持搜索的，这个时候可以设置搜不到数据时的提示内容。
无数据时显示内容
**展示效果如图：**
### 2.4 选项类型
可以在这里设置下拉的选项内容，可以自定义选项内容也可以关联其他表单数据。
具体类型如图：
选项类型—配置关联其他表单数据等
#### 2.4.1 自定义
选项类型选择自定义时，可以在下面添加选项，自行编辑下拉的选项内容，还可以操作 [**关联选项设置**](/zh/yida/form/pw4kp6) 等。
自定义数据类型—选项一、选项二等
#### 2.4.2 搜索数据源
当我们需要搜索外部数据源作为我们的数据来源，常见于和外部系统的联动，可以参考如下配置：
**设置路径：**
**接口格式:**
###### 入参
* q : 用户搜索内容，搜索框发起请求的时候，会默认带上下图的参数
###### 返回值
```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"success": true,
"content": [
{
"text": "选项A",
"value": "A"
},{
"text": "选项B",
"value": "B"
},{
"text": "选项C",
"value": "C"
},
],
"errorCode": "",
"errorExtInfo": null,
"errorLevel": "",
"errorMsg": ""
}
```
## 3. 常用问题
### 3.1 下拉单选如何设置默认值
选中对应的选项内容，选中会展示为蓝色圆环，如下图所示：
设置下拉单选组件的默认值
**展示效果：**
### 3.2 选项值和显示值可以设置不同
选项值和显示值可以不同，这样我们就能够灵活应对多语言、改显示值等需求。
选项值和显示值
### 3.3 下拉单选与关联表单组件的区别
两者的功能定义与使用场景不同
#### 3.3.1 下拉单选
**选项来源**：自定义选项、从其他表单获取、通过远程数据源获取，数据联动获取。
**适用场景**：一般用于选项选择类的场景，且不需要关联出其他数据，可以使用下拉单选组件，比如请假表单的请假类型、性别等字段，可以用下拉单选组件。
#### 3.3.2 关联表单
**选项来源**：其他表单获取
**适用场景**：一般用于数据关联类的场景，比如合同管理场景中，在创建合同/订单时，将关联表单组件的选项与客户表关联，关联出客户信息等。
目前组件类型不支持直接转换，支持批量编辑。
在单行文本组件设置公式编辑直接选择下拉单选组件，如下图：
