1. 概述编辑
1.1 应用场景
1.1.1 填报应用
填报报表中可以通过该控件输入多行文本信息,录入填报的数据,如下图所示:
1.1.2 参数应用
参数面板处可以通过该控件输入多行文本信息,键入查询参数,如下图所示:
1.2 添加控件
1.2.1 填报应用
选中单元格后,点击右侧属性面板的控件设置,选择控件处下拉选择下拉复选框控件,如下图所示:
1.2.2 参数应用
将参数面板控件工具栏中的下拉复选框控件拖入到参数面板中,如下图所示:
2. 控件介绍编辑
2.1 控件属性
2.1.1 填报应用
下拉复选框控件的属性设置界面如下图所示:
各属性设置项的详细介绍如下:
控 件 名:通常与参数结合使用,通过控件名可以获得该控件,从而获得控件值传递给对应参数;或者通过控件名获得控件后通过 JS 设置控件的属性。
可 用:勾选后,填报时可正常输入文本信息;不勾选,填报时控件灰化,不可编辑。
可 见:勾选后,填报时控件可见;不勾选,填报时控件不可见。
水 印:填报时控件内会显示浅灰色水印文字,以提示用户需要输入的信息,当点击控件编辑区域后,水印消失。
允许为空:勾选后,允许控件为空值;不勾选,填报校验和提交时会提示:不能为空。
错误提示:用户可自定义不允许为空的提示信息。
填写规则:控件输入值需要符合的规则,如果不合规则,则提示错误信息,后面会详细介绍。
2.1.2 参数应用
下拉复选框控件的属性设置界面如下图所示:
各属性设置项的详细介绍如下:
控件名称:通常与参数结合使用,通过控件名可以获得该控件,从而获得控件值传递给对应参数;或者通过控件名获得控件后通过 JS 设置控件的属性。
可 用:勾选后,预览时可正常输入文本信息;不勾选,预览时控件灰化,不可编辑。
可 见:勾选后,预览时控件可见;不勾选,预览时控件不可见。
标签名称:标签名称的作用就是用来弥补参数界面中标签控件不支持的问题。
控 件 值 :控件默认显示的值,详细内容参见文档:控件默认值。
水 印:控件内会显示浅灰色水印文字,以提示用户需要输入的信息,当点击控件编辑区域后,水印消失。
字体大小:文本框中输入字体的大小。
允许为空:勾选后,允许控件为空值;不勾选,查询时会提示:不能为空。
错误提示:用户可自定义不允许为空的提示信息。
填写规则:控件输入值需要符合的规则,如果不合规则,则提示错误信息,后面会详细介绍。
控件位置:调整控件在参数面板中的位置。
控件大小:调整控件的大小。
2.2 校验
1)允许为空
可以不选择任何值
不选择任何值时可自定义错误提示。
2)允许直接编辑
:下拉复选框控件的编辑框里面允许直接输入值,并实现模糊查询,主要用于在下拉框中快速查找。
3)允许自定义值
:允许在下拉复选框中手动输入值,不一定要在下拉列表中有对应数据相匹配。
:不允许在下拉复选框中手动输入,只能在列表中选择。
2.3 高级
1)数据字典
通过 数据字典 来定义下拉复选框实际值与显示值。
2)去除重复数据
如下拉框控件。
3)标签形式显示
默认勾选,显示效果为:
若未勾选该功能,显示效果为:
4)返回值
(1)数组
,默认为返回数组。
返回值类型是数组型的效果是:["值 1","值 2","值 3"]。
(2)字符串
而字符串的返回值类型需要定义分隔符,开始符和结束符,即返回的字符串会根据分隔符,开始符和结束符进行显示。如分隔符,开始符和结束符分别定义成逗号,单引号和单引号的话,则返回值的效果是:'值 1,值 2,值 3'
注:① 如果下拉框中[显示值]有符号,比如说半角逗号,那么在使用下拉框的时候,默认的分隔符也为半角逗号,在解析的时候会混淆,所以需要修改默认的分隔符,与半角逗号不一样就行,也就是说下拉框这类控件的显示值中如果有符号,必须要保证显示值中的符号与控件的分隔符不一样。 ② 如果下拉框中[实际值]有符号,比如说半角单引号,那么在使用下拉框的时候,默认的起始符号为半角单引号,在解析的时候会导致数据集 SQL 混淆报错,需要修改默认的起始符号为半角双引号。
下拉复选框控件的使用示例请查看 下拉复选框控件示例