1. 概述
1.1 版本
| 报表服务器版本 | 插件版本 | 功能变更 |
|---|---|---|
| 11.0.5 | V1.0 | - |
1.2 应用场景
安装此插件预览后可实现选择日期区间，可在普通报表、决策报表中使用。如下图所示：
1.3 功能描述
预览时支持点击日期选择开始日期、结束日期，同时支持点击底部快捷按钮选择开始日期、结束日期。
快捷按钮说明如下表所示：
| 按钮名称 | 说明 |
|---|---|
| 清空 | 清空所选日期 |
| 今天 | 开始日期、结束日期均为今天 |
| 昨天 | 开始日期、结束日期均为昨天 |
| 本月 | 本月 1 号到本月最后一天 |
| 上月 | 上月 1 号到上月最后一天 |
| 本季度 | 本季度 1 号到本季度最后一天 |
| 上季度 | 上季度 1 号到上季度最后一天 |
| 当年 | 当年 1 月 1 号到今天 |
| 去年 | 去年 1 月 1 号到 12 月 31 号 |
2. 插件介绍
2.1 插件安装
点击下载插件：日期区间控件
设计器插件安装方法请参见：设计器插件管理
服务器安装插件方法请参见：服务器插件管理
安装插件后需要重启才能生效
2.2 如何添加
2.2.1 参数控件
安装此插件后，将参数面板控件工具栏中的「日期区间控件」拖入到参数面板中。如下图所示：
2.2.2 填报控件
安装此插件后，选中单元格，点击右侧属性面板的「控件设置」，选择控件处下拉选择「日期区间控件」。如下图所示：
2.3 属性
2.3.1 参数控件
日期区间控件为参数控件时的属性界面，如下图所示：
各设置项及其说明如下表所示：
| 设置项 | 说明 | |
|---|---|---|
| 基本 | 控件名称 | 控件的名称，手动输入，通常与参数结合使用，如通过控件名获取控件后将控件值传递给对应参数，默认为 vueDateEditor0 |
| 可用 | 控件是否可用，勾选后，预览页面控件可用；不勾选，预览页面控件灰化，不可用，默认勾选 | |
| 可见 | 控件是否可见，勾选后，预览页面显示控件；不勾选，预览页面不显示控件，默认勾选 | |
| 坐标.尺寸 | 控件位置 | 控件在参数面板中的位置，通过横纵坐标调整，坐标会根据控件在参数面板中的位置自动显示 |
| 控件大小 | 控件的大小，通过宽度、高度调整，若通过拖拽调整，高宽度也随着自动调整 | |
2.3.2 填报控件
日期区间控件为填报控件时的属性界面，如下图所示：
各设置项及其说明如下表所示：
| 设置项 | 说明 | |
|---|---|---|
| 基本 | 控件名称 | 控件的名称，手动输入，通常与参数结合使用，如通过控件名获取控件后将控件值传递给对应参数，默认为 无 |
| 可用 | 控件是否可用，勾选后，填报预览页面控件可用；不勾选，填报预览页面控件灰化，不可用，默认勾选 | |
| 可见 | 控件是否可见，勾选后，填报预览页面显示控件；不勾选，填报预览页面不显示控件，默认勾选 | |
2.4 事件
事件设置界面可以为控件添加事件实现某些效果，「日期区间控件」支持的事件有初始化后、编辑后、编辑结束。如下图所示：
选择一种事件类型后，即可添加事件内容，「日期控件」支持的事件响应方式有 JavaScript 脚本、提交入库、发送邮件。如下图所示：
选择对应的事件响应方式添加即可，不同响应方式区别可参考：事件响应方式
2.5 移动端
移动端无可配置项。
