RatioChart

用于展示占比情况、进度等场景,内部预设了圆环图、仪表盘和水滴图的配置

API

NameDescriptionTypeDefault
width图表容器的宽度,可以是绝对像素值或父元素宽度的百分比string'100%'
height图表容器的高度,可以是绝对像素值或父元素高度的百分比string'100%'
theme图表颜色主题'light' | 'dark''light'
adaptive当窗口 resize 时,是否让图表自动 resize 以自适应窗口大小booleantrue
type图表类型'ring' | 'gauge' | 'liquid''ring'
title描述文本string-
radius圆环(ring)、仪表盘(gauge)、水滴(liquid)的半径,可以是相对于容器高宽中较小的一项的一半的百分比或绝对像素值string | number'75%'
value值 (当 type 为 'liquid' 时,只能是 0 到 1 之间的数)number0
max最大值 (type 为 'ring' 或 'gauge' 时有效)number1
textStyle仪表盘刻度标签文本和描述文本的样式 (type 为 'ring' 或 'gauge' 时有效){ labelSize?: number; labelOffset?: number | string; valueSize?: number; valueOffset?: number | string; color?: string; }{ labelSize: 18, labelOffset: type === 'ring' ? -16 : '80%', valueSize: 30, valueOffset: type === 'ring' ? 16 : '60%', color: color }
itemWidth进度条的宽度 (type 为 'ring' 或 'gauge' 时有效)number20
color进度条或水滴的颜色sting-
bgColor进度条或水滴的背景颜色sting-
shadow进度条是否显示阴影效果 (type 为 'ring' 或 'gauge' 时有效)booleanfalse
gradient进度条设置渐变色,接受起始颜色和终止颜色组成的数组 (type 为 'ring' 或 'gauge' 时有效)[string, string]-
liquid水滴图 liquidFill 的标准配置对象 (type 为 'liquid' 时有效)object-
gauge仪表盘的标准配置对象,接受标准的 GaugeSeriesOption 配置 (type 为 'gauge' 时有效)object-

关于 textStyle

可以通过 textStyle 属性设置仪表盘刻度标签文本、显示数值和描述文本的样式,type 为 'liquid' 时无效,具体说明如下:

{
  labelSize?: number  // 刻度标签文本和描述文本的字体大小
  labelOffset?: number | string // 描述文本相对于仪表盘中心的垂直偏移距离,可以是绝对像素值或相对于仪表盘半径的百分比
  valueSize?: number  // 数值显示文本的字体大小
  valueOffset?: number | string // 数值显示文本相对于仪表盘中心的垂直偏移距离,可以是绝对像素值或相对于仪表盘半径的百分比
  color?: string // 仪表盘刻度标线和标签文本、显示数值和表述文本的字体颜色,不传默认取 color 属性的值
}

关于 liquid 和 gauge 属性

type 为 'liquid' 时,如果默认的效果不满足你的需求, 可以通过配置 liquid 属性来完全控制水滴图的每个部分,它接受标准的 liquidFill 配置对象。

同样当 type 为 'gauge' 时,也可以通过配置 gauge 属性来完全定制你的仪表盘,它接受标准的 GaugeSeriesOption 配置。

Example