【仪表板-插件开发】插件开发中功能合集demo

插件开发，是每个同学对wyn深入研究后都必须掌握的一门技能，之类为大家介绍一下，插件开发中的一些基础功能，以及demo示例。

版本号	文档内容	下载demo
V1.0	插件示例	柱状图.zip (1.02 MB, 下载次数: 981) 2022-7-21 10:54 上传 点击文件名下载附件 插件示例

一、visual.json 文件介绍

name：插件名称

externalJs：需要引入的外部js，可以通过{{参数名}}获取配置中的参数

Configuration：扩展参数

配置字段内容获取

二、webpack.config.js

设置外部引用包里面的js对象名称，可以在 visual.ts 文件中引用

外部扩展js插件引用方式：

三、package.json

Version：设置插件版本号

四、assets

可以在里面定义一些图片资源，使用时返回base64文件，用资源图片时，需要在visual.json 中定义名称映射

获取图片内容：

五、capabilities.json 属性设置，数据字段配置

1．dataBinding数据绑定

（1）dataRoles

name: 属性名称

displayNameKey: 显示名称

kind:

grouping：用于度量字段的分类或分组。

value：数值数据。

groupingOrValue：可用作度量也可以用作分组。

options：format 格式化，displayUnit 数据单位，enum 自定义下拉框，（使用方式后面详细介绍）

（2）dataViewMappings，conditions

设置数据绑定的最大，最小数量。

conditions 组合条件，｛｝，｛｝属于或者关系，下面示例中可以理解为：

① numeric 没有绑定字段，category 绑定数量无限制。

② numeric 若绑定数据，则category 最多只能绑定一个字段。

2．options->visual 组件属性设置（使用方式后面详细介绍）

开启数据联动，只有开启数据联动后，才可以实现组件之间数据联动

设置后显示内容：

3．actions 设置组件按钮，详细介绍请参考

https://help.grapecity.com.cn/display/wyn600/Actions

六、visual.ts 文件

1．IVisualUpdateOption 属性对象

isViewer：表示在预览仪表板时是否呈现该组件。

isMobile:：表示是否在移动端显示该组件。

isEditing：表示组件的编辑状态。当触发了编辑操作时，值为true。

isFocus: 表示组件的聚焦状态。当触发了聚焦操作时，值为true。

dataViews: 在capabilities.json中定义的计算数据视图(dataViewMapping)。

properties: 在 capabilities.json 中定义的属性模型（options.visual）。

docTheme: 选择的文档主题。

language: 当前语言。

scale: 比例因子。

filters: 用来影响其他组件。

2．获取属性设置内容

3．组件排序，此代码完成排序功能

4．数据联动，点击实现仪表板数据互动

（1）设置字段

（2）获取联动item合集

此功能调试代码查看

5．联动钻取，跳转

参考代码：bindEvents() 方法

6．数据格式化

参考方法：formatData

7．自定义设置

具体参考 number_formatting 方法

8．按钮显示隐藏

更多更详细内容，请参考demo示例