历史版本18 :下拉复选框控件 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 应用场景

1.1.1 填报应用

填报报表中可以通过该控件下拉选择多个选项信息,录入填报的数据,如下图所示:

2020-06-10_22-35-57.gif

1.1.2 参数应用

参数面板处可以通过该控件下拉选择多个选项信息,键入查询参数,如下图所示:

2020-06-10_22-30-14.gif

1.2 添加控件

1.2.1 填报应用

选中单元格后,点击右侧属性面板的控件设置选择控件处下拉选择下拉复选框控件,如下图所示:

2020-06-10_20-11-52.jpg

1.2.2 参数应用

将参数面板控件工具栏中的下拉复选框控件拖入到参数面板中,如下图所示:

2020-06-10_20-15-46.jpg

2. 控件介绍编辑

2.1 控件属性

2.1.1 填报应用

下拉复选框控件的属性设置界面如下图所示:

2020-06-10_22-14-25.png

各属性设置项的详细介绍如下:

  • 控  件  名:通常与参数结合使用,通过控件名可以获得该控件,从而获得控件值传递给对应参数;或者通过控件名获得控件后通过 JS 设置控件的属性。

  • 可       用:勾选后,填报时可正常输入文本信息;不勾选,填报时控件灰化,不可编辑。

  • 可       见:勾选后,填报时控件可见;不勾选,填报时控件不可见。

  • 水       印:填报时控件内会显示浅灰色水印文字,以提示用户需要输入的信息,当点击控件编辑区域后,水印消失。

  • 标签形式显示:控制多选按钮的显示特效,默认勾选。

  • 数据字典:数据字典可以定义下拉框实际值与显示值,详细内容参见文档:数据字典

  • 返回值类型:分为数组和字符串两种。

  • 允许为空:勾选后,允许控件为空值;不勾选,填报校验和提交时会提示:不能为空

  • 错误提示:用户可自定义不允许为空的提示信息。

  • 允许直接编辑:勾选后,用户可以直接输入值,实现模糊查询。

  • 允许自定义值:勾选后,用户手动输入的值可以不包含在下拉菜单选项中;不勾选,用户手动输入的值必须是下拉菜单选项中的值,若输入的值不属于下拉菜单选中,查询时,会提示:值不在下拉列表内

2.1.2 参数应用

下拉复选框控件的属性设置界面如下图所示:

2020-06-10_20-19-32.jpg

各属性设置项的详细介绍如下:

  • 组件名称:通常与参数结合使用,通过控件名可以获得该控件,从而获得控件值传递给对应参数;或者通过控件名获得控件后通过 JS 设置控件的属性。

  • 可       用:勾选后,预览时可正常输入文本信息;不勾选,预览时控件灰化,不可编辑。

  • 可       见:勾选后,预览时控件可见;不勾选,预览时控件不可见。

  • 标签名称:标签名称的作用就是用来弥补参数界面中标签控件不支持的问题。

  • 控 件 值 :控件默认显示的值,详细内容参见文档:控件默认值

  • 数据字典:数据字典可以定义下拉框实际值与显示值,详细内容参见文档:数据字典

  • 去除重复项:勾选后,会将下拉菜单中相同的项合并;不勾选,会保留下拉菜单中重复的选项。

  • 水      印:控件内会显示浅灰色水印文字,以提示用户需要输入的信息,当点击控件编辑区域后,水印消失。

  • 字体大小:文本框中输入字体的大小。

  • 标签形式显示:控制多选按钮的显示特效,默认勾选。

  • 返回值类型:分为数组和字符串两种,后面会详细介绍。

  • 允许为空:勾选后,允许控件为空值;不勾选,查询时会提示:不能为空

  • 错误提示:用户可自定义不允许为空的提示信息。

  • 允许直接编辑:勾选后,用户可以直接输入值,实现模糊查询。

  • 允许自定义值:勾选后,用户手动输入的值可以不包含在下拉菜单选项中;不勾选,用户手动输入的值必须是下拉菜单选项中的值,若输入的值不属于下拉菜单选中,查询时,会提示:值不在下拉列表内

  • 组件位置:调整控件在参数面板中的位置。

  • 组件大小:调整控件的大小。

2.2 校验

1)允许为空

勾选后,可以不选择任何值;不勾选,不选择任何值时可自定义错误提示,如下图所示:

2)允许直接编辑

下拉复选框控件的编辑框里面允许直接输入值,并实现模糊查询,主要用于在下拉框中快速查找,如下图所示:

2020-06-11_11-37-18.jpg

3)允许自定义值

允许在下拉复选框中手动输入值,不一定要在下拉列表中有对应数据相匹配。不允许在下拉复选框中手动输入,只能在列表中选择,如下图所示:

2020-06-11_11-37-41.jpg

2.3 高级

1)数据字典

通过数据字典来定义下拉复选框实际值与显示值,可参考文档数据字典,如下图所示:

2020-06-11_11-26-38.jpg

注1:下拉框实现的是异步加载功能,即每次加载 500 条数据,因此若是大数据量的表就不会出现下拉框一直处在正在加载的情况了。同样下拉复选框与下拉树也是异步加载数据。

注2:若下拉框数据量大且重复数据多的话,建议在定义下拉框数据字典时,在数据集或者公式处直接取出不重复的数据,以提高性能。

2)去除重复项

勾选后,会将下拉菜单中相同的项合并;不勾选,会保留重复的选项,如下图所示:

2020-06-11_11-29-14.jpg

3)标签形式显示

  • 默认勾选,显示效果如下图所示:

    

    

  • 不勾选,显示效果如下图所示:

    

    

4)返回值

  • 数组

返回数组,返回值类型是数组型的效果是:["值 1","值 2","值 3"],如下图所示:

  • 字符串

字符串的返回值类型需要定义分隔符,开始符和结束符,即返回的字符串会根据分隔符,开始符和结束符进行显示。如分隔符,开始符和结束符分别定义成逗号,单引号和单引号的话,则返回值的效果是:'值 1,值 2,值 3',如下图所示:

注1:如果下拉框中[显示值]有符号,比如说半角逗号,那么在使用下拉框的时候,默认的分隔符也为半角逗号,在解析的时候会混淆,所以需要修改默认的分隔符,与半角逗号不一样就行,也就是说下拉框这类控件的显示值中如果有符号,必须要保证显示值中的符号与控件的分隔符不一样。 

注2:如果下拉框中[实际值]有符号,比如说半角单引号,那么在使用下拉框的时候,默认的起始符号为半角单引号,在解析的时候会导致数据集 SQL 混淆报错,需要修改默认的起始符号为半角双引号。