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

目录:

1. 概述编辑

适用场景:安装了「FineVis数据可视化」插件的用户,可参考本文了解 FineVis 的相关功能。

1.1 版本

报表服务器版本
插件版本功能变动
11.0.6V1.5.0新增组件分类「控件」,新增六种控件类型
11.0.6V1.8.0所有控件「内容>权限」取消「预览时可见」选项,通过组件图层实现隐藏控件。详情请参见 3.2 节
11.0.16V1.17.1新增「下拉树」、「视图树」控件

1.2 应用场景

在报表的具体应用中,经常使用「控件」来实现不同的功能,在普通报表、决策报表中应用广泛。

在 FVS 中,控件是作为组件直接添加到分页中使用的。同样支持组件属性:FVS组件动画 、FVS组件样式属性 。

本文将主要介绍「控件」在 FVS 中的其他通用属性。

1.3 视频教程

[helpvideo]3709[/helpvideo]

2. 控件类型编辑

控件类型简介
FVS文本框控件
模板预览时可在文本框中手动输入值,通过参数联动其他组件
FVS日期时间控件
模板预览时可选择日期时间,通过参数联动其他组件
FVS下拉框控件
模板预览时可下拉选择选项,通过参数联动其他组件
FVS下拉复选框控件
模板预览时可下拉选择选项,支持多选,通过参数联动其他组件
FVS单选按钮组控件
模板预览时可单选按钮选项,通过参数联动其他组件
FVS复选按钮组控件
模板预览时可多选按钮选项,通过参数联动其他组件
FVS下拉树控件
在模板预览时,下拉可展现具有多层树状结构的数据,并通过参数联动其他组件
FVS视图树控件
模板预览时,可通过视图树控件展现具有多层树状结构的数据,并通过参数联动其他组件

3. 功能说明编辑

3.1 控件名称

1)控件的名称用于绑定参数,所以当需要与其他组件实现参数联动时,需将控件名称设置为与参数相同。

例如用参数「area」表示地区,那么控件名称也需要设置为「area」。

2)控件名称不在「组件」配置面板中设置,而在「内容」配置面板中设置。如下图所示:

Snag_192b94a.png

3)同一分页中,不支持同名控件;不同分页中,支持同名控件,表示相同的参数。

3.2 控件隐藏或显示

V1.8.0 版本取消了所有控件的「预览时可见」设置项,统一通过「组件图层」实现隐藏组件。

如下图所示:

1655458825935041.png

4A24908F-8504-446B-9ABF-14FD649293F1.GIF

3.3 控件查询逻辑

1)在 FVS 中,控件在修改值后自动触发查询,与控件名参数相关的组件均会刷新,且对整个模板所有分页生效。

例如 页面1、页面2 均存在图表引用了 area 参数,那么在 页面1 中改变下拉框控件参数值,页面1 和 页面2 中图表均随之变化。

如下图所示:

01FEBAFC-F3CB-4668-9356-3D8F0065C2FC.GIF

2)不同分页中,若存在同名控件,那么视为同一个参数。

在模板预览时,任意分页上控件值改变,其他分页的同名控件也随之变化。

在模板编辑界面中,不同分页中同名控件的默认值会相互覆盖,以最后操作的控件默认值为准。

例如:

页面1、页面2 均有一个文本框控件,控件名称均设置为「area」。给 页面1 的文本框控件设置默认值为「华东」,页面2 中的文本框控件默认值也显示为「华东」;在 页面2 将控件默认值修改为「华北」,页面1 中控件默认值也将变为「华北」。

预览时同理。

FEC1A7BD-5381-4BC3-9099-55056BEBCF12.GIF

872FA018-64D9-47BD-AB8E-13FEAE106F5B.GIF

3.4 控件事件

FVS 控件目前支持的事件包括:初始化后事件、加载结束事件、点击事件。

点击事件初始化后事件编辑结束事件组件
支持支持不支持单选按钮组控件、复选按钮组控件
不支持支持支持文本框控件、日期时间控件、下拉框控件、下拉复选框控件

FVS 支持以下控件接口,更多内容可参考文档:控件通用 。

用法参考决策报表 body 中控件的用法,但需要将获取对象的接口 _g() 换成 duchamp 。

接口
说明示例
getValue获取控件的实际值

duchamp.getWidgetByName("控件名称").getValue();

getText获取控件的显示值duchamp.getWidgetByName("控件名称").getText();
setValue设置控件的值duchamp.getWidgetByName("控件名称").setValue('文本');
setVisible设置控件可见/不可见duchamp.getWidgetByName("控件名称").setVisible(false);
isVisible

返回控件状态是可见/不可见

返回 true 表示可见

返回 false 表示不可见

duchamp.getWidgetByName("控件名称").isVisible();
setEnable设置控件可用/不可用duchamp.getWidgetByName("控件名称").setEnable(false);
isEnabled

返回控件状态是可用/不可用

返回 true 表示可用

返回 false 表示不可用

duchamp.getWidgetByName("控件名称").isEnabled();
reset重置控件、清空控件的内容duchamp.getWidgetByName("控件名称").reset();
setWaterMark添加水印文字(仅支持有输入框的控件)

duchamp.getWidgetByName("控件名称").setWaterMark('我是水印');

更多内容请参考文档:FVS支持的JS接口场景

3.5 控件样式

在 FVS 模板中,点击顶部菜单栏「模板>模板主题」,可设置控件组件样式,对当前模板中所有控件生效。

详细介绍请参见文档:FVS模板主题

2022-06-29_10-37-13.png