Vue 项目中Echarts 5使用方法详解
目录
- 前言
- 创建项目
- 基本使用
- 安装
- 使用方法
- 柱状图
- 动态排序柱状图
前言
Echarts
是一个纯JavaScript
的图表库,兼容绝大部分的浏览器,底层依赖轻量级的canvas
类库ZRender
,提供直观,生动,可交互,可高度个性化定制的数据可视化图表。
创建项目
先使用vue-cli
创建一个新的项目,配置按照自己的需要选择,默认的也可
vue create vue_echarts cd vue_echarts npm run serve
基本使用
安装
首先安装echarts
npm i echarts -S
使用方法
关于如何使用,我们可以阅读官方文档,写的挺详细的,总的来说需要把握以下两点:
- 在绘图前我们需要为
ECharts
准备一个给定宽高的图表容器(DOM
元素) - 绘图时,首先通过
Echarts
的init
方法初始化一个echarts
实例,然后通过setOption
方法导入图表配置来完成绘制
下面是以上两点的具体代码,只是理解用:
<template> <-- DOM 容器 --> <div style="width: 400px; height: 250px" ref="echarts"></div> </template> <script> // 全局引入 echarts import * as echarts from "echarts"; // 初始化实例 const myChart = echarts.init(this.$refs.echarts); // 绘制(提前配置好option) myChart.setOption(option); </script>
官方的示例中其实是通过id
来获取图表容器
还是不建议这样做,一个是因为如果id
重名了会导致页面渲染出现问题;再一个是页面较复杂时会导致Echarts
的图表容器还未生成就对其进行了初始化,所以还是使用ref
来代替
柱状图
下面以常见的柱状图为例,来展示如何在我们的项目中使用echarts
:
首先创建一个ref="echarts"
的div
元素作为图表容器
<div style="width: 400px; height: 300px" ref="echarts"></div>
然后引入echarts
import * as echarts from "echarts";
在methods
中定义一个绘制图表的方法,并在mounted()
钩子中调用
methods: { getEcharts() { const myEcharts = echarts.init(this.$refs.echarts); myEcharts.setOption(this.option); }, }, mounted() { this.getEcharts(); },
option
为图标配置的相关数据,定义在data()
中
data() { return { option: { title: { text: "ECharts 柱状图", }, legend: { data: ["销量"], }, xAxis: { data: ["衬衫", "羊毛衫", "雪纺衫", "裤子", "高跟鞋", "袜子"], }, yAxis: {}, series: [ { name: "销量", type: "bar", data: [5, 20, 36, 10, 10, 20], }, ], }, }; },
现在就可以在浏览器中看到绘制出的柱状图了:
现在回过头来看看option
中的配置项都表示什么含义
参数名 | 作用 |
---|---|
title | 图表名称 |
legend | 配置图例相关,比如图例的位置、内容等 |
xAxis/yAxis | 配置x/y轴相关,比如坐标轴数值、刻度等 |
series | 配置图表系列相关,比如图表类型(series.type)、数据集(series.data)等 |
color | 图表的调色盘,可以全局配置,也可以对某种图表单独配置 |
动态排序柱状图
上面的基本柱状图好像有些基础(low),下面来整个花里胡哨的。 ECharts 5
开始内置支持动态排序柱状图,也即展示随时间变化的数据排名变化的图表。
图表容器我们不做改变,首先准备好一个随机数组data
<script> var data = []; for (let i = 0; i < 5; ++i) { data.push(Math.round(Math.random() * 200)); } </script>
然后对option
作如下配置
data() { return { option: { title: { text: "ECharts 动态排序柱状图", }, xAxis: { max: "dataMax", }, yAxis: { type: "category", data: ["A", "B", "C", "D", "E"], inverse: true, animationDuration: 300, animationDurationUpdate: 300, max: 2, }, series: [ { realtimeSort: true, type: "bar", data: data, // 数据为随机数数组 label: { show: true, position: "right", valueAnimation: true, }, }, ], legend: { show: true, }, animationDuration: 3000, animationDurationUpdate: 3000, animationEasing: "linear", animationEasingUpdate: "linear", }, } }
series
中的realtimeSort
设为true
,表示开启该系列的动态排序效果yAxis.inverse
设为true
,表示 Y 轴从下往上是从小到大的排列- 将
yAxis.max
设为n
,表示显示前n+1
名 - 将
series.label.valueAnimation
设为true
,就可以实时改变标签 animationDuration
、animationDurationUpdate
、animationEasing
和animationEasingUpdate
都是一些过渡动画相关的配置,想进一步了解的可以阅读官网的相关介绍
还没完,我们还需要初始化实例并调用:
methods: { getEcharts() { let data = this.option.series[0].data; for (var i = 0; i < data.length; ++i) { if (Math.random() > 0.9) { data[i] += Math.round(Math.random() * 2000); } else { data[i] += Math.round(Math.random() * 200); } } const myEcharts = echarts.init(this.$refs.echarts); myEcharts.setOption(this.option); }, }, mounted() { setInterval(() => { this.getEcharts(); }, 3000); },
这里每3s
调用了一次setOption
来改变图表数据,时间应与每次更新动画时长,也即animationDurationUpdate
的值一致。
以上就是Vue 项目中Echarts 5使用方法详解的详细内容,更多关于Vue 项目使用Echarts 5的资料请关注我们其它相关文章!