反馈已提交

网络繁忙

FVS控件组件

  • 文档创建者:Alicehyy
  • 历史版本:9
  • 最近更新:Alicehyy 于 2023-10-23
  • 1. 概述

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

    1.1 版本

    报表服务器版本
    插件版本功能变动
    11.0.6V1.xV1.x 版本文档请参考:FVS控件组件历史版本
    11.0.16V2.0.1控件组件新增样式设置,可实现更丰富的样式效果,详情参见 3.5 节

    1.2 应用场景

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

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

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

    1.3 视频教程

    2. 控件类型

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

    3. 功能说明

    3.1 控件名称

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

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

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

    Snag_2ab4e682.png

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

    3.2 控件隐藏或显示

    控件的显示或隐藏统一通过「组件图层」实现。如下图所示:

    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 控件样式

    3.5.1 单独控件样式

    V2.0.1 版本所有控件新增「内容样式」,不同的控件内容样式也有些许不同,可到具体文档查看详情。

    最基础的字符样式设置所有控件均支持,例如下图所示:

    Snag_2ab8404c.png

    例如单选按钮组控件,还支持设置样式模板,如下图所示:

    Snag_2aba2fa8.png

    另外 V2.0.1 版本中,组件边框背景支持了「边框线」设置,可设置边框线类型、粗细及颜色。如下图所示:

    Snag_2abd372c.png

    3.5.2 模板整体控件样式

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

    且若控件修改了「内容样式」,在模板主题中设置了控件组件样式后,控件字符颜色会跟随主题变化,需再次设置。因此建议先设置模板主题,再单独修改控件内容样式。

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

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

    附件列表


    主题: FineVis数据可视化
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持