# 基础控件
控件功能简介
> 1、`单行文本`:最基础的字段,在表单中具有广泛的应用,可以用来收集文字、数字等信息。
> 2、`多行文本`:常用于录入较长的文字,如说明、备注、反馈等。在输入多行文本时,没有字数限制。
> 3、`数字`:主要用来记录数字类型的数据信息,如金额、年龄、数量等。和文本不同的是,数字字段录入的数字,可以进行计算、统计、汇总等。
> 4、`计数器`:允许用户选择一个整数值,通过单击向上向下或者按键盘上的上下键来增加减少当前显示的值。用户也可以直接输入值。取值范围是(0-99),每次改变的步长是1。
> 5、`单选框`:钮组是可以直接点击选择的单选字段,一般用于单选且选项较少的场景
> 6、`多选框`:可以进行多项内容选择,一般用于多选且选项较少的场景。
> 7、`下拉框`:需要点击下拉按钮才进入选项的单项选择字段。
> 8、`日期控件`:日期时间字段主要用于记录时间信息,支持自动获取访问时间或者自定义填写其他时间。
> 9、`开关`:强调的是对控件显示状态的设置,包括显示的信息,字体,颜色等内容。状态开关虽然也可以通过点击操作实现控件状态的切换,它所表达的是两种工作状态的切换。
> 10、`滑块`:滑块控件可以为最终用户提供一个简单的、熟悉的方式,以在预定范围内选择一个值。
> 11、`评分`:评分控件为基础控件,支持在填报页面设置评分内容等,
> 12、`隐藏域`: 隐藏域在表单页面中对于用户是不可见的,
### 1、单行文本
1.1、添加单行文本控件
![](https://img.kancloud.cn/12/dc/12dc7a9d8005b3d3533a18193df64ccf_1920x375.png)
1.2、单行文本控件——`字段配置`
> `对象属性新增`【开启/关闭】参考【[2.2、添加字段]】
> `对象属性`:此属性用于绑定业务对象属性,用于提交数据绑定对象名称。
>
> > 注意:
> > 1)当子表单为多级子表业务对象且表单模式为弹窗或表内编辑模式时,设置当前子表单为多级表单。
> > 2)多级表单的上级表单必须存在,且表单模式为弹窗或表内编辑模式。
> `默认值`:设置后,此值将作为默认值显示在该字段的初始化值。
>
> > 如果不需要设置默认值,请将此处留空。
> > 默认值类型支持固定值、动态脚本、数据联动、公式计算等。
> ![](https://img.kancloud.cn/6e/f2/6ef2e0b83bdb0dfd194190b5eb51c904_1147x280.png)
![](https://img.kancloud.cn/77/40/7740a4e24b70bc868f0e7b660979819b_1522x597.png)
> `占位符`:此属性用于指定对该字段进行文字提示,在文本内部进行提示。
>
> > 一般是“请输入”、”请选择”等,建议不超过200个字符。
> `描述信息`:此属性用于指定对该字段进行一些附加说明,一般用来指导填写者输入。
![](https://img.kancloud.cn/03/2b/032bf37c856e5da845018dd134d96f53_1688x540.png)
> `提示前缀`:\[提示前缀\]报错提示时,报错:提示前缀—>单行文本必填
> `必填`:系统会限制填写者填写此字段的最少字符。
> 最少填\[50\]个字符:在文本框输入数据后,最少填写字数,少于配置项\[报错提示:最少填写50个字符\]
> 最多填\[1\]个字符:在文本框输入数据后,最多填写字数,多于配置项\[报错提示:最多填写1个字符\]
> `数据格式`:选择对应的数据格式,未满足对应格式,不允许保存,会报错提示
>
> > `手机号`:只能输入身份证,输入位数不一致的,报错:请输入正确的身份证号
> > `电话号码`:只能输入电话号码,输入位数不一致的,报错:请输入正确的电话号码
> > `邮编`:只能输入邮编,输入位数不一致的,报错:请输入正确的邮编
> > `身份证`:只能输入身份证,输入位数不一致的报错:请输入正确的身份证号
> > `邮箱`:只能输入邮箱,输入错误的邮箱。报错:请输入正确的邮箱
> > `自定义`:自定义校验`^[0-9]+$`,自定义报错,输入数字以外字符的会报错【自定义报错】
> `自定义校验`:如下配置【判断是否为空,判断是否为null】(value ===可修改判断)
~~~java
if(value ===''){
callback('请填写文本【可修改】')
}else if (value ===null){
callback('请填写文本【可修改】')
}else {
callback()
}
~~~
复制
![](https://img.kancloud.cn/37/0f/370f135ac010d7f1aee3649abe062061_1920x348.png)
> `操作属性`
>
> > `隐藏`:勾选后,该字段将隐藏,但如果动态赋值,可以对该字段进行赋值。
> > `只读`:勾选后该字段将只读,如果不勾选则该字段默认是可写的。
![](https://img.kancloud.cn/95/45/9545186a6258a88c7153be0c1f2cc08a_1686x536.png)
### 2、多行文本
2.1、添加多行文本控件,`参考`:[1.1、添加单行文本控件]
2.2、多行文本控件——`字段配置`
> `对象属性新增`【开启/关闭】参考【[2.2、添加字段]】
> `对象属性`:此属性用于绑定业务对象属性,用于提交数据绑定对象名称。
>
> > 注意:
> > 1)当子表单为多级子表业务对象且表单模式为弹窗或表内编辑模式时,设置当前子表单为多级表单。
> > 2)多级表单的上级表单必须存在,且表单模式为弹窗或表内编辑模式。
> `默认值`:设置后,此值将作为默认值显示在该字段的初始化值。
>
> > 如果不需要设置默认值,请将此处留空。
> > 默认值类型支持固定值、动态脚本、数据联动、公式计算等。
> `占位符`:此属性用于指定对该字段进行文字提示,在文本内部进行提示。
>
> > 一般是“请输入”、”请选择”等,建议不超过200个字符。
> `描述信息`:此属性用于指定对该字段进行一些附加说明,一般用来指导填写者输入。
![](https://img.kancloud.cn/03/2b/032bf37c856e5da845018dd134d96f53_1688x540.png)
> `提示前缀`:\[提示前缀\]报错提示时,报错:提示前缀—>多行文本必填
> `必填`:系统会限制填写者填写此字段的最少字符。
> `最少填[]个字符`:在文本框输入数据后,最少填写字数,少于配置项\[报错提示:最少填写【指定的数量】个字符\]
> `最多填[]个字符`:在文本框输入数据后,最多填写字数,多于配置项\[报错提示:最多填写【指定的数量】个字符\]
> `自定义校验`:如下配置【判断是否为空,判断是否为null】(value ===可修改判断)
~~~java
if(value ===''){
callback('请填写文本【可修改】')
}else if (value ===null){
callback('请填写文本【可修改】')
}else {
callback()
}
~~~
复制
> `操作属性`
>
> > `隐藏`:勾选后,该字段将隐藏,但如果动态赋值,可以对该字段进行赋值。
> > `只读`:勾选后该字段将只读,如果不勾选则该字段默认是可写的。
![](https://img.kancloud.cn/f1/6a/f16afba7eea1be8bee0bcdc3ab303336_1701x466.png)
### 3、数字
3.1、添加数字控件,`参考`:1.1、添加单行文本控件
3.2、数字控件——`字段配置`
> `对象属性新增`【开启/关闭】参考【[2.2、添加字段]】
> `对象属性`:此属性用于绑定业务对象属性,用于提交数据绑定对象名称。
>
> > 注意:
> > 1)当子表单为多级子表业务对象且表单模式为弹窗或表内编辑模式时,设置当前子表单为多级表单。
> > 2)多级表单的上级表单必须存在,且表单模式为弹窗或表内编辑模式。
> `默认值`:设置后,此值将作为默认值显示在该字段的初始化值。
>
> > 如果不需要设置默认值,请将此处留空。
> > 默认值类型支持固定值、动态脚本、数据联动、公式计算等。
> `占位符`:此属性用于指定对该字段进行文字提示,在文本内部进行提示。
>
> > 一般是“请输入”、”请选择”等,建议不超过200个字符。
> `描述信息`:此属性用于指定对该字段进行一些附加说明,一般用来指导填写者输入。
![](https://img.kancloud.cn/a1/5e/a15e3617acdfcebd082dc1c48f604b71_1693x545.png)
> `数值`:输入数字数据只显示数字
>
> > 保留小数位数\[2\],显示数字时保留两位小数
> > 小数是否补零:\[开启后\]未填写小数的数字,数字后面自动填充\[.00\]
> > 是否四舍五入:小数超过指定保留小数,按照清除的那位小数是否大于等于5,满足条件在保留最后一位数中加一
> 显示千分符:\[开启\]数据超过百,显示千分符,显示\[1,000\],开启小数位数\[2\]显示\[1,000.00\]
![](https://img.kancloud.cn/57/b4/57b474849187ffa0ea6f4bd781f1f9a1_1687x442.png)
> `百分比`:输入数字数据,显示数字+百分比\[%\]
>
> > 保留小数位数\[2\],显示数字时保留两位小数+百分比\[%\]
> > 小数是否补零:\[开启后\]未填写小数的数字,数字后面自动填充\[.00\]+百分比\[%\]
> > 是否四舍五入:小数超过指定保留小数,按照清除的那位小数是否大于等于5,满足条件在保留最后一位数中加一+百分比\[%\]
> `显示千分符`:\[开启\]数据超过百,显示千分符,显示\[1,000\],开启小数位数\[2\]显示\[1,000.00\]+百分比\[%\]
![](https://img.kancloud.cn/45/9c/459c1d811067006bf39298a309aca8f4_1686x382.png)
> `提示前缀`:\[提示前缀\]报错提示时,报错:提示前缀—>数字必填
> `必填`:系统会限制填写者填写此字段的最少字符。
> 最小值\[50\]:在数字框输入数据后,填写的数字不能小于50\[报错提示:必须大于或等于50\]
> 最大值\[100\]:在数字框输入数据后,填写的数字不能大于100\[报错提示:必须小于或等于100\]
> 注意⚠️:最小值与最大值同时开启,填写的最小值不能大于最大值
> `自定义校验`:如下配置【判断是否为空,判断是否为null】(value ===可修改判断)
~~~java
if(value ===''){
callback('请填写数字【不能为空】')
}else if (value ===null){
callback('请填写数字【不能为null】')
}else if (value < 200){callback('请填写数字【大于200】')
}else {
callback()
}
~~~
复制
> `操作属性`
>
> > `隐藏`:勾选后,该字段将隐藏,但如果动态赋值,可以对该字段进行赋值。
> > `只读`:勾选后该字段将只读,如果不勾选则该字段默认是可写的。
![](https://img.kancloud.cn/75/be/75be5086e10520041ff728084351f0b0_1686x550.png)
### 4、计数器
4.1、添加计数器控件,`参考`:1.1、添加单行文本控件
4.2、计数器控件——`字段配置`
> `对象属性新增`【开启/关闭】参考【[2.2、添加字段]】
> `对象属性`:此属性用于绑定业务对象属性,用于提交数据绑定对象名称。
>
> > 注意:
> > 1)当子表单为多级子表业务对象且表单模式为弹窗或表内编辑模式时,设置当前子表单为多级表单。
> > 2)多级表单的上级表单必须存在,且表单模式为弹窗或表内编辑模式。
> `默认值`:设置后,此值将作为默认值显示在该字段的初始化值。
>
> > 如果不需要设置默认值,请将此处留空。
> > 默认值类型支持固定值、动态脚本、数据联动、公式计算等。
> `占位符`:此属性用于指定对该字段进行文字提示,在文本内部进行提示。
>
> > 一般是“请输入”、”请选择”等,建议不超过200个字符。
> `描述信息`:此属性用于指定对该字段进行一些附加说明,一般用来指导填写者输入。
![](https://img.kancloud.cn/c2/69/c2699a269a9c5349399524e78eba5a8e_1685x553.png)
> 最小值\[50\]:填写的数字不能小于50\[输入错误数据:计数器自动填充50数字\]
> 最大值\[100\]:填写的数字不能大于100\[输入错误数据:计数器自动填充50数字\]
> 步长:设置\[2\],每次点击加减\[每次加减都是2\]
> 精度:显示小数精度
> 是否使用控制按钮
>
> > `控制按钮位置`:\[两侧\]左右两边显示\[-\]\[+\]选项,\[右侧\]右侧显示\[+-\]选项
![](https://img.kancloud.cn/b2/c2/b2c209f533dbf827c32692af9949c7df_1688x489.png)
> `提示前缀`:\[提示前缀\]报错提示时,报错:提示前缀—>计数器必填
> `必填`:系统会限制填写者填写此字段的最少字符。
> `自定义校验`:如下配置【判断是否为空,判断是否为null】(value ===可修改判断)
~~~java
if(value ===''){
callback('请填写数字【不能为空】')
}else if (value ===null){
callback('请填写数字【不能为null】')
}else if (value < 20){callback('请填写数字【大于20】')
}else {
callback()
}
~~~
复制
> `操作属性`
>
> > `隐藏`:勾选后,该字段将隐藏,但如果动态赋值,可以对该字段进行赋值。
> > `只读`:勾选后该字段将只读,如果不勾选则该字段默认是可写的。
![](https://img.kancloud.cn/38/29/3829d9ec29f0e944463720fec0f873e8_1681x602.png)
### 5、单选框
5.1、添加单选框控件,`参考`:1.1、添加单行文本控件
5.2、单选框控件——`字段配置`
> `对象属性新增`【开启/关闭】参考【[2.2、添加字段]】
> `对象属性`:此属性用于绑定业务对象属性,用于提交数据绑定对象名称。
>
> > 注意:
> > 1)当子表单为多级子表业务对象且表单模式为弹窗或表内编辑模式时,设置当前子表单为多级表单。
> > 2)多级表单的上级表单必须存在,且表单模式为弹窗或表内编辑模式。
> `默认值`:设置后,此值将作为默认值显示在该字段的初始化值。
>
> > 如果不需要设置默认值,请将此处留空。
> > 默认值类型支持固定值、动态脚本、数据联动、公式计算等。
> `占位符`:此属性用于指定对该字段进行文字提示,在文本内部进行提示。
>
> > 一般是“请输入”、”请选择”等,建议不超过200个字符。
> `描述信息`:此属性用于指定对该字段进行一些附加说明,一般用来指导填写者输入。
![](https://img.kancloud.cn/23/ce/23cee33d4da614ed7f90198702ff9b89_1687x450.png)
> `选项配置`
>
> > `彩色`:\[开启后\]单选数据显示颜色
> > `支持反选`:支持选择后,取消选择
> > 选项数据值来源:\[静态数据\]此属性用于设置选项数据值来源是自定义固定的选项值/标签【静态数据】
> >
> > > `添加选项`:
> > > `添加其他`:其他选项后面的输入框与当前配置项选择的字段是互相关联的,输入框内的显示值与该字段的值是一致的,建议选择当前设计器中未显示的字段
> > > `编辑选项`:弹窗编辑静态数据
> ![](https://img.kancloud.cn/ce/7d/ce7dbeb2896afe31c2989c13379a318c_759x431.png)
> > > `选择模板`:选择对应的模板,填充到静态数据中
![](https://img.kancloud.cn/2c/98/2c98f953700041a9ca72cb4bc47f4b8a_1139x430.png)
![](https://img.kancloud.cn/29/1c/291cca42ce4310d7d1896a5b87f159f2_1687x468.png)
> 选项数据值来源\[值来源\]
>
> > `值来源`:绑定的数据是数据模板中的值来源
> > `关联配置`:设置存储的值,设置显示的值
> ![](https://img.kancloud.cn/00/43/0043fc5cc7e77d7d010ffc5d3ef5f58d_574x408.png)
> > `动态参数`:值来源为动态值来源时\[会出现这个配置\],根据配置\[动态条件\]来过滤对应单选数据
> > `联动数据`:配置对应联动控件,选择单选数据后,将返回的数据联动到配置的控件中
> > `关联属性`:关联属性绑定\[其他控件-文本控件\],选择单选数据后,对应联动到文本控件内
![](https://img.kancloud.cn/3c/61/3c619160a8cc961d98bae5632af7a3bf_1661x584.png)
> 选项数据值来源\[数据字典\]
>
> > `数据字典`:绑定的数据来源\[系统管理/分类管理/数据字典管理\]内的数据
![](https://img.kancloud.cn/03/70/0370e1fee58422ea781fef51edcdbbc3_1690x324.png)
> 选项数据值来源\[动态数据\]
>
> > 配置请求
![](https://img.kancloud.cn/29/84/2984c72af2d8b97a8d4c7ba0b8404969_1920x955.png)
~~~java
//返回值函数
//参数res是请求返回的整个响应体,方法必须返回获取的数据;
//form是当前控件的this;
//mainData是主表数据;
//currentData是当前子表数据(如果为主表字段,则currentData值为空)。
function(res,form,mainData,currentData){
return res.data.data.dataResult
}
~~~
复制
![](https://img.kancloud.cn/6f/88/6f882cdf5c11914fd4630d160268a5d3_1920x867.png)
![](https://img.kancloud.cn/50/fc/50fcd6c75dcbfe75a4b959824c8dc287_1693x229.png)
![](https://img.kancloud.cn/e4/66/e4662df0365e575b6077fec54da72410_1469x168.png)
> `提示前缀`:\[提示前缀\]报错提示时,报错:提示前缀—>单选必填
> `必填`:系统会限制填写者填写此字段的最少字符。
> `自定义校验`:如下配置【判断是否为空,判断是否为null】(value ===可修改判断)
~~~java
if(value ===''){
callback('请填写文本【可修改】')
}else if (value ===null){
callback('请填写文本【可修改】')
}else {
callback()
}
~~~
复制
> `操作属性`
>
> > `隐藏`:勾选后,该字段将隐藏,但如果动态赋值,可以对该字段进行赋值。
> > `只读`:勾选后该字段将只读,如果不勾选则该字段默认是可写的。
![](https://img.kancloud.cn/2b/81/2b81678179b2c74199c46b169ca65298_1683x460.png)
### 6、多选框
6.1、添加多选框控件,`参考`:1.1、添加单行文本控件
6.2、多选框控件——`字段配置`
> `对象属性新增`【开启/关闭】参考【[2.2、添加字段]】
> `对象属性`:此属性用于绑定业务对象属性,用于提交数据绑定对象名称。
>
> > 注意:
> > 1)当子表单为多级子表业务对象且表单模式为弹窗或表内编辑模式时,设置当前子表单为多级表单。
> > 2)多级表单的上级表单必须存在,且表单模式为弹窗或表内编辑模式。
> `默认值`:设置后,此值将作为默认值显示在该字段的初始化值。
>
> > 如果不需要设置默认值,请将此处留空。
> > 默认值类型支持固定值、动态脚本、数据联动、公式计算等。
> `占位符`:此属性用于指定对该字段进行文字提示,在文本内部进行提示。
>
> > 一般是“请输入”、”请选择”等,建议不超过200个字符。
> `描述信息`:此属性用于指定对该字段进行一些附加说明,一般用来指导填写者输入。
![](https://img.kancloud.cn/6d/76/6d765d45ccab754276762e39d41ce3ce_1237x452.png)
> `选项配置`
>
> > 彩色:\[开启后\]单选数据显示颜色
> > `支持反选`:支持选择后,取消选择
> > 选项数据值来源:\[静态数据\]此属性用于设置选项数据值来源是自定义固定的选项值/标签【静态数据】
> >
> > > `添加选项`:
> > > `添加其他`:其他选项后面的输入框与当前配置项选择的字段是互相关联的,输入框内的显示值与该字段的值是一致的,建议选择当前设计器中未显示的字段
> > > `编辑选项`:弹窗编辑静态数据
> ![](https://img.kancloud.cn/ce/7d/ce7dbeb2896afe31c2989c13379a318c_759x431.png)
> > > `选择模板`:选择对应的模板,填充到静态数据中
![](https://img.kancloud.cn/2c/98/2c98f953700041a9ca72cb4bc47f4b8a_1139x430.png)
![](https://img.kancloud.cn/ed/7b/ed7b3c7289e1020b138d2c8f272b5bdb_1236x402.png)
> 选项数据值来源\[值来源\]
>
> > `值来源`:绑定的数据是数据模板中的值来源
> > `关联配置`:设置存储的值,设置显示的值
> ![](https://img.kancloud.cn/00/43/0043fc5cc7e77d7d010ffc5d3ef5f58d_574x408.png)
> > `动态参数`:值来源为动态值来源时\[会出现这个配置\],根据配置\[动态条件\]来过滤对应单选数据
![](https://img.kancloud.cn/2a/90/2a905a2555738fe072acd543d9b4c178_1236x417.png)
> 选项数据值来源\[数据字典\]
>
> > `数据字典`:绑定的数据来源\[系统管理/分类管理/数据字典管理\]内的数据
![](https://img.kancloud.cn/62/2a/622a09c3ae32361544d998e87e1e3687_1233x264.png)
> 选项数据值来源\[动态数据\]
>
> > `配置请求`
![](https://img.kancloud.cn/29/84/2984c72af2d8b97a8d4c7ba0b8404969_1920x955.png)
~~~java
//返回值函数
//参数res是请求返回的整个响应体,方法必须返回获取的数据;
//form是当前控件的this;
//mainData是主表数据;
//currentData是当前子表数据(如果为主表字段,则currentData值为空)。
function(res,form,mainData,currentData){
return res.data.data.dataResult
}
~~~
复制
![](https://img.kancloud.cn/6f/88/6f882cdf5c11914fd4630d160268a5d3_1920x867.png)
![](https://img.kancloud.cn/e6/74/e67489e68a62d0f1830ecdd8647690da_1236x195.png)
![](https://img.kancloud.cn/b6/db/b6dbe32412f29cb8bbbf92003353177e_1466x154.png)
> `提示前缀`:\[提示前缀\]报错提示时,报错:提示前缀—>多选必填
> `必填`:系统会限制填写者填写此字段的最少字符。
> 最少选择\[\]项:系统会限制填写者勾选此字段最少允许的选择项。
> 最多选择\[\]项:系统会限制填写者勾选此字段最多允许的选择项。
> `自定义校验`:如下配置【判断是否为空,判断是否为null】(value ===可修改判断)
~~~java
if(value ===''){
callback('请填写文本【可修改】')
}else if (value ===null){
callback('请填写文本【可修改】')
}else {
callback()
}
~~~
复制
> `操作属性`
>
> > `隐藏`:勾选后,该字段将隐藏,但如果动态赋值,可以对该字段进行赋值。
> > `只读`:勾选后该字段将只读,如果不勾选则该字段默认是可写的。
![](https://img.kancloud.cn/6c/c2/6cc20c57151781fb241272a0afb421cb_1239x457.png)
### 7、下拉框
7.1、添加下拉框控件,`参考`:1.1、添加单行文本控件
7.2、下拉框控件——`字段配置`
> `对象属性新增`【开启/关闭】参考【[2.2、添加字段]】
> `对象属性`:此属性用于绑定业务对象属性,用于提交数据绑定对象名称。
>
> > 注意:
> > 1)当子表单为多级子表业务对象且表单模式为弹窗或表内编辑模式时,设置当前子表单为多级表单。
> > 2)多级表单的上级表单必须存在,且表单模式为弹窗或表内编辑模式。
> `默认值`:设置后,此值将作为默认值显示在该字段的初始化值。
>
> > 如果不需要设置默认值,请将此处留空。
> > 默认值类型支持固定值、动态脚本、数据联动、公式计算等。
> `占位符`:此属性用于指定对该字段进行文字提示,在文本内部进行提示。
>
> > 一般是“请输入”、”请选择”等,建议不超过200个字符。
> `描述信息`:此属性用于指定对该字段进行一些附加说明,一般用来指导填写者输入。
![](https://img.kancloud.cn/23/ce/23cee33d4da614ed7f90198702ff9b89_1687x450.png)
> 选项配置
>
> > `彩色`:\[开启后\]单选数据显示颜色
> > `支持反选`:支持选择后,取消选择
> > `是否多选`:此属性用于限制填写可以选择多个值,还是只能选中一个值。
> > 选项数据值来源:\[静态数据\]此属性用于设置选项数据值来源是自定义固定的选项值/标签【静态数据】
> >
> > > 添加选项:
> > > `添加其他`:其他选项后面的输入框与当前配置项选择的字段是互相关联的,输入框内的显示值与该字段的值是一致的,建议选择当前设计器中未显示的字段
> > > `编辑选项`:弹窗编辑静态数据
> ![](https://img.kancloud.cn/ce/7d/ce7dbeb2896afe31c2989c13379a318c_759x431.png)
> > > `选择模板`:选择对应的模板,填充到静态数据中
![](https://img.kancloud.cn/2c/98/2c98f953700041a9ca72cb4bc47f4b8a_1139x430.png)
![](https://img.kancloud.cn/0c/83/0c837f6c2a1b04d06504baccbbcc4b0c_1238x437.png)
> 选项数据值来源\[值来源\]
> `是否多选[关闭]`
>
> > `值来源`:绑定的数据是数据模板中的值来源
> > `关联配置`:设置存储的值,设置显示的值
> ![](https://img.kancloud.cn/00/43/0043fc5cc7e77d7d010ffc5d3ef5f58d_574x408.png)
> > `动态参数`:值来源为动态值来源时\[会出现这个配置\],根据配置\[动态条件\]来过滤对应单选数据
> > `联动数据`:配置对应联动控件,选择单选数据后,将返回的数据联动到配置的控件中
> > `关联属性`:关联属性绑定\[其他控件-文本控件\],选择单选数据后,对应联动到文本控件内
![](https://img.kancloud.cn/ab/e3/abe39742f0d3822c445f503beb965a27_1235x627.png)
> 选项数据值来源\[值来源\]
> `是否多选[开启]`
>
> > `值来源`:绑定的数据是数据模板中的值来源
> > `关联配置`:设置存储的值,设置显示的值
> > `动态参数`:值来源为动态值来源时\[会出现这个配置\],根据配置\[动态条件\]来过滤对应单选数据
![](https://img.kancloud.cn/b8/d3/b8d383bce4a4434cb6dbe11ff3a04e96_1236x445.png)
> 选项数据值来源\[数据字典\]
>
> > `数据字典`:绑定的数据来源\[系统管理/分类管理/数据字典管理\]内的数据
![](https://img.kancloud.cn/03/70/0370e1fee58422ea781fef51edcdbbc3_1690x324.png)
> 选项数据值来源\[动态数据\]
>
> > `配置请求`
![](https://img.kancloud.cn/29/84/2984c72af2d8b97a8d4c7ba0b8404969_1920x955.png)
~~~java
//返回值函数
//参数res是请求返回的整个响应体,方法必须返回获取的数据;
//form是当前控件的this;
//mainData是主表数据;
//currentData是当前子表数据(如果为主表字段,则currentData值为空)。
function(res,form,mainData,currentData){
return res.data.data.dataResult
}
~~~
复制
![](https://img.kancloud.cn/6f/88/6f882cdf5c11914fd4630d160268a5d3_1920x867.png)
![](https://img.kancloud.cn/50/fc/50fcd6c75dcbfe75a4b959824c8dc287_1693x229.png)
![](https://img.kancloud.cn/e4/66/e4662df0365e575b6077fec54da72410_1469x168.png)
> `提示前缀`:\[提示前缀\]报错提示时,报错:提示前缀—>下拉必填
> `必填`:系统会限制填写者填写此字段的最少字符。
> `自定义校验`:如下配置【判断是否为空,判断是否为null】(value ===可修改判断)
~~~java
if(value ===''){
callback('请选择选项【可修改】')
}else if (value ===null){
callback('请选择选项')
}else {
callback()
}
~~~
复制
> `操作属性`
>
> > `隐藏`:勾选后,该字段将隐藏,但如果动态赋值,可以对该字段进行赋值。
> > `只读`:勾选后该字段将只读,如果不勾选则该字段默认是可写的。
![](https://img.kancloud.cn/f0/de/f0de318aafa9cbea0ea8388c266e145e_1243x526.png)
### 8、日期控件
8.1、添加日期控件,`参考`:1.1、添加单行文本控件
8.2、日期控件——`字段配置`
> `对象属性新增`【开启/关闭】参考【[2.2、添加字段】
> `对象属性`:此属性用于绑定业务对象属性,用于提交数据绑定对象名称。
>
> > 注意:
> > 1)当子表单为多级子表业务对象且表单模式为弹窗或表内编辑模式时,设置当前子表单为多级表单。
> > 2)多级表单的上级表单必须存在,且表单模式为弹窗或表内编辑模式。
> `日期格式`:可以选择不同的时间存储类型,\[自定义格式:可以自定义存储指定类型\]
> `默认值`:设置后,此值将作为默认值显示在该字段的初始化值。
>
> > 如果不需要设置默认值,请将此处留空。
> > 默认值类型支持固定值、动态脚本、数据联动、公式计算等。
> `占位符`:此属性用于指定对该字段进行文字提示,在文本内部进行提示。
>
> > 一般是“请输入”、”请选择”等,建议不超过200个字符。
> `描述信息`:此属性用于指定对该字段进行一些附加说明,一般用来指导填写者输入。
![](https://img.kancloud.cn/23/ce/23cee33d4da614ed7f90198702ff9b89_1687x450.png)
> `提示前缀`:\[提示前缀\]报错提示时,报错:提示前缀—>下拉必填
> `必填`:系统会限制填写者填写此字段的最少字符。
> `起始日期`:
>
> > `特定日期`:指定日期\[2022-12-20\],选择日期控件数据,可选择的日期范围大于等于指定日期
> > `表单字段`:绑定指定控件\[日期控件\],选择的时间大于等于绑定\[日期控件\]的日期
> > `填写当前日期`:指定当前日期,日期控件选择的时间大于等于当前日期
> > `当前日期前`:可以配置\[年\]\[月\]\[日\]\[时\]\[分\]\[秒\],演示:今天是\[2020-12-10\]号,配置当前日前\[1\]\[天\],日期控件只能选择大于等于\[2020-12-09\]日期
> > `当前日期后`:可以配置\[年\]\[月\]\[日\]\[时\]\[分\]\[秒\],演示:今天是\[2020-12-10\]号,配置当前日后\[1\]\[天\],日期控件只能选择大于等于\[2020-12-11\]日期
![](https://img.kancloud.cn/0e/20/0e20ac0bdd4824d7454acff2a47e02a6_1476x551.png)
> `结束日期`:
>
> > `特定日期`:指定日期\[2022-12-20\],选择日期控件数据,可选择的日期范围小于等于指定日期
> > `表单字段`:绑定指定控件\[日期控件\],选择的时间不能小于绑定\[日期控件\]的日期
> > `填写当前日期`:指定当前日期,日期控件选择的时间不能小于当前日期
> > `当前日期前`:可以配置\[年\]\[月\]\[日\]\[时\]\[分\]\[秒\],演示:今天是\[2020-12-10\]号,配置当前日前\[1\]\[天\],日期控件只能选择小于等于\[2020-12-09\]日期
> > `当前日期后`:可以配置\[年\]\[月\]\[日\]\[时\]\[分\]\[秒\],演示:今天是\[2020-12-10\]号,配置当前日后\[1\]\[天\],日期控件只能选择小于等于\[2020-12-11\]日期
![](https://img.kancloud.cn/8f/f3/8ff34cf6ebf6cf356526eb275c28792c_1471x282.png)
> `自定义校验`:如下配置【判断是否为空,判断是否为null】(value ===可修改判断)
~~~java
if(value ===''){
callback('请选择选项【可修改】')
}else if (value ===null){
callback('请选择选项')
}else {
callback()
}
~~~
复制
> `操作属性`
>
> > `隐藏`:勾选后,该字段将隐藏,但如果动态赋值,可以对该字段进行赋值。
> > `只读`:勾选后该字段将只读,如果不勾选则该字段默认是可写的。
![](https://img.kancloud.cn/f0/de/f0de318aafa9cbea0ea8388c266e145e_1243x526.png)
### 9、开关
9.1、添加开关控件,`参考`:1.1、添加单行文本控件
9.2、开关控件——`字段配置`
> `对象属性新增`【开启/关闭】参考【[2.2、添加字段]】
> `对象属性`:此属性用于绑定业务对象属性,用于提交数据绑定对象名称。
>
> > 注意:
> > 1)当子表单为多级子表业务对象且表单模式为弹窗或表内编辑模式时,设置当前子表单为多级表单。
> > 2)多级表单的上级表单必须存在,且表单模式为弹窗或表内编辑模式。
> `默认值`:设置后,此值将作为默认值显示在该字段的初始化值。
>
> > 如果不需要设置默认值,请将此处留空。
> > 默认值类型支持固定值、动态脚本、数据联动、公式计算等。
> `描述信息`:此属性用于指定对该字段进行一些附加说明,一般用来指导填写者输入。
![](https://img.kancloud.cn/fb/d2/fbd25a6c1b7cd093e60471bfc5918a3d_1238x474.png)
> `显示描述`:\[开启后\]按钮会根据\[自定义文字描述\]显示对应文字
>
> > `存储值`:存储字段
> > `文字描述`:可以配置对应按钮描述例如:开\[开启\] ![](https://img.kancloud.cn/dd/a2/dda2ead5fd718c0e86de561d107229f7_162x26.png)
,关\[关闭\]![](https://img.kancloud.cn/02/02/02026a53e45c4744572b2beced5bf1ae_157x20.png)
> > `背景颜色`:可以配置对应开关颜色,例如:开\[绿色\]![](https://img.kancloud.cn/dd/a2/dda2ead5fd718c0e86de561d107229f7_162x26.png),关\[红色\]![](https://img.kancloud.cn/02/02/02026a53e45c4744572b2beced5bf1ae_157x20.png)
> `操作属性`
>
> > `隐藏`:·勾选后,该字段将隐藏,但如果动态赋值,可以对该字段进行赋值。
> > `只读`:勾选后该字段将只读,如果不勾选则该字段默认是可写的。
![](https://img.kancloud.cn/92/9e/929ec7987979ac7045732988999f6a65_1240x596.png)
### 10、滑块
10.1、添加开关控件,`参考`:1.1、添加单行文本控件
10.2、开关控件——`字段配置`
> `对象属性新增`【开启/关闭】参考【[2.2、添加字段]】
> `对象属性`:此属性用于绑定业务对象属性,用于提交数据绑定对象名称。
>
> > 注意:
> > 1)当子表单为多级子表业务对象且表单模式为弹窗或表内编辑模式时,设置当前子表单为多级表单。
> > 2)多级表单的上级表单必须存在,且表单模式为弹窗或表内编辑模式。
> `默认值`:设置后,此值将作为默认值显示在该字段的初始化值。
>
> > 如果不需要设置默认值,请将此处留空。
> > 默认值类型支持固定值、动态脚本、数据联动、公式计算等。
> `描述信息`:此属性用于指定对该字段进行一些附加说明,一般用来指导填写者输入。
![](https://img.kancloud.cn/fb/d2/fbd25a6c1b7cd093e60471bfc5918a3d_1238x474.png)
> `滑块设置`
>
> > `最小值`:选择的最小值
> > `最大值`:选择的最大值
> > `步长`:每次滑动按照配置的步长来跳动
> > `是否显示输入框`:在控件后方,显示数字输入框
> > `是否显示提示标签`:滑动滑块控件时,是否显示值
![](https://img.kancloud.cn/ea/69/ea69e75fe8c5bfb23ff081d7a6950236_295x305.png)
> `校验规则`
>
> > `提示前缀`:\[提示前缀\]报错提示时,报错:提示前缀—>下拉必填
> > `必填`:系统会限制填写者填写此字段的最少字符。
> > `自定义校验`:如下配置【判断是否为空,判断是否为null】(value ===可修改判断)
~~~java
if(value ===''){
callback('请选择选项【可修改】')
}else if (value ===null){
callback('请选择选项')
}else {
callback()
}
~~~
复制
> `操作属性`
>
> > `隐藏`:勾选后,该字段将隐藏,但如果动态赋值,可以对该字段进行赋值。
> > `只读`:勾选后该字段将只读,如果不勾选则该字段默认是可写的。
![](https://img.kancloud.cn/b0/bb/b0bb4ce51aeca16c63b8ff083726c0fa_1237x734.png)
### 11、评分
11.1、添加评分控件,`参考`:1.1、添加单行文本控件
11.2、评分控件——`字段配置`
> `对象属性新增`【开启/关闭】参考【[2.2、添加字段]】
> `对象属性`:此属性用于绑定业务对象属性,用于提交数据绑定对象名称。
>
> > 注意:
> > 1)当子表单为多级子表业务对象且表单模式为弹窗或表内编辑模式时,设置当前子表单为多级表单。
> > 2)多级表单的上级表单必须存在,且表单模式为弹窗或表内编辑模式。
> `默认值`:设置后,此值将作为默认值显示在该字段的初始化值。
>
> > 如果不需要设置默认值,请将此处留空。
> > 默认值类型支持固定值、动态脚本、数据联动、公式计算等。
> `描述信息`:此属性用于指定对该字段进行一些附加说明,一般用来指导填写者输入。
![](https://img.kancloud.cn/a9/15/a915248e503e07e2dbdb66d7f081957d_1234x506.png)
> `评分设置`
>
> > `最大分值`:评分最大值
> > `允许半选`:评分半选,例如:3星半![](https://img.kancloud.cn/32/98/3298dea4440b3fa7003f36c4e8562950_103x12.png)
> > `显示辅助文字`:辅助文字演示![](https://img.kancloud.cn/56/98/5698bdf9be54671571a7d3a7c942bd32_141x19.png)
> > `显示当前分数`:辅助/分数文字颜色,配置数字字体颜色
![](https://img.kancloud.cn/3b/8a/3b8a95e97af262ba5d194a1d71de446b_1235x294.png)
> `校验规则`
>
> > `提示前缀`:\[提示前缀\]报错提示时,报错:提示前缀—>下拉必填
> > `必填`:系统会限制填写者填写此字段的最少字符。
> > `自定义校验`:如下配置【判断是否为空,判断是否为null】(value ===可修改判断)
~~~java
if(value ===''){
callback('请选择选项【可修改】')
}else if (value ===null){
callback('请选择选项')
}else {
callback()
}
~~~
复制
> `操作属性`
>
> > `隐藏`:勾选后,该字段将隐藏,但如果动态赋值,可以对该字段进行赋值。
> > `只读`:勾选后该字段将只读,如果不勾选则该字段默认是可写的。
![](https://img.kancloud.cn/c5/1c/c51c9969ae29a52fdff5f41785916ba4_1234x564.png)
### 12、隐藏域
12.1、添加评分控件,`参考`:1.1、添加单行文本控件
12.2、评分控件——`字段配置`
> `对象属性新增`【开启/关闭】参考【[2.2、添加字段]】
> `对象属性`:此属性用于绑定业务对象属性,用于提交数据绑定对象名称。
>
> > 注意:
> > 1)当子表单为多级子表业务对象且表单模式为弹窗或表内编辑模式时,设置当前子表单为多级表单。
> > 2)多级表单的上级表单必须存在,且表单模式为弹窗或表内编辑模式。
> `默认值`:设置后,此值将作为默认值显示在该字段的初始化值。
>
> > 如果不需要设置默认值,请将此处留空。
> > 默认值类型支持固定值、动态脚本、数据联动、公式计算等。
> `是否主键`:此属性用于标识主键字段,作为唯一标识。修改可能会数据错乱,请谨慎修改。
![](https://img.kancloud.cn/46/9b/469b56574875ee2e5818061f683a4148_1245x434.png)