[摘要]: 前面我们以及提及到了ECharts图表组件初级入门之(一):如何将ECharts引入至项目中的几种方式和ECharts图表初级入门(二):ECharts图表对象的初始化(init)详解以及注意事项,我们完成了ECharts图表使用的一些基础部署了,也拿到了ECharts的对象,通过init(dom)方法,那么我们如何给这个对象进行数据初始化呢?这将会是这一篇文章将会谈及到的问题: 关于ECharts图表的实例化方式和Highcharts图表的实例化方法有些类似,都是通过给其对象提供一个option,option的结构如同json的结构一样,只是一些属性少了双引号罢了。 纵观ECharts图表实例化的API,主要有一下几个相关的实例化方法: 1、setOption(Object option,{boolean = true} notMerge)...
前面我们以及提及到了
ECharts图表组件初级入门之(一):如何将ECharts引入至项目中的几种方式
和
ECharts图表初级入门(二):ECharts图表对象的初始化(init)详解以及注意事项
,我们完成了ECharts图表使用的一些基础部署了,也拿到了ECharts的对象,通过init(dom)方法,那么我们如何给这个对象进行数据初始化呢?这将会是这一篇文章将会谈及到的问题:
关于ECharts图表的实例化方式和Highcharts图表的实例化方法有些类似,都是通过给其对象提供一个option,option的结构如同json的结构一样,只是一些属性少了双引号罢了。
纵观ECharts图表实例化的API,主要有一下几个相关的实例化方法:
1、setOption(Object option,{boolean = true} notMerge)
1)、Object类型的参数 option,表示图表数据结构 ,形如:
1.
var
option = {
2.
title: {
3.
text:
"我的第一个ECharts图表示例"
4.
},
5.
tooltip: {
6.
trigger:
'axis'
7.
}
8.
};
2)、boolean notMerge,表示是否合并option。默认为false,可以不设置。
万能接口,配置图表实例任何可配置选项(详见option),多次调用时option选项是默认是合并(merge)的,如果不需求,可以通过notMerger参数为true阻止与上次option的合并。
2、getOption()
返回内部持有的当前显示option克隆
3、setSeries(Array series,{boolean=}notMerge)
1)、Array类型的series序列数据,形如:
03.
var
seriesObj =
new
seriesObj();
04.
seriesObj.name =
"蒸发量"
;
05.
seriesObj.type =
"line"
;
06.
seriesObj.data = [2.0, 4.9, 7.0, 23.2, 25.6, 76.7, 135.6, 162.2, 32.6, 20.0, 6.4, 3.3];
08.
09.
myChart.setSeries(seriesList,
false
);
2)、boolean notMerge 表示是否合并series,默认为false,可以不设置。
数据接口,驱动图表生成的数据内容,效果等同调用setOption({series:{...}})
4、getSeries()
返回内部持有的当前显示series克隆,效果同return getOption().series
5、addData(....)
1)、单组数据参数
11)、{number} seriesIdx :表示给哪一条series添加数据,series脚标从0开始;
12)、{number | Object} data;
13)、{boolean=} isHead ;
14)、{boolean=} dataGrow;
15)、{string=} additionData;
2)、多组数据参数
其实就是多个单组数据的形成的集合或者数组{Array} params
动态数据接口
seriesIdx 系列索引
data 增加数据
isHead 是否队头加入,默认,不指定或false时为队尾插入
dataGrow 是否增长数据队列长度,默认,不指定或false时移出目标数组对位数据
additionData 是否增加类目轴(饼图为图例)数据,附加操作同isHead和dataGrow
多组数据添加时参数为:
params == [[seriesIdx, data, isHead, dataGrow, additionData], [...]]
6、on(string eventName,function eventListner)
事件绑定,支持事件有:REFRESH,RESTORE,CLICK,HOVER,DATA_CHANGED,MAGIC_TYPE_CHANGED,DATA_VIEW_CHANGED,DATA_ZOOM,DATA_RANGE,LEGEND_SELECTED,MAP_SELECTED
示例代码形如:
1.
2.
myChart.on(
"click"
,
function
() {
3.
alert(
"你点击我了!"
);
4.
});
7、un(string eventName,function eventListner)
解除某个事件的绑定,示例代码形如: