前一段时间一直都挺忙的，各种事，也没来得及每周的总结，趁着晚上的一点时间把项目中用的Echart中常用的各种图表给抽象总结了一下，趁着周末跟大家分享一下。之前写过一篇相关的文章，当时主要是讲了如何引入、使用Echart，最新的Echart版本已经发布，之前讲的很多文件都可以删除了，下边会一一给大家细讲。
为了更好的讲解如何使用这个图形渲染插件，我会通过创建一个解决方案的形式一点点给大家讲解清楚。
1. EChart最新的文档目录。
首先创建一个解决方案，目录如下：
之前的一篇文章中讲到如果要使用Echarts还要下载相关的ZRender的渲染包，最新的版本已经将这些合并在一起了，只需要引用图中红框标注的echarts文件夹下的文件即可。各文件的作用如下：
l Echarts-map.js :主要用来渲染跟地图相关
l Echarts.js :基本的常规图形相关
l Esl.js :图像引擎
Statics文件夹下的ECharts.js文件，为我自己抽象总结出来的用于Echarts的配置文件加载、数据处理、初始化各种图像类型的配置、图像渲染的一些方法。
2. 抽象之后的Echarts。
根据Echarts官网的讲解，我把Echarts的使用归结为一下的几个步骤，同时这些步骤相应的实现对应到Statics文件夹下的Echarts.js，该文件的主要代码目录如下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
Var ECharts={ChartConfig:function(container,option){ …..},//加载Echarts配置文件ChartDataFormate:{….},//数据格式化ChartOptionTemplates:{….},//初始化常用的图表类型Charts:{ RenderChart:function(option){….},//渲染图表RenderMap:function(option){…}//渲染地图}}； |
2.1 Echarts配置文件的引入
在开始使用时，首先需要引入Echarts 的配置文件，也就是要加载基本的图像类型，我们可以在每一个页面都引入，但是这样抽象化程度不高，重复使用率也不高，只需要有一个配置项在每次引用的时候加载一下即可，对应到具体的代码实现，如下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
|
ChartConfig: function (container, option) { //container:为页面要渲染图表的容器，option为已经初始化好的图表类型的option配置 var chart_path = "/Statics/echarts/echarts"; //配置图表请求路径 var map_path = "/Statics/echarts/echarts-map";//配置地图的请求路径 require.config({//引入常用的图表类型的配置 paths: { echarts: chart_path, 'echarts/chart/bar': chart_path, 'echarts/chart/pie': chart_path, 'echarts/chart/line': chart_path, 'echarts/chart/k': chart_path, 'echarts/chart/scatter': chart_path, 'echarts/chart/radar': chart_path, 'echarts/chart/chord': chart_path, 'echarts/chart/force': chart_path, 'echarts/chart/map': map_path } }); this.option = { chart: {}, option: option, container: container }; return this.option; } |
2.2 数据格式化
为了能够更好的展现各种的数据，在进行图表的option配置之前，需要先对从后台请求过来的数据进行格式化。后台返回的数据必须是json格式的数据，且数据类型只能为以下两种类型:
Result1=[{name:XXX,value:XXX},{name:XXX,value:XXX}….]
Result2=[{name:XXX,group:XXX,value:XXX},{name:XXX,group:XXX,value:XXX]
具体的代码实现如下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
ChartDataFormate: { FormateNOGroupData: function (data) {//data的格式如上的Result1，这种格式的数据，多用于饼图、单一的柱形图的数据源 var categories = []; var datas = []; for (var i = 0; i < data.length; i++) { categories.push(data[i].name || ""); datas.push({ name: data[i].name, value: data[i].value || 0 }); } return { category: categories, data: datas }; }, FormateGroupData: function (data, type, is_stack) {//data的格式如上的Result2，type为要渲染的图表类型：可以为line，bar，is_stack表示为是否是堆积图，这种格式的数据多用于展示多条折线图、分组的柱图 var chart_type = 'line'; if (type) chart_type = type || 'line'; var xAxis = []; var group = []; var series = []; for (var i = 0; i < data.length; i++) { for (var j = 0; j < xAxis.length && xAxis[j] != data[i].name; j++); if (j == xAxis.length) xAxis.push(data[i].name); for (var k = 0; k < group.length && group[k] != data[i].group; k++); if (k == group.length) group.push(data[i].group); } for (var i = 0; i < group.length; i++) { var temp = []; for (var j = 0; j < data.length; j++) { if (group[i] == data[j].group) { if (type == "map") temp.push({ name: data[j].name, value: data[i].value }); else temp.push(data[j].value); } } switch (type) { case 'bar': var series_temp = { name: group[i], data: temp, type: chart_type }; if (is_stack) series_temp = $.extend({}, { stack: 'stack' }, series_temp); break; case 'map': var series_temp = { name: group[i], type: chart_type, mapType: 'china', selectedMode: 'single', itemStyle: { normal: { label: { show: true} }, emphasis: { label: { show: true} } }, data: temp }; break; case 'line': var series_temp = { name: group[i], data: temp, type: chart_type }; if (is_stack) series_temp = $.extend({}, { stack: 'stack' }, series_temp); break; default: var series_temp = { name: group[i], data: temp, type: chart_type }; } series.push(series_temp); } return { category: group, xAxis: xAxis, series: series }; }, |
|
1
|
2.3 各种图表类型的配置初始化
在通过2.2步骤将从后台获得的数据进行初始化之后，我们就可以进行图表的option的配置了，在这里我主要对常用的饼图、柱图（单一、分组、堆积柱图）、折线图（分组、堆积折线图）、柱图+折线（增幅）图、中国地图等图进行了配置项的初始化。具体实现如下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
|
ChartOptionTemplates: { CommonOption: {//通用的图表基本配置 tooltip: { trigger: 'axis'//tooltip触发方式:axis以X轴线触发,item以每一个数据项触发 }, toolbox: { show: true, //是否显示工具栏 feature: { mark: true, dataView: { readOnly: false }, //数据预览 restore: true, //复原 saveAsImage: true //是否保存图片 } } }, CommonLineOption: {//通用的折线图表的基本配置 tooltip: { trigger: 'axis' }, toolbox: { show: true, feature: { dataView: { readOnly: false }, //数据预览 restore: true, //复原 saveAsImage: true, //是否保存图片 magicType: ['line', 'bar']//支持柱形图和折线图的切换 } } }, Pie: function (data, name) {//data:数据格式：{name：xxx,value:xxx}... var pie_datas = ECharts.ChartDataFormate.FormateNOGroupData(data); var option = { tooltip: { trigger: 'item', formatter: '{b} : {c} ({d}/%)', show: true }, legend: { orient: 'vertical', x: 'left', data: pie_datas.category }, series: [ { name: name || "", type: 'pie', radius: '65%', center: ['50%', '50%'], data: pie_datas.data } ] }; return $.extend({}, ECharts.ChartOptionTemplates.CommonOption, option); },Lines: function (data, name, is_stack) { //data:数据格式：{name：xxx,group:xxx,value:xxx}... var stackline_datas = ECharts.ChartDataFormate.FormateGroupData(data, 'line', is_stack); var option = { legend: { data: stackline_datas.category }, xAxis: [{ type: 'category', //X轴均为category，Y轴均为value data: stackline_datas.xAxis, boundaryGap: false//数值轴两端的空白策略 }], yAxis: [{ name: name || '', type: 'value', splitArea: { show: true } }], series: stackline_datas.series }; return $.extend({}, ECharts.ChartOptionTemplates.CommonLineOption, option); },Bars: function (data, name, is_stack) {//data:数据格式：{name：xxx,group:xxx,value:xxx}... var bars_dates = ECharts.ChartDataFormate.FormateGroupData(data, 'bar', is_stack); var option = { legend: bars_dates.category, xAxis: [{ type: 'category', data: bars_dates.xAxis, axisLabel: { show: true, interval: 'auto', rotate: 0, margion: 8 } }], yAxis: [{ type: 'value', name: name || '', splitArea: { show: true } }], series: bars_dates.series }; return $.extend({}, ECharts.ChartOptionTemplates.CommonLineOption, option); }, ……..//其他的图表配置，如柱图+折线、地图……..} |
2.4 图形的渲染
在配置好图表类型的option之后，就可进行图表的渲染了，具体的代码实现如下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
Charts: { RenderChart: function (option) { require([ 'echarts', 'echarts/chart/line', 'echarts/chart/bar', 'echarts/chart/pie', 'echarts/chart/k', 'echarts/chart/scatter', 'echarts/chart/radar', 'echarts/chart/chord', 'echarts/chart/force', 'echarts/chart/map' ], function (ec) { echarts = ec; if (option.chart && option.chart.dispose) option.chart.dispose(); option.chart = echarts.init(option.container); window.onresize = option.chart.resize; option.chart.setOption(option.option, true); }); }, ……..//渲染其他的图表类型，如：地图 …….. } |
3. 具体页面的使用
经过2步骤中的一些列的配置、处理、初始化，我们就可以具体的使用了，在每一个aspx页面使用之前，我们首先需要在页面的标题引入以下的文件：
|
1
2
3
4
5
|
<script src="/Scripts/jquery-1.4.1.js" type="text/javascript"></script><script src="/Statics/echarts/esl.js" type="text/javascript"></script><script src="/Statics/ECharts.js" type="text/javascript"></script> |
引入之后就可进行使用了，下面演示几个常用的图表的使用：
首页每个aspx页面上都有一个div用来做渲染图表的容器，如下：
<div id="echart" style="100%; height:400px;"></div>
3.1 饼图
3.1.1 实现代码
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
<script type="text/javascript"> $( function () { var data = [{ name: 'olive', value: 20 }, { name: 'only', value: 20 }, { name: 'momo', value: 20}]; var option = ECharts.ChartOptionTemplates.Pie(data); var container = $("#echart")[0]; opt = ECharts.ChartConfig(container, option); ECharts.Charts.RenderChart(opt); } );</script> |
3.1.2 展示效果
3.2 柱图
3.2.1 实现代码
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
<script type="text/javascript"> $( function () { var data = [{ name: 'olive', value: 20 }, { name: 'only', value: 20 }, { name: 'momo', value: 20}]; var option = ECharts.ChartOptionTemplates.Bar(data); var container = $("#echart")[0]; opt = ECharts.ChartConfig(container, option); ECharts.Charts.RenderChart(opt); });$( function () { var data = [{ name: '2014-01', value: 20, group: 'A' }, { name: '2014-01', value: 40, group: 'B' }, { name: '2014-02', value: 30, group: 'A' }, { name: '2014-02', value: 10, group: 'B' }, { name: '2014-03', value: 200, group: 'A' }, { name: '2014-03', value: 60, group: 'B' }, { name: '2014-04', value: 50, group: 'A' }, { name: '2014-04', value: 45, group: 'B' }, { name: '2014-05', value: 110, group: 'A' }, { name: '2014-05', value: 80, group: 'B' }, { name: '2014-06', value: 90, group: 'A' }, { name: '2014-06', value: 60, group: 'B'}]; var option = ECharts.ChartOptionTemplates.Bars(data,'Love'); var container = $("#echart")[0]; opt = ECharts.ChartConfig(container, option); ECharts.Charts.RenderChart(opt); var option = ECharts.ChartOptionTemplates.Bars(data, 'Love', true); var container = $("#echart1")[0]; opt = ECharts.ChartConfig(container, option); ECharts.Charts.RenderChart(opt); } );</script> |
3.2.2展示效果
3.3 折线图
3.3.1 实现代码
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
|
<script type="text/javascript"> $(function () { var data = [ { name: '2013-01', group: 'olive', value: 116 }, { name: '2013-01', group: 'momo', value: 115 }, { name: '2013-01', group: 'only', value: 222 }, { name: '2013-01', group: 'for', value: 324 }, { name: '2013-02', group: 'olive', value: 156 }, { name: '2013-02', group: 'momo', value: 185 }, { name: '2013-02', group: 'only', value: 202 }, { name: '2013-02', group: 'for', value: 34 }, { name: '2013-03', group: 'olive', value: 16 }, { name: '2013-03', group: 'momo', value: 51 }, { name: '2013-03', group: 'only', value: 22 }, { name: '2013-03', group: 'for', value: 84 } ]; var opt = HighChart.ChartOptionTemplates.Line(data, 'Love-Rate', "折线图示例"); var container = $("#container"); HighChart.RenderChart(opt, container); }); $( function () { var data = [{ name: '2014-01', value: 20, group: 'A' }, { name: '2014-01', value: 40, group: 'B' }, { name: '2014-02', value: 30, group: 'A' }, { name: '2014-02', value: 10, group: 'B' }, { name: '2014-03', value: 200, group: 'A' }, { name: '2014-03', value: 60, group: 'B' }, { name: '2014-04', value: 50, group: 'A' }, { name: '2014-04', value: 45, group: 'B' }, { name: '2014-05', value: 110, group: 'A' }, { name: '2014-05', value: 80, group: 'B' }, { name: '2014-06', value: 90, group: 'A' }, { name: '2014-06', value: 60, group: 'B'}]; var option = ECharts.ChartOptionTemplates.Lines(data,'lines',false); var container = $("#echart")[0]; opt = ECharts.ChartConfig(container, option); ECharts.Charts.RenderChart(opt); var option = ECharts.ChartOptionTemplates.Lines(data, 'lines', true); var container = $("#echart1")[0]; opt = ECharts.ChartConfig(container, option); ECharts.Charts.RenderChart(opt); } ); </script> |
3.3.2展示效果
3.4 柱图+折线（增幅）图
3.4.1 展示效果
3.5 地图
3.5.3 展示效果
到这里，基本就把echart的抽象跟使用讲完了，因为时间的关系，还有一些图形的配置、数据处理没有列出代码，但是基本上实现都差不多。希望能给大家带来一些帮助和启发。后续会继续推出HightCharts的抽象使用，敬请期待。