前言
在近期的项目中,有大量处理可视化数据的需求。说起这个,相信很多同学跟我一样,都会想到用 Echarts 来实现。没错,Echarts 拥有高度可定制化的配置,以及非常详尽的开发文档,并且它的最新版已经更新到了 v4.3。
不过,也是因为 Echarts 的开发文档过于庞杂,对于不熟悉 Echarts 的同学来说,在查找某个效果时,可能需要耗费大量的精力。虽然它也配备了一些官方实例,但或许往往只能借鉴其中的个别配置,还需要回到对应的文档中做印证,另外还得自己做 demo,尝试效果。。。踩坑的过程,很艰辛。
但同时也是收获满满的。今天的这篇文章,主要总结近段时间结合 Echarts 实现数据可视化的一些心得体会。其实只需要一些小技巧,就能实现下面这样“美美哒”的图表了。
希望给有需要的同学一些启发,相信你也可以定制出自己专属的 Echarts 数据可视化风格。
版本说明 与 v-charts
在踩坑的期间,我查找了不少资料。发现一个不太友好的体验:一些文章中仅仅叙述了某个效果的实现,却没提到它的当前版本。当我拿来尝试的时候,却发现怎么也出不来效果,而且运气不好的话,还会报错,这让我很无奈。
所以,为了避免无谓的麻烦。首先需要申明,本篇文章中的各种配置以及它的效果,是基于 Echarts 目前的最新版 V4.3 实现的。
然后,因为项目采用了 Vue 搭建,所以我搭配了 v-charts 来实现图表效果。v-charts 是由“饿了么前端”开发维护的基于 Vue2.0 和 Echarts 封装的图表组件。我用下来感觉挺不错的,文档很清晰,还有相配合的例子,非常容易上手。它目前的最新版是 v1.19.0。
v-charts 一般常用的图表有:ve-line(折线图)、ve-histogram(柱状图)、ve-pie(饼图)、ve-ring(环图)等等。使用时,可以直接将单个图表引入到项目中。
import VeLine from 'v-charts/lib/line.common';
Vue.component(VeLine.name, VeLine);
一种典型的 v-charts 的 data 属性数据格式如下:
{columns: ['日期', '访问用户', '下单用户'],
rows: [{ '日期': '2018-05-22', '访问用户': 32371, '下单用户': 19810},
{'日期': '2018-05-23', '访问用户': 12328, '下单用户': 4398},
{'日期': '2018-05-24', '访问用户': 92381, '下单用户': 52910}
]
}
其中,columns 中是维度和指标的集合,v-charts 中的大部分图表都是单维度多指标,所以默认第一个值为 维度,剩余的值为指标。另外,rows 中是数据的集合。
再举一个柱状图与折线图组合的典型例子。
它的代码实现也十分简单,只需额外配置 settings 参数即可,代码如下:
<template>
<ve-histogram :data="chartData" :settings="chartSettings"></ve-histogram>
</template>
<script>
export default {data () {
this.chartSettings = {axisSite: { right: ['下单率'] },
yAxisType: ['KMB', 'percent'],
yAxisName: ['数值', '比率'],
showLine: ['下单率'],
}
return {
chartData: {columns: ['日期', '访问用户', '下单用户', '下单率'],
rows: [{ '日期': '1/1', '访问用户': 1393, '下单用户': 1093, '下单率': 0.32},
{'日期': '1/2', '访问用户': 3530, '下单用户': 3230, '下单率': 0.26},
{'日期': '1/3', '访问用户': 2923, '下单用户': 2623, '下单率': 0.76},
{'日期': '1/4', '访问用户': 1723, '下单用户': 1423, '下单率': 0.49},
{'日期': '1/5', '访问用户': 3792, '下单用户': 3492, '下单率': 0.323},
{'日期': '1/6', '访问用户': 4593, '下单用户': 4293, '下单率': 0.78}
]
}
}
}
}
</script>
所以,如果没有很强烈的定制化需求的话,v-charts 已经可以满足大多数的基础需求了。
但如果想实现本文开头的那张图中的效果,还需要在 v-charts 的 extends
属性上花一番功夫。extends 在本质上,对应的就是 Echarts 文档的 配置项 中的所有属性。
定制化的踩坑之旅
接下来,会在 v-charts 的基础配置之上,具体地介绍一些很实用的小技巧,来帮助你实现 Echarts 的深度定制化需求。
1、配色
Echarts 提供了 colors 来自定义颜色,它接收一个数组作为结果。这里有一份来自产品小姐姐的 UI 配色方案,已经可以适用于绝大多数场景了。
代码如下:
colors: ['#60ACFC', '#35C5EB', '#4DBECF', '#65D5B2', '#5BC4A0', '#9DDD81', '#D4ED58', '#FFDB43', '#FEB54E', '#FF9D68']
2、虚线
v-charts 中的 x 轴实线看上去有点生硬,可以将它变为虚线,看上去就会清爽很多了,具体可以配置 setOption 下的 yAxis 属性。
yAxis (item) {item[0].splitLine = Object.assign({}, {
lineStyle: {
color: '#e1e2e2',
type: 'dashed'
}
});
return item;
}
这里用到了 es6 中 function 的简写模式。其中的 item 指的是 y 轴,为什么是个数组呢?那是因为一般情况下单个直角坐标系 grid 组件最多只能放左右两个 y 轴。那么 item[0] 是指左侧的最常用的 y 轴,item[1] 是指当有双轴情况下的右侧的 y 轴。
这里核心是要设置 splitLine 下的 lineStyle,效果就如开篇的第一张图那样:
当然,也可以定制 tooltip 的虚线,效果如下:
只需要配置 tooltip 下 axisPointer 的 lineStyle 即可,代码很简单:
tooltip : {
axisPointer: {
lineStyle: {
color: '#e1e2e2',
type: 'dashed',
shadowColor: 'rgba(0, 0, 0, 0.3)',
shadowBlur: 5
}
}
}
3、堆叠与面积
堆叠图与面积图在刚接触时容易混淆,它们实际上是两种不同的效果。
堆叠图中的后一项数据会叠在前一项数据之上,像下面这样:
可以通过设置 v-charts 提供的 extend 属性进行配置。之前也说过,它本质上就是配置 Echarts 中的 setOption。
我们分别对柱状图和折线图设置了堆叠效果,可以发现 e.stack 的值是分开设置的,不然的话在数值上就会再次叠加。
<ve-histogram :extend="chartExtend"></ve-histogram>
...
this.chartExtend = {series: (v) => {Array.from(v).forEach((e, idx) => {if (e.type === 'bar') {e.stack = 'bar';}
if (e.type === 'line') {e.stack = 'line';}
};
},
...
};
而面积图,往往在折线图中是为了突出某一块区域的对比。
同样地,在 chartExend 中进行配置:
<ve-line :extend="chartExtend"></ve-line>
...
this.chartExtend = {series: (v) => {Array.from(v).forEach((e, idx) => {
// 将指定条件下的折线设置为面积图
if (...) {e.areaStyle = 'line';}
};
},
...
};
4、自定义图例
图例,在 Echarts 的配置项中,也叫 legend。通过它可以直观地看到不同颜色对应的数据分布情况。同时,它也是包含点击交互的,当你暂时不想关心某个数据项是,可以点击对应的图例,让它暂时隐藏,再次点击,又会重新渲染出来。
我遇到过更进一步地需求:在柱状图的图例中,要默认展示当天的数据,当点击某一天时柱子时,图例中的数据要随之变化。需求的目的是,让用户能更直观地了解每一天的数据,当他需要看某两天的数据对比时,只需要点击柱子切换数据即可。效果如下:
当想看 9 月 16 日的数据时,点击对应的柱子,则图例中的数据会刷新,同时左上角的时间也会随之变化:
实现的思路基本是这样的:
- 通过点击事件的回调方法,获取当日的具体时间。
- 对左上角的时间做格式化设置。
- 再次设置 extend 的 legend 配置。
- 在 legend 中,通过 formatter 函数返回自定义模板,实现文字与数字的展现。
- 具体的做法是,根据左上角的时间,过滤 chartData.rows 中的数据,找到对应的那一天的数据。
- 配置自定义模板,输出带样式的结果。
匹配当日数据的具体方法,因为业务逻辑的不同,数据结构也会不同,这里就不细说了。我把事件回调的写法,还有自定义模板的输出的代码贴出来,给大家参考一下:
<ve-histogram :data="chartData" :extend="chartExtend" :events="{click: handleChartEvents}"></ve-histogram>
...
handleChartEvents (e) {
const date = e.name;
// 设置左上角的时间(带格式化),这里不再展开
this.setCurrentDate(date);
this.setChartExtend();},
...
setChartExtend () {
this.chartExtend = {
legend: {formatter: (name) => {
// currentNumber 是已经匹配到的当日数据
const result = [`{a|${name}}`,
`{b|${currentNumber}}`
];
return result.join('\n');
},
textStyle: {
height: 42,
rich: {
a: {
fontSize: 12,
align: 'left',
padding: [0, 10, 15, 0]
},
b: {
fontSize: 24,
align: 'left',
padding: [0, 10, 0, 0],
lineHeight: 40,
width: 60
}
}
},
// 图例标记的图形宽度
itemWidth: 14,
// grid 距离整个容器顶部的高度
grid: {top: 120}
},
...
};
},
...
点击事件的回调里,可以拿到具体的时间 name,然后交给 setCurrentDate 方法做时间格式化的设置,并渲染到界面上,同时它也是后续匹配当日数据的依据。
在 legend 的 formatter 方法中组装的自定义模板,分别有两个样式 a 和 b,你也可以取别的样式名字,但要记得对应地在 textStyle 的 rich 对象里设置样式。
rich 是富文本样式的自定义写法,有点类似于平时常见的 css,但像 padding 之类的样式写法,又略有不同,而且调试起来并不容易。上述代码中的数字,是经过多次微调之后的结果。
最后的 itemWidth 是为了设置颜色块的宽度,使之变为方形,更加美观。因为图例中添加的数字的样式,所以整体的高度变得大了。grid 的 top,可以调整主绘制区域到整个容器顶部的距离,从而使之距离图例,也能留出更合理的空白高度。
除此之外,对于数据较多的图表,如果刚加载就展示全部数据的话,会比较乱。
这时,我们就想,是否可以只展示其中某一类的数据呢?像下面这样:
这里,就需要用到 legend 的 selected 属性。它是一个对象,意思是图例选中状态表。用法很简单:
<ve-line :extend="chartExtend"></ve-line>
...
setChartExtend () {
this.chartExtend = {
legend: {formatter: (name) => {return `{a|${name}}`;
},
textStyle: {
// 这里的 rich 样式,是为了四等分的布局
rich: {
a: {
width: 240,
height: 20,
lineHeight: 22,
align: 'left'
}
}
},
width: 1090,
// 图例标记的图形宽度
itemWidth: 14,
selected: {
'T1- 第 7 日': false,
'T1- 第 14 日': false,
'T1- 第 30 日': false,
'T2- 第 7 日': false,
'T2- 第 14 日': false,
'T2- 第 30 日': false,
'T3- 第 7 日': false,
'T3- 第 14 日': false,
'T3- 第 30 日': false,
}
},
...
};
}
其中的 formatter 函数返回一个带样式的文本,通过样式将布局四等分。然后设置 selected,将默认不需要展示的数据隐藏起来。
注意,selected 对象中的 key 均为指标的具体名称,不能用别名代替,否则是出不来效果的。
5、mini 图
刚接到需求要实现 mini 图的时候,第一时间想到的是下面这张图的模样:
这是一个不同缓动函数效果的官方示例,每一个缓动效果图都带有一个标题组件。
研究了 示例代码 后,发现它的实现原理是:模拟了输入 x 轴的不断变大的值,通过不同的效果函数,来输出对应的 y 轴的值,达到呈现出不同的效果。
很遗憾,这没法不适用于我们的需求。我们希望实现一个迷你的单一数据趋势图,没有任何坐标轴,但数据的趋势并不一定是线性增长的。然而,值得庆幸的是,可以借鉴其中的隐藏坐标轴的做法。具体的实现,还是要设置 extend,代码如下:
<ve-line :data="chartData" :extend="chartExtend" width="120px" height="40px">
...
this.chartExtend = {
xAxis: {show: false,},
yAxis: {show: false,},
legend: {show: false},
grid: {
show: true,
left: 0,
top: 5,
width: '100%',
height: '100%',
borderWidth: 0,
backgroundColor: '#fff',
},
series: (v) => {Array.from(v).forEach((e, idx) => {
e.symbol = 'circle';
e.symbolSize = 2;
e.areaStyle = {opacity: 0.3};
});
return v;
},
tooltip: {formatter: (params) => {
let result = '';
params.forEach(param => {let str = `${param.marker}${param.value[0]} ${param.value[1]}<br>`;
result += str;
});
return result;
}
}
};
因为是迷你的图表,所以需要在布局中,将它调整为可控的大小。相应的,grid 属性的 top 和 left,也可以帮我们做微调。x 轴,y 轴,图例,这些都隐藏掉。最后,为了支持 tooltip,对其结构进行了 formatter。最终的呈现效果如下:
正因为 mini 图的尺寸足够的小,所以比较适合于对某些重要数据,做周期性的趋势解读,并可以位于重要数据的附近。这也能使得界面的布局,看上去更为的协调。
6、双轴单线
当一张图表中,存在双轴时,很大概率下都会出现 2 个 y 轴的刻度不一致的情况。
想想也是啊,设置为双轴的原因,本来就是因为它们的数值差异过大。如果不设置双轴,某些数据就看不到了,并不是没有渲染,而是因为太小,导致其被数值大的数据“淹没”了。
一种解决方案是,需要自己去定义 y 轴的 max,min,interval。因为系统不会再自动计算适配了。
yAxis:[{......},
{
type: 'value',
name: '销售额 (元)',
min: 0,
max: max, // 计算最大值
interval: Math.ceil(max / 5), // 平均分为 5 份
axisLabel: {formatter: '{value}'
}
]
这个方案可以将双轴的刻度重合在一起,实现“单线”的效果。但是,因为要自己算,所以略微有些麻烦,均分的份数可能会因为界面的美观,需要进行调整。如果双轴的单位不一致,比如左侧为数值,右侧为百分比,也挺麻烦的。
所以,就想了一个“偷懒”的办法。既然只要展示“单线”,那就把第二根线隐藏起来呗,其实尽管是“双线”,但其实它们之间离得还是挺近的,从效果上来看,并没有太大的影响。
实现方案也很简单,还记得之前介绍“虚线”是如何设置的么?
yAxis (item) {item[0].splitLine = Object.assign({}, {
lineStyle: {
color: '#e1e2e2',
type: 'dashed'
}
});
return item;
}
其中的 item[0] 代表的是左侧最常用的 y 轴。那么右侧的自然就是 item[1] 了,把它隐藏起来就行了:
yAxis (item) {item[0].splitLine = Object.assign({}, {...});
item[1].splitLine = {show: false};
return item;
},
是不是很简单?其实知道了对的方法,实现起来还是简直就是 easy 模式。但往往探究“对的方法”需要耗费大量的精力。
总结
今天介绍了几种 Echarts 定制化的方案,多是由实际工作中提炼总结出来的小技巧,希望能帮到有需要的同学。如果你觉得本文还不错,还请点个“赞”或者“关注”,以便让更多有需要的同学看到,感谢支持!
可能细心的同学会问:本文开头的那张图中的“小图标”是如何实现的呢?文章中貌似没有涉及到。
是的。由于篇幅的关系,我会单独再开一篇,专门来聊一聊关于“标记”的定制化方案,欢迎大家届时捧场,感谢!
PS:欢迎关注我的公众号“超哥前端小栈”,交流更多的想法与技术。