RingProgress - 环形进度条

阅读时间约 1 分钟

环形进度条是 G2Plot 图表体系中,迷你图表的一种。

迷你图表通常在空间有限的情况下作为 fullsize chart 的降级显示形式,相比于 fullsize chart,迷你图表省略了轴和图例,标题,标签等组件,而只保留了图表图形的基本态势。因此展现的信息量是有限的。通常,迷你图表会搭配表格进行使用。

API

说明: required 标签代表生成图表的必选配置项,optional 标签代表生成图表的可选配置项。

width

reuired, number 类型

图表宽度

height

reuired, number 类型

图表高度

percent

required, number 类型

进度百分比,值域为 [0,1]。

color

optional, string | string[] | function 类型

设置进度条颜色,该值的类型如下

  • string    指定值为单值时,配置进度条已完成分段的颜色
  • string[]    指定值为一个数组时,同时配置进度条已完成和未完成分段的颜色,顺序为 [ 已完成,未完成 ]
  • function  指定值为一个回调函数时,入参为当前进度 (percent),出参为一个数组,需要同时指定进度条已完成和未完成分段的颜色,顺序为 [ 已完成,未完成 ]

size

optional, number 类型

设置进度条高度

progressStyle

optional, object | function 类型

设置进度条的样式。

fill: string  填充颜色
stroke: string  描边颜色
lineWidth: number  描边宽度
lineDash: number[]  描边虚线显示
opacity: number  透明度

另外还支持回调函数的配置方式,入参为当前进度 (percent),出参为一个样式配置对象。

events

optional

  • 图形事件:

    onProgressClick: function  折线点击事件
    onProgresDblClick: function    折线双击事件
    onProgresMousemove: function  折线鼠标移动事件
    onProgresContextmenu: function    折线右键事件

  • 图表区域事件:

    onPlotClick: function    图表区域点击事件
    onPlotDblClick: function  图表区域双击事件
    onPlotMousemove: function    图表区域鼠标移动事件
    onPlotContextmenu: function    图表区域右键事件

方法

update( percent:number )

更新进度。

progress.update(0.5);