什么是表单下拉框

表单下拉框是一种用户界面元素，通常用于表单中，允许用户从一组预定义的选项中选择一个选项。表单下拉框由一个下拉箭头和一个选项列表组成，用户可以通过点击下拉箭头来展开选项列表，然后选择其中的一个选项。表单下拉框通常用于收集用户的信息，例如选择国家、省份、性别等。下拉框有助于保证数据的准确性和规范性。

适用场景

从多个下拉选项中选择其中一项，适用于选项较多的时候，可自定义选项内容，也可用于 数据联动 或 关联其他模型（表单、列表） 等多个场景，比如选择请假表单内的请假类型、性别等字段的时候，可以用下拉单选组件。我们先看一个示例：

注意：

• 下拉单选组件的选项值的长度最大不能超过 255 个字符；
• 下拉组件存储值为其他数据模型的所选择数据的id。

基础功能配置

• 基础配置如下图所示：

①：下拉框组件，可以将组件拖拽至表单画布中，实现组件的引用

②：组件绑定模型的字段，点击字段名称后，系统会把本表单对应的模型字段展示出来，选中即可

③：组件的中文名称，修改后会将组件的名称同步修改

④：组件的显隐控制装填设置，普通（刻度可操作）、只读（可读不可修改）、隐藏（不可见不可操作）

⑤：默认值，取值方式有两种，自定义和公式复制，自定义可以直接写入本字段的默认值，公式赋值通过公式函数计算后赋值

⑥：显示控制，通过其他组件结果的设置内容判断条件，当条件为真时展示本下拉框

⑦：禁用控制，通过其他组件结果的设置内容判断条件，当条件为真时本下拉框禁止操作

⑧：网络设置（逻辑触发），当内容修改后，且鼠标失焦后，将触发逻辑（用户自定义的逻辑）

• 扩展配置内容，如下图所示

①：下拉选择多选开关，开启后，支持多个选项同时选中

②：是否支持搜索选项，开启后，可以通过搜索的方式对下拉选项的内容进行过滤（模糊匹配）

③：是否可以创建选项开关，开启后，系统是支持可以动态创建选项的

④：选择内容可以是缩略展示和完全展示

效果如下：

下拉选项数据来源配置

下拉框的选项数据有多种来源方式，根据不同的场景自己选择，目前下拉框数据选项来源有是那种方式

接下来我们详细看下具体的配置。

• 配置数据模式，如下图所示：

①：选择下拉框数据类型为配置数据，系统展示配置数据的相关设置项，本质上是配置枚举值，这里的值是静态选项

②：可以点击“添加选项”按钮，增加选项，输入显示值和传递值的内容，用于

③：可以点击“删除”按钮，可以对已经设置的选项进行删除

• 接口数据模式

接口模式是让下拉框的数据选项通过动态的从API接口中查询并展示出来，如下图所示：

①：选择数据类型为接口数据

②：配置接口API的具体URL地址，这里的接口是通过get的方式对接口地址进行请求

③：对请求回来的数据设置展示的字段

④：设置使用后选项对应真实传递值的字段

• 数据模型

数据模型本质上也是实体的表，那么这种模式表示通过 另外的一张表里的数据进行展示下拉框的选项，如下图所示：

①：选择数据类型为数据模型（其他模型，可以是用户自定义的模型）

②：选择具体的数据模型，这里系统将本轻应用内所有模型都是可以选择

③：设置选中回显的字段内容

④：设置真实传递的字段内容，可以与现实值相同

⑤：设置副标题字段，通过额外的字段可以让用户更加便捷的选择选项数据

⑥：可以对数据设置过滤条件，一遍对大量数据进行精准的筛选

在线demo：https://frame.bctools.cn/

基础框架开源地址：https://gitee.com/software-minister/jvs