控件简介

1.1 版本

1.2 应用场景

在报表的具体应用中，经常使用「控件」来实现不同的功能。根据使用方式可将控件分为填报控件和参数控件两大类，填报时使用的控件为填报控件，参数界面使用的控件为参数控件，这两种控件的类型基本相同，只是在使用方面略微有所不同。本文整理控件相关文档，用户可根据本文快速查找所需控件文档。

注：控件事件具体介绍请参见：控件事件

控件类型详细统计如下表所示：

注1：参数面板中，所有控件以及插件类的「控件名称」均不支持为空或重复。

注2：控件的「属性」设置界面，所有输入框类型的位置都不支持写 HTML ，如 

1）在使用参数控件时，当已经完成全局参数、模板参数或数据集参数设置后，编辑参数面板，选择全部添加即可添加与参数绑定的参数控件，如下图所示：

2）编辑参数面板，选择需要的控件，设置参数控件的名称为对应的参数名也可以完成控件与参数绑定。例如：设置模板参数为货主地区，编辑参数面板，拖入下拉框控件，设置控件名称为货主地区。如下图所示：

3）填报控件与参数绑定示例可参考：JS实现使用填报页面的控件查询 。

4.1 浏览器推荐

推荐使用谷歌内核浏览器或者高版本的ie浏览器，比如Google Chrome、Microsoft Edge、IE11等。对于低版本IE浏览器，比如IE8和IE兼容模式，部分控件相关功能可能无法使用。

4.2 数据字典联动会清空控件值

当前功能设计下，控件在触发数据字典联动时，会清空被联动控件的值。

4.3 有控件值的参数面板控件在初始化时就会计算数据字典

带有数据字典设置的参数面板控件，如果没有默认值，则其数据字典会在点击控件触发选项时才会计算；如果有默认值，则在控件初始化的时候就会计算数据字典。所以当数据字典的 sql 执行速度较慢的情况下，设置默认值会对模板整体加载速度有明显影响。

4.4 文本和数字控件输入不符合校验规则的值后，会返回上一次输入的值

设置了校验规则的文本或者数字控件，当输入值不符合规则的时候，会有相应提示，并且当前输入值会被清空，返回上一次输入的值。

4.5 控件数据字典的数字丢失精度

问题描述

注：11.0.6 及之后的版本，控件的数据字典数字类型精度更加准确，不会再出现以下问题。

当控件数据字典使用的字段类型为数字类型时，例如 bigint，有可能会出现丢失精度的问题，如图所示：

解决方案

需要将数字类型转为字符串类型，例如下图所示在 sql 中进行转换。