Echarts官方文档----快速上手 - Handbook - Apache ECharts
ECharts 的入门使用特别简单, 5分钟就能够上手. 他大体分为这几个步骤
步骤1:引入 echarts.js 文件
该文件获取方式可通过:在 https://www.jsdelivr.com/package/npm/echarts 选择 dist/echarts.js
,点击并保存为 echarts.js
文件。
步骤2:准备一个呈现图表的盒子
这个盒子通常来说就是我们熟悉的 div ,这个 div 决定了图表显示在哪里
步骤3:初始化 echarts 实例对象
在这个步骤中, 需要指明图表最终显示在哪里的DOM元素
//初始化 echarts 实例对象
var myChart = echarts.init(document.getElementById('main'));
步骤4:准备配置项
这步很关键,我们最终的效果,到底是显示饼图还是折线图,基本上都是由配置项决定的
// 指定图表的配置项和数据
var option = {
title: {
text: 'ECharts 入门示例'
},
tooltip: {},
legend: {
data: ['销量']
},
xAxis: {
data: ['衬衫', '羊毛衫', '雪纺衫', '裤子', '高跟鞋', '袜子']
},
yAxis: {},
series: [
{
name: '销量',
type: 'bar',
data: [5, 20, 36, 10, 10, 20]
}
]
};
步骤5:将配置项设置给 echarts 实例对象
// 使用刚指定的配置项和数据显示图表。
myChart.setOption(option);
最终效果和完整代码:
Document
xAxis:直角坐标系 中的 x 轴, 如果 type 属性的值为 category ,那么需要配置 data 数据, 代表在 x 轴的呈现
yAxis:直角坐标系 中的 y 轴, 如果 type 属性配置为 value , 那么无需配置 data , 此时 y 轴会自动去series 下找数据进行图表的绘制
series:系列列表。每个系列通过 type 决定自己的图表类型, data 来设置每个系列的数据
配置项都是以键值对的形式存在, 并且配置项有很多, ECharts 的学习大多是针对于这些配置项的, 对于配置项的学习, 大家可以不用死记硬背, 需要的时候查一查官方文档即可。
网址: https://echarts.apache.org/zh/option.html
Document
注意 :
坐标轴 xAxis 或者 yAxis 中的配置 , type 的值主要有两种 : category 和 value 。
(1)如果 type属性的值为 category , 那么需要配置 data 数据 , 代表在 x 轴的呈现 ;
(2)如果 type 属性配置为 value ,那么无需配置 data , 此时 y 轴会自动去 series下找数据进行图表的绘制 。
series: [
{
name: '销量1',
type: 'bar',
data: yDataArr,
markPoint:{
data:[
{type:'max',name:'最大值'},
{type:'min',name:'最小值'},
{type:'average',name:'平均值'}
]
}
}
]
label:{
show:true, //是否可见
rotate:50 //旋转角度
}
barWidth:'40%' //柱的宽度
所谓的横向柱状图, 只需要让x轴的角色和y轴的角色互换一下即可. 既 xAxis 的 type 设置为 value , yAxis 的 type 设置为 category , 并且设置 data 即可
var option = {
title: {
text: "ECharts 入门示例",//标题文字
textStyle: { color: 'blue' },//文字颜色
left:20,//标题位置
top:10,//标题位置
borderWidth:2,//标题边框宽度
borderColor:'red'//标题边框颜色
},
tooltip 指的是当鼠标移入到图表或者点击图表时 , 展示出的提示框
式化显示 : formatter
tooltip: {
formatter : '{b}:{c}'
},
toolbox 是 ECharts 提供的工具栏 , 内置有 导出图片,数据视图 , 重置 , 数据区域缩放 , 动态类型切换五个工具。
工具栏的按钮是配置在 feature 的节点之下
var option = {
toolbox:{
feature:{
saveAsImage:{},//将图表下载为图片
dataView:{},//是否显示出原始数据
restore:{},//刷新图表
magicType:{ //将图表在不同类型之间切换,图表的转换需要数据的支持
type:['bar','line']
}
}
},