栅格进度条

文档基于栅格进度条v1.0.4版本

组件说明

栅格进度条是用于反映指标的组件之一，支持百分比值与真实值两种数值类型的设定，可设置栅格与指标的相关样式，自定义数值区间，智能地展示指标实时的变化情况。

效果案例

栅格进度条可以通过增加“数值区间”来根据数值变化来改变组件颜色。

*栅格进度条效果案例

一、样式

在样式中可以设置组件的基本属性、全局、栅格、指标和区间。

1、基本属性

位置尺寸

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

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

基本柱状图组件尺寸不影响组件内容显示、组件动画。

默认隐藏

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

2、全局

在全局配置中可以调整组件数值类型、设置动画等功能。

数值类型

在数值类型内可选择“百分比值”或“真实值”两个选项。

其中，选择真实值时可以自定义极值，设置最小值与最大值。

选择百分比值👇

选择真实值👇

动画

栅格进度条预置动画效果，可在此选择是否开启动画。（图示效果为开启动画的选项）

如选择开启动画，则可在下方设置动画时长，单位为毫秒。

3、栅格

在栅格一栏中可设置栅格属性，包括栅格间距，分段数，栅格圆角，前景色与背景色。

4、指标

可在指标栏目下设置文本样式，保留小数位数，偏移距离。

背景

在背景选项下可设置指标背景图片，图片大小以及图片偏移距离。

后缀

可以设置文本后缀，打开自定义样式后可以修改文本样式。

5、区间

在区间一栏中可通过点击可设置多个区间。

在数值进入设置的区间范围后，圆形栅格占比组件显示出预置的样式。

并可对区间范围内的栅格前景色，指标进行修改，修改方式与上方相同。

二、数据

组件数据格式

字段	说明
value	值，即指标数值
max	值，即进度条最大值
min	值，即进度条最小值

*组件数据格式说明

JSON数据案例

[
	{
		"value": 0.35,
		"max": 2,
		"min": 0
	}
]

数据配置项说明

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

数据对接详情

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

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

三、交互

栅格进度条组件当前通过载入动画、自定义事件两种方式设置交互。

载入动画

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

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

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

载入动画配置项：

配置项	说明
渐隐渐显	启用是
速率	匀速、慢快慢(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