仪表盘

文档基于仪表盘v1.0.3版本

组件说明

仪表盘是一个半圆形的指标指示图，给定数据范围，通过仪表盘的形式显示不同范围内数据的组件。

效果案例

一、样式

在样式中可以设置组件的基本属性、表盘、指标、动画和圆环颜色。

1、基本属性

位置尺寸

位置包括组件的横坐标和纵坐标，单位为px；横坐标为组件左上角距离页面左边界的像素距离，纵坐标为组件左上角距离页面上边界的像素距离。

尺寸包括组件的宽度和高度，单位为px；可单击比例锁锁定组件宽高比，等比例调整组件的宽高，比例锁默认不锁定。

默认隐藏

勾选之后在初始加载时组件默认隐藏且关闭回调触发，通常用来配合显隐控制，如【选项卡】组件进行显隐切换。

2、表盘

在表盘配置中可以调整组件半径、刻度、指针等设置。

半径

仪表盘包括外圆半径和内圆半径两部分，在这里可以修改内圆和半圆的大小

刻度

刻度颜色：表示表盘上刻度线的颜色，可以自己设置颜色，百分号中的数字代表刻度的透明度，0%表示隐藏刻度线，100%表示完全显示刻度线

分段数：代表刻度线将仪表盘分成几段，如图仪表盘被分为5段

粗细：设置刻度线的粗细，左图粗细设置为2，右图设置为5，右图刻度明显粗于左图。

长度：设置刻度线的长度，作图刻度线长度为5，右图设置为20，右图刻度明显长于左图。

指针

在这里设置指针的一些属性，颜色、长度以及指针端点的圆点颜色。

3、指标

设置指标的一系列属性，启用指标的话可以设置如下属性。在数值处设置数字30的样式、偏移度（指标偏移原点的距离）和保留小数位数。后缀自定义样式中更改后缀样式。

4、动画

如果需要动画效果可以启用动画，可设置动画时长。

5、圆环颜色

在这边设置圆环每个区间段的范围和颜色。

二、数据

组件数据格式

字段	说明
value	数值，即指标值

*组件数据格式说明

JSON数据案例

[
	{
		"value": 30
	}
]

数据配置项说明

配置项	说明
数据源	数据源类型、数据源选择等
数据过滤器	勾选启用数据过滤器，单击添加过滤器，可在设置数据源页面中配置数据过滤器，详情请参见数据过滤器使用说明
数据响应结果	展示数据请求的响应结果
自动更新	选中后可以设置数据请求时间间隔

数据对接详情

数据对接详情请见以下文档👇

项目交付——数据对接入门

3、交互

仪表盘组件当前通过载入动画、回调参数、自定义事件三种方式设置交互

载入动画

所有组件均提供移入、移入(小)、划变三种组件载入动画

载入动画选择无时，则组件没有载入动画。

载入动画仅在可视化应用预览、发布组件加载时显示。

载入动画配置项：

配置项	说明
渐隐渐显	启用时
速率	匀速、慢快慢(cubic-bezier(0.25,0.1,0.25,1))、低速开始、低速结束、低速开始和结束(cubic-bezier(0.42,0,0.58,1))
方向	动画方向
持续时间	载入动画持续时间，单位为ms
延时	载入动画延时长，单位为ms

回调参数

回调参数即为全局性的参数变量，用于控制组件之间参数的传递，可通过设置回调参数来实现数据驱动交互。

其中，字段值即参数变量，变量名即对字段值的重命名。

详细的回调参数教学👉 回调的使用

自定义事件

自定义事件为「交互事件」的增强模块，支持通过数据驱动组件状态、或变更组件样式配置，也可自定义编辑复杂的条件逻辑；

详细的自定义事件教学👉自定义事件教学

欢迎您在评论区留下您对该组件的意见，管理员会及时回复您，如长时间未回复欢迎您搜索钉钉群：33782396或者扫描以下二维码添加微信群 @谨禧说出您的想法，采纳后将送出定制礼品。

也可以通过问卷来向我们反馈需求：https://jinshuju.net/f/XyCXU0

仪表盘