这篇文章谈及到的问题： 关于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，表示图表数据结构 ，形如：
var option = {`
title: {
text: "我的第一个ECharts图表示例"
},
tooltip: {`
trigger: 'axis'
}
};
2）、boolean notMerge，表示是否合并option。默认为false，可以不设置。
描述：
万能接口，配置图表实例任何可配置选项（详见option），多次调用时option选项是默认是合并（merge）的，如果不需求，可以通过notMerger参数为true阻止与上次option的合并。
2、getOption()
描述：
返回内部持有的当前显示option克隆
3、setSeries(Array series,{boolean=}notMerge)
参数：
1）、Array类型的series序列数据，形如：
var Array seriesList =new Array();
var seriesObj =new seriesObj();
seriesObj.name ="蒸发量"``;
seriesObj.type ="line";
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];
//设置series
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
示例代码形如：
//ECharts图表的click事件监听
myChart.on("click", function () {
alert("你点击我了!");
});
7、un(string eventName,function eventListner)
描述：
解除某个事件的绑定，示例代码形如：
myChart.un("click", function() {
alert("悲剧，你注销我了!");
});
8、showLoading(Object loadingOption)
描述：
过渡控制（详见loadingOption），显示loading（读取中）代码片段形如：
//图表显示提示信息
myChart.showLoading({
text:` `"图表数据正在努力加载...",
x:"center",
y:"center",
textStyle: {
color:``"red",
fontSize:14
},
effect:"spin"
});
注意：
9、hideLoading()
描述：
隐藏图表数据加载过度提示信息，示例代码：
myChart.hideLoading();
10、getZrender()
描述：
获取当前图表所用ZRender实例，可用于添加额外图形或进行深度定制，zrender接口详见ZRender 示例代码如下所示：
nyChart.getZrender();
11、getDataURL(string imgType)
描述：
获取当前图表的Base64图片dataURL，imgType 图片类型，支持png|jpeg，默认为png
示例代码如下所示：
var imgUrl = myChart.getDataURL("png");
12、getImage(string imgType)
描述：
获取一个当前图表的img，imgType 图片类型，支持png|jpeg，默认为png，示例代码片段：
`//前端导出图表图片`
var imgObj = myChart.getImage("jpeg");
主要是拿到一个图片对象，然后获取其outerHTML属性就是一个图表image的html完整标签，我们可以使用其直接显示在页面上。
13、resize()
描述：
ECharts没有绑定resize事件，显示区域大小发生改变内部并不知道，
使用方可以根据自己的需求绑定关心的事件，主动调用resize达到区域更新的效果。
myChart.resize();
14、refresh()
描述：
刷新图表，图例选择、数据区域缩放，拖拽状态均保持。
myChart.refresh();
15、restore()
描述：
还原图表，各种状态均被清除，还原为最初展现时的状态。
16、clear()
描述：
清空绘画内容，清空后实例可用，因为并非释放示例的资源，释放资源我们需要dispose()
myChart.clear();
17、dispose()
描述：
释放图表实例，释放后实例不再可用。
myChart.dispose();
目前ECharts图表的实例化主要包含当前十七个相关方法，后期不保证有补充的节奏，就目前来说，这十七个已经够用了的。
注意：
1、以上方法的使用前提都是需要获得ECharts初始化对象过后才可以进行，否则会产生报错现象。
网友评论