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

目录:

1. 概述编辑

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

1.1 版本

报表服务器版本插件版本功能变动
11.0.16V1.x
V1.x 版本文档请参考:FVS视图树控件历史版本
11.0.16V2.0.0控件内容面板交互优化

1.2 功能简介

在模板预览时,可通过视图树控件展现具有多层树状结构的数据,并通过参数联动其他组件。效果如下图所示:

注:不支持移动端。

6C5E7FA5-F832-4F5C-9780-1F9FC52627C7.GIF

组件动画请参见:FVS组件动画 。

组件样式请参见:FVS组件样式属性 。控件名称在「内容」中设置。

2. 功能介绍编辑

2.1 控件内容

视图树控件可设置的内容如下图所示:

Snag_48cca76.png

各设置项的详细介绍如下表所示:

设置项
详细介绍
名称控件名称即参数名称,默认生成中文名称,需根据实际参数进行修改
字号视图树中显示文本的字号,默认为 12 px
数据字典

定义视图树实际值与显示值,有 3 种构建方式:自动构建、普通分层构建、极速分层构建

详情请参见:树控件构建方式 

选项开启多选:勾选后,可选择下拉树的多个选项;不勾选,只可选择下拉树的一个选项。默认不勾选

勾选后,是否勾选「结果只返回叶子节点」,会影响勾选父节点时是否自动选择子节点

  • 勾选时,勾选父节点时自动勾选所有子节点;勾选子节点时,父节点有色块填充

1690789031324210.png

  • 不勾选时,勾选父节点时不自动勾选子节点;勾选子节点时,父节点无色块填充

1690789039442146.png

异步展开树节点:节点加载逻辑,会影响性能,默认勾选

  • 勾选后,展开选项时只加载父节点的数据,所有子节点默认不展开,适用于数据量大的情况

1690788718431704.png

  • 不勾选,展开选项时所有子节点一次性展开,适用于数据量小的情况

1690788725717793.png

结果只返回叶子节点:下拉树是一种有层次结构的控件,每个最末端的叶子节点都有其完整的层次路径。默认只返回下拉树的叶子节点

如选择北京,返回值为:北京

1690788909423104.png


结果返回完整路径:下拉树是一种有层次结构的控件,每个最末端的叶子节点都有其完整的层次路径。勾选后即返回其完整的层次路径,返回值为数组类型。默认不勾选

勾选后,返回完整路径,如选择北京,返回值为:华北,北京,北京

Snag_398bea4c.png

返回值勾选「开启多选」且不勾选「结果返回完整路径」才有此设置项。用于设置多选下拉树返回值的格式,分为数组和字符串两种
  • 数组:返回值类型为数组型,例如:勾选三个值,返回值为:["值 1","值 2","值 3"]

  • 字符串:返回值类型为字符串,需要定义分隔符、开始符和结束符,即将勾选的多个值根据分隔符拼接成一个字符串。符号支持手动输入,或直接选择

         例如:分隔符定义为逗号,起始符和结束符均定义为单引号,返回值为 '值1,值2,值3'

Snag_49039db.png

默认值
可设置视图树控件显示的默认值,有如下 3 种类型:

1)自定义字符串:可直接输入文本

  • 例如:要选中北京,写「华北,北京,北京」,子父节点用 , 隔开

1690527731910578.png


  • 若开启了多选,要写多个值时,例如选中北京和上海,写「华北,北京,北京;华东,上海,上海」,子父节点用 , 隔开,值之间用 ; 隔开

1690529017509679.png


2)字段:可选择数据集中字段,若字段值符合多个值写法,且开启了多选,则默认值会多选

1690529483913677.png


3)公式:点击右侧 fx 输入公式,例如获取「表格1」组件 A1 单元格的值 =表格1~A1,或者 =[[1,11,111],[1,11,112]]


1690530390338974.png

校验空值校验:是否允许控件为空值。默认勾选
  • 勾选后,允许控件为空值;

  • 不勾选,可设置校验提示文字,模板预览时若控件为空,则显示提示文字。

2.2 控件交互事件

点击「交互>添加事件」,可添加 JavaScript 事件实现更多效果。视图树控件支持「初始化后事件」和「编辑结束事件」。如下图所示:

Snag_398f63c4.png

点击具体的某一个事件,会弹出 JavaScript 事件设置框。如下图所示:

注:关于 FVS 支持的 JavaScript 可参考文档 FVS支持的JS接口场景 。

1690789157962171.png

3. 后续步骤编辑

关于树控件的实际应用及模板下载请参考文档:树控件构建方式 。