# 图表介绍
随着技术发展,数据可视化越来越重要。为了满足日常开发,我们和公司UI部门一起制定了数据可视化的部分内容,目前提供了 折线图
, 面积图
, 柱状图
, 饼图
,环形图
。我们将图表分为 坐标轴(axis)
, 几何图形(geometry)
,图例(legend)
, 提示信息(tooltip)
, Hover效果
五个主要部分。下面部分我们将针对 坐标轴
做一些基础的介绍。几何图形
的配置详见具体的可视化组件。 图例
,提示信息
, hover效果
目前并不需要开发者进行配置。故不做详细介绍。后续若有配置需要,则再添加。
# 坐标轴
坐标轴(axis)
即数据展示的维度。目前主要有 x
, y
轴两个坐标轴。若需要显示双 y
轴, 我们额外提供了一个 yr
轴。坐标轴的配置,主要分为两个部分。一个部分是该坐标轴使用的数据维度(属性),我们使用 use
属性来配置。另一个部分是坐标轴上显示的刻度信息, 我们使用 scale
属性来进行配置。具体的配置属性见下表:
# axis
参数 | 说明 | 类型 | 默认值 | 是否必须 |
---|---|---|---|---|
use | 坐标轴使用的数据维度(属性) | string | - | 是 |
scale | 坐标轴的刻度信息 | object | - | 是 |
# scale
根据坐标轴 use
的数据维度的数据类型,刻度支持以下几种数据类型:
- identity,常量类型的数值,也就是说数据的某个字段是不变的常量
- linear,连续的数字 [1, 2, 3, 4, 5]
- cat,分类, ['男','女']
- timeCat,时间类型
根据不同的刻度类型,刻度的配置项有所不同。
# 通用配置:
参数 | 类型 | 说明 |
---|---|---|
type | string | 指定不同的度量类型,支持的 type 为 identity 、linear 、cat 、timeCat 。 |
formatter | function | 回调函数,用于格式化坐标轴刻度点的文本显示。 |
range | array | 输出数据的范围,数值类型的默认值为 [0, 1],格式为 [min, max],min 和 max 均为 0 至 1 范围的数据。 |
alias | string | 该数据字段的显示别名,一般用于将字段的英文名称转换成中文名。 |
tickCount | number | 坐标轴上刻度点的个数,不同的度量类型对应不同的默认值。 |
ticks | array | 用于指定坐标轴上刻度点的文本信息,当用户设置了 ticks 就会按照 ticks 的个数和文本来显示。 |
# linear
类型的刻度的特有属性:
参数 | 类型 | 说明 |
---|---|---|
nice | boolean | 默认为 true,用于优化数值范围,使绘制的坐标轴刻度线均匀分布。例如原始数据的范围为 [3, 97],如果 nice 为 true,那么就会将数值范围调整为 [0, 100]。 |
min | number | 定义数值范围的最小值。 |
max | number | 定义数值范围的最大值。 |
tickInterval | number | 用于指定坐标轴各个标度点的间距,是原始数据之间的间距差值,tickCount 和 tickInterval 不可以同时声明。 |
# cat
类型的刻度的特有属性:
参数 | 类型 | 说明 |
---|---|---|
values | array | 具体的分类的值,一般用于指定具体的顺序和枚举的对应关系。 |
isRounding | boolean | 默认值为 false, 在计算 ticks 的时候是否允许取整以满足刻度之间的均匀分布,取整后可能会和用户设置的 tickCount 不符合。 |
# cat
类型的刻度的特有属性:
时间分类类型,默认会对数据做排序
参数 | 类型 | 说明 |
---|---|---|
nice | boolean | 默认为 true,用于优化数值范围,使绘制的坐标轴刻度线均匀分布。例如原始数据的范围为 [3, 97],如果 nice 为 true,那么就会将数值范围调整为 [0, 100]。 |
mask | string | 数据的格式化格式 默认:'YYYY-MM-DD'。 |
values | array | 具体的分类的值,一般用于指定具体的顺序和枚举的对应关系。 |
isRounding | boolean | 默认值为 false, 在计算 ticks 的时候是否允许取整以满足刻度之间的均匀分布,取整后可能会和用户设置的 tickCount 不符合。 |
← Tab 标签页 ChartLine 折线图 →