1. 概述
1.1 版本
| 报表服务器版本 | App 版本 | 功能变更 |
|---|---|---|
| 11.0 | - | - |
| 11.0.2 | 11.0.54 | App 支持文本控件 NFC 读卡输入 |
| 11.0.21 | 11.0.85 | 「文本控件」移动端新增「允许一键清空」功能 |
| 11.0.30 | 11.0.94 | 标签名称支持使用公式，详情参见 2.1.2 节 |
1.2 应用场景
1.2.1 填报控件
填报报表中可以通过该控件输入文本信息，录入填报的数据，如下图所示：
1.2.2 参数控件
参数面板处可以通过该控件输入文本信息，键入查询参数，如下图所示：
1.3 如何添加
1.3.1 填报控件
选中单元格后，点击右侧属性面板的「控件设置」，「选择控件」处下拉选择「文本控件」，如下图所示：
1.3.2 参数控件
将参数面板控件工具栏中的「文本控件」拖入到参数面板中，如下图所示：
2. 控件介绍
控件有属性、事件、移动端三个设置界面，包括了控件的一些常规设置项。
2.1 属性
属性设置界面包括了控件的所有基本属性，可以通过勾选、输入、选择等方式配置或修改。
2.1.1 填报控件
「文本控件」的属性设置界面如下图所示：
各属性设置项的详细介绍如下：
注：「文件控件」在填报应用时，可通过在单元格中添加值的方式设置默认值。
| 分类 | 设置项 | 详细介绍 | |
|---|---|---|---|
| 基本 | 控件名称 | 控件的名称，手动输入，通常与参数结合使用，如通过控件名获取控件后将控件值传递给对应参数，默认为空。 | |
| 可 用 | 控件是否可用，勾选后，填报时控件可编辑；不勾选，填报时控件灰化，不可编辑，默认勾选。 | ||
| 可 见 | 控件是否可见，勾选后，填报时页面显示控件；不勾选，填报时页面不显示控件，默认勾选。 | ||
| 高级 | 水 印 | 填报时控件内显示的浅灰色水印文字，手动输入，以提示用户需要输入的信息，点击控件编辑区域后消失，默认为空。 | |
| 校验 | 允许为空 | 是否允许控件为空值，勾选后，允许控件为空值；不勾选，填报校验和提交时会提示，默认勾选。 | |
| 错误提示 | 不勾选「允许为空」时出现的设置项，可自定义提示信息。默认情况下将显示：不能为空 | ||
| 填写规则 | 控件输入值需要符合的规则，若不符合规则，则提示错误信息。 支持的校验规则共有 8 种，如下： 1）无：没有规则。 2）长度：校验文本长度，可以自定义出错提示。 3）邮箱：校验邮箱地址格式，可以自定义出错提示。 4）身份证：，可以自定义出错提示。 5）邮编：校验邮政编码长度，可以自定义出错提示。 6）电话：校验固定电话号码格式，有预定义格式，选择即可，可以自定义出错提示。 7）手机：校验手机号码长度，可以自定义出错提示。 8）自定义：通过「正则表达式」自定义校验规则，详细内容参见文档：正则表达式定义规则 默认为无。 | ||
2.1.2 参数控件
「文本控件」的属性设置界面如下图所示：
各属性设置项的详细介绍如下：
| 分类 | 设置项 | 详细介绍 | ||
|---|---|---|---|---|
| 基本 | 控件名称 | 控件的名称，手动输入，通常与参数结合使用，如通过控件名获取控件后将控件值传递给对应参数，默认为 textEditor# 。 | ||
| 可 用 | 控件是否可用，勾选后，填报时控件可编辑；不勾选，填报时控件灰化，不可编辑，默认勾选。 | |||
| 可 见 | 控件是否可见，勾选后，填报时页面显示控件；不勾选，填报时页面不显示控件，默认勾选。 | |||
| 高级 | 标签名称 | 控件的标签属性是用在移动端的，移动端不支持参数面板上的「标签控件」，识别的是普通控件的「标签名称」属性，所以移动端可以用控件的标签名称来实现标签。 FineReport 11.0.30 及以上版本，标签名称支持使用公式。编辑框内输入公式文本（等号开头），自动计算公式结果作为最终标签名称。 注：使用 i18n 函数实现标签名称根据语言显示时，多语言插件需更新至 V2.2.2 版本。若模板中使用的 key (模板内或平台内的 key )更新，需手动刷新模板才可生效。 | ||
| 控 件 值 | 控件初始化时的默认值，支持字符串、字段、公式，默认为空。 字符串：字符文字，例如：华北
字段：数据集字段，数据集包括模板数据集和服务器数据集。例如：数据集 ds1 的地区字段
公式：设计器支持的公式，例如： A1 单元格的值
| |||
| 水 印 | 填报时控件内显示的浅灰色水印文字，手动输入，以提示用户需要输入的信息，点击控件编辑区域后消失，默认为空。 | |||
| 字体大小 | 文本框中输入的字体的大小，默认为12 。 注：此功能不支持移动端。 | |||
| 校验 | 允许为空 | 是否允许控件为空值，勾选后，允许控件为空值；不勾选，填报校验和提交时会提示，默认勾选。 | ||
| 错误提示 | 不勾选「允许为空」时出现的设置项，可自定义提示信息。默认情况下将显示：不能为空 | |||
| 填写规则 | 控件输入值需要符合的规则，若不符合规则，则提示错误信息。 支持的校验规则共有 8 种，如下： 1）无：没有规则。 2）长度：校验文本长度，可以自定义出错提示。 3）邮箱：校验邮箱地址格式，可以自定义出错提示。 4）身份证：校验是否是标准身份证格式，可以自定义出错提示。 5）邮编：校验邮政编码长度，可以自定义出错提示。 6）电话：校验固定电话号码格式，有预定义格式，选择即可，可以自定义出错提示。 7）手机：校验手机号码长度，可以自定义出错提示。 8）自定义：通过「正则表达式」自定义校验规则，详细内容参见文档：正则表达式定义规则 默认为无。 | |||
| 坐标.尺寸 | 控件位置 | 控件在参数面板中的位置，通过横纵坐标调整，坐标会根据控件在参数面板中的位置自动显示。 | ||
| 控件大小 | 控件的大小，通过宽度、高度调整，若通过拖拽调整，高宽度也随着自动调整。 | |||
2.2 事件
事件设置界面可以为控件添加事件实现某些效果，「文本控件」支持的事件有初始化后、编辑前、编辑后、编辑结束。如下图所示：
选择一种事件类型后，即可添加事件内容，「文本控件」支持的事件响应方式有 JavaScript 脚本、提交入库、发送邮件。如下图所示：
选择对应的事件响应方式添加即可，不同响应方式区别可参考：事件响应方式
2.3 移动端
「文本控件」支持移动端手动输入，扫码输入，App NFC读卡输入，以及一键清空。如下图所示：
高级：
手动输入：选择后，允许手动输入。
扫码输入：选择后，允许扫码输入。
NFC读卡输入：选择后，允许 App 模板读卡输入，分为卡片内容和UID两项，详情可参考：[App]移动端NFC读卡输入信息
允许一键清空：选择后，允许对输入的内容一键删除。
若设置移动端扫码输入效果如下图所示：
注：用户使用移动端扫码前请注意以下事项：
1）HTML5 下扫码只支持微信/钉钉集成的场景，且需要做单点登录和域名校验，详情可查看 微信集成后文件控件&文本控件扫码无法使用 。
2）不支持浏览器扫码，浏览器扫码时会提示当前浏览器不支持扫码。
3）APP 扫码预览时，APP 登录的服务器和扫码的服务器相同才会显示 APP 效果，可以扫码；否则提示当前浏览器无法扫码。
4）用户扫码时注意允许开启相机权限，否则相机权限未授权则不能扫码。
3. 应用示例
文本控件的应用，可参见以下文档：
| 应用场景 | 实际效果 |
|---|---|
| 场景描述： 使用文本控件，用户可以在输入空值时查询全部数据，输入单值时查询该值对应数据，输入范围（用任意字符分隔两个数字即可）时查询范围内数据。 参考文档： | |
场景描述： 使用文本控件进行模糊查询，在对报表进行模糊查询的时候，可以设置查询出来的数据列中，高亮显示模糊关键字 参考文档： | |
场景描述： 当数据库中某张表有时间字段，且几乎每分每秒都会有一条数据生成，为减少报表显示数据量，可以通过时间间隔来筛选数据，仅显示部分数据。 参考文档： | |
