找回密码
 立即注册

QQ登录

只需一步,快速开始

@Martin.Zhang
超级版主   /  发表于:2022-7-21 10:54  /   查看:1470  /  回复:0
本帖最后由 Bella.Yuan 于 2023-1-5 18:09 编辑

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


版本号
文档内容
下载demo
V1.0
插件示例
柱状图.zip (1.02 MB, 下载次数: 526)

一、visual.json 文件介绍

image.png20695189.png

name:插件名称
externalJs:需要引入的外部js,可以通过{{参数名}}获取配置中的参数
Configuration:扩展参数
image.png388198851.png
配置字段内容获取
image.png749388122.png
二、webpack.config.js
设置外部引用包里面的js对象名称,可以在 visual.ts 文件中引用
image.png405661620.png
外部扩展js插件引用方式:
image.png506299132.png
三、package.json
Version:设置插件版本号
image.png450013427.png
四、assets
可以在里面定义一些图片资源,使用时返回base64文件,用资源图片时,需要在visual.json 中定义名称映射
image.png868394775.png
获取图片内容:
image.png144475401.png
五、capabilities.json 属性设置,数据字段配置
1.dataBinding数据绑定
(1)dataRoles
name: 属性名称
displayNameKey: 显示名称
kind:
grouping:用于度量字段的分类或分组。
value:数值数据。
groupingOrValue:可用作度量也可以用作分组。
optionsformat 格式化,displayUnit 数据单位,enum 自定义下拉框,(使用方式后面详细介绍)
image.png227801207.png

(2)dataViewMappings,conditions
设置数据绑定的最大,最小数量。
conditions 组合条件,{},{}属于或者关系,下面示例中可以理解为:
① numeric 没有绑定字段,category 绑定数量无限制。
② numeric 若绑定数据,则category 最多只能绑定一个字段。
image.png23081969.png
2.options->visual 组件属性设置(使用方式后面详细介绍)
image.png746548156.png image.png467627257.png
开启数据联动,只有开启数据联动后,才可以实现组件之间数据联动
设置后显示内容:
image.png574246825.png
3.actions 设置组件按钮,详细介绍请参考
image.png712226867.png
六、visual.ts 文件
1.IVisualUpdateOption 属性对象
image.png311338500.png
isViewer:表示在预览仪表板时是否呈现该组件。
isMobile::表示是否在移动端显示该组件。
isEditing:表示组件的编辑状态。当触发了编辑操作时,值为true
isFocus: 表示组件的聚焦状态。当触发了聚焦操作时,值为true
dataViews: capabilities.json中定义的计算数据视图(dataViewMapping)
properties: capabilities.json 中定义的属性模型(options.visual)。
docTheme: 选择的文档主题。
language: 当前语言。
scale: 比例因子。
filters: 用来影响其他组件。
2.获取属性设置内容
image.png111513670.png
3.组件排序,此代码完成排序功能
image.png895132751.png
image.png313815917.png
4.数据联动,点击实现仪表板数据互动
(1)设置字段
image.png800416869.png
(2)获取联动item合集
image.png782319640.png
此功能调试代码查看
5.联动钻取,跳转
image.png120154418.png

参考代码:bindEvents() 方法
image.png570047301.png

6.数据格式化
参考方法:formatData
image.png522613830.png

7.自定义设置
具体参考 number_formatting 方法
image.png995256652.png
image.png48430174.png
8.按钮显示隐藏

image.png104595030.png

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

0 个回复

您需要登录后才可以回帖 登录 | 立即注册
返回顶部