1. 概述编辑
1.1 应用场景
1.1.1 填报应用
填报报表中可以通过该控件输入数字信息(整数、负数、小数),录入填报的数据,如下图所示:
1.1.2 参数应用
参数面板处可以通过该控件输入数字信息(整数、负数、小数),键入查询参数,如下图所示:
1.2 添加控件
1.2.1 填报应用
选中单元格后,点击右侧属性面板的控件设置,选择控件处下拉选择数字控件,如下图所示:
1.2.2 参数应用
将参数面板控件工具栏中的数字控件拖入到参数面板中,如下图所示:
2. 控件介绍编辑
2.1 控件属性
2.1.1 填报应用
数字控件的属性设置界面如下图所示:
各属性设置项的详细介绍如下:
控 件 名:通常与参数结合使用,通过控件名可以获得该控件,从而获得控件值传递给对应参数;或者通过控件名获得控件后通过 JS 设置控件的属性。
可 用:勾选后,填报时可正常输入文本信息;不勾选,填报时控件灰化,不可编辑。
可 见:勾选后,填报时控件可见;不勾选,填报时控件不可见。
水 印:填报时控件内会显示浅灰色水印文字,以提示用户需要输入的信息,当点击控件编辑区域后,水印消失。
允许为空:勾选后,允许控件为空值;不勾选,填报校验和提交时会提示:不能为空。
错误提示:用户可自定义不允许为空的提示信息。
允许为空:勾选后,允许控件为空值;不勾选,查询时会提示:不能为空。
错误提示:用户可自定义不允许为空的提示信息。
允许小数:控件输入值需要符合的规则,如果不合规则,则提示错误信息,后面会详细介绍。
允许小数:勾选后,允许控件为小数;不勾选,输入框无法输入小数点。
小数位数:需要输入最大小数位数,默认为 16 。
允许负数:勾选后,允许控件为负数;不勾选,输入框无法输入负数。
需要最大值:勾选后,若超出最大值,当单元格失去焦点时,弹出错误提示:值大于允许输入的最大值。
需要最小值:勾选后,若超出最小值,当单元格失去焦点时,弹出错误提示:值小于允许输入的最小值。
错误提示:勾选最大值或最小值,若超出最大值或超出最小值,可设置统一的错误提示:超出设置范围。
2.1.2 参数应用
数字控件的属性设置界面如下图所示:
各属性设置项的详细介绍如下:
控件名称:通常与参数结合使用,通过控件名可以获得该控件,从而获得控件值传递给对应参数;或者通过控件名获得控件后通过 JS 设置控件的属性。
可 用:勾选后,预览时可正常输入文本信息;不勾选,预览时控件灰化,不可编辑。
可 见:勾选后,预览时控件可见;不勾选,预览时控件不可见。
标签名称:标签名称的作用就是用来弥补参数界面中标签控件不支持的问题。
控 件 值 :控件默认显示的值,详细内容参见文档:控件默认值。
水 印:控件内会显示浅灰色水印文字,以提示用户需要输入的信息,当点击控件编辑区域后,水印消失。
字体大小:文本框中输入字体的大小。
允许为空:勾选后,允许控件为空值;不勾选,查询时会提示:不能为空。
错误提示:用户可自定义不允许为空的提示信息。
允许小数:勾选后,允许控件为小数;不勾选,输入框无法输入小数点。
小数位数:需要输入最大小数位数,默认为 16 。
允许负数:勾选后,允许控件为负数;不勾选,输入框无法输入负数。
需要最大值:勾选后,若超出最大值,当单元格失去焦点时,弹出错误提示:值大于允许输入的最大值。
需要最小值:勾选后,若超出最小值,当单元格失去焦点时,弹出错误提示:值小于允许输入的最小值。
错误提示:勾选最大值或最小值,若超出最大值或超出最小值,可设置统一的错误提示:超出设置范围。
控件位置:调整控件在参数面板中的位置。
控件大小:调整控件的大小。
注:数字控件控件值为双精度型,它是具有更高精度的一种数据型数据,可表示的正数范围是:4.94065645841247*10^-324~1.79769313486232*10^308,可表示的负数范围是:-1.79769313486232*10^308~-4.94065645841247*10^-324。双精度型数据最多可以有15位有效数字。
2.2 校验
校验是指控件中的输入值需要符合一定规则,如果不符合规则,则提示错误信息。
数字控件的检验规则共有5种,详细介绍如下:
1)允许为空:默认勾选允许为空,允许控件为空值;不勾选,查询时会提示:不能为空。
2)允许小数:默认勾选允许小数,需要输入最大小数位数,默认为 16 。
3)允许负数:允许输入负值,默认勾选允许负值。
4)最大值:保存模板,选择填报预览,若超出最大值,当单元格失去焦点时,弹出错误提示:值大于允许输入的最大值10。
5)最小值:保存模板,选择填报预览,若超出最小值,当单元格失去焦点时,弹出错误提示:值小于允许输入的最小值5。
注:设置最大值或最小值后,若超出最大值或超出最小值,可设置统一的错误提示:超出设置范围。