历史版本25 :日期控件 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 应用场景

1.1.1 填报应用

填报报表中可以通过该控件选择日期或日期时间,录入填报的数据,如下图所示:

2020-06-15_22-21-33.gif

1.1.2 参数应用

参数面板处可以通过该控件选择日期或日期时间,键入查询参数,如下图所示:

1572320222289639.gif

1.2 添加控件

1.2.1 填报应用

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

2020-06-15_21-38-40.png

1.2.2 参数应用

将参数面板控件工具栏中的日期控件拖入到参数面板中,如下图所示:

2020-06-15_21-43-13.png

2. 控件介绍编辑

2.1 控件属性

2.1.1 填报应用

日期控件的属性设置界面如下图所示:

2020-06-15_10-33-35.jpg

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

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

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

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

  • 格            式:日期控件的查询格式,分为日期型和时间型。日期型:用户可以在年月日的范围内定义查询日期格式;时间型:用户可以在年月日时分秒范围内定义查询日期格式。

  • 起  始  日  期:查询时输入的时间不能小于起始日期。

  • 结  束  日  期:查询时输入的时间不能大于结束日期。

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

  • 返回 值 类 型:需要跟数据库表中日期字段的类型匹配,有日期和字符串这两种。

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

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

  • 允许直接编辑:勾选后,用户可以直接输入值。

2.1.2 参数应用

日期控件的属性设置界面如下图所示:

2020-06-15_21-44-35.png

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

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

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

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

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

  • 控    件    值 :设定日期控件的默认显示值,有日期、公式、字段这三种格式,详细内容参见文档:控件默认值

  • 格            式:日期控件的查询格式,分为日期型和时间型。日期型:用户可以在年月日的范围内定义查询日期格式;时间型:用户可以在年月日时分秒范围内定义查询日期格式。

  • 起  始  日  期:查询时输入的时间不能小于起始日期。

  • 结  束  日  期:查询时输入的时间不能大于结束日期。

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

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

  • 返回 值 类 型:需要跟数据库表中日期字段的类型匹配,有日期和字符串这两种。

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

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

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

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

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

注1:起始日期和结束日期可以使用公式传递参数和单元格。

注2:设定了起始日期和结束日期后,不在范围内的数据将变成灰色不可选取状态。

2.2 校验

1)允许为空

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

2)允许直接编辑

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

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

2.3 注意事项

1)日期控件星期切换:

在 Web 端使用日期控件的时候,由于国内外对于一个星期的周期的差异化认识,会带来一些误操作,国外普遍认为一个星期从周日开始,国内普遍认为一个星期从周一开始,为了迎合国内外对于日期控件的习惯需求,FineReport 提供了日期控件星期切换的功能,在 Web 端选择日期控件的时候,点击周一即可将周一排在一个星期的第一天,点击周日即可将周日排在一个星期的第一天,如下图所示: