ECharts使用心得
前言
上周项目组要临时给客户做一个演示的原型,首页设计的是一个中国地图,本来打算用谷歌的地图,但是,做出来之后,整体的效果看起来太差了,最后就在网上搜相关的地图呈现的控件,然后就找到了这个ECharts报表呈现组件,挺不错的一个组件,而且地图数据都是离线的,真心很赞。但是,使用起来却颇费了一番工夫。所以就把使用中的一些心得体会跟大家分享一下。
1. 插件的下载
以下是ECharts的下载链接,需要注意的是ECharts内部也是依赖于另一个插件的叫ZRender,当然对于大部分图表而言不需要ZRender的,但是对于地图控件及其他复杂的呈现控件而已都是需要ZRender的。为了避免不要的问题出现,建议大家在下载ECharts时同时也要下载ZRender。
ECharts下载地址: http://echarts.baidu.com/
ZRender下载地址:http://ecomfe.github.io/zrender/index.html
下载之后解压各自的文件目录结构如下:
ECharts:
ZRender:
2. 插件的引用
首先,新建一个Web应用程序,然后添加刚刚下载的文件,具体的目录结构如下:
这里有以下几点需要说明:
l 所有的跟ECharts有关的文件全部都在echarts文件夹下
l echarts文件夹的内容分为两部分
1) 一部分是以echarts开头的js文件,这些文件全部来自于1.中的ECharts文件目录中的js文件夹下的文件,也就是1.中的图中红框标注的js下的文件。如下:
2) 另一部分是一个名为zrender的文件夹,这里需要特别注意的是该文件夹的命名必须为zrender,因为在echarts的js文件中对zrender的引用都是以zrender为根目录的,zrender文件夹的内容即为1.中zrender文件目录中的src文件夹下的内容,如下:
3. 在页面中的具体使用
按照上边的步骤配置过之后,我们就可以在页面中引用了,这里我主要是演示地图控件的使用方式,因为地图的引用跟其他的基本图形的引用不太一样。其他的图形的呈现也会做一个简要的演示。
3.1 MapChart
首先在跟2中的echarts文件夹同一个目录(也就是Modules文件夹)下添加一个aspx页或html页,需要注意的是,如果是在aspx页中使用echarts时,需要把要渲染的div放在form标签之外,否则图形是显示不出来的。
3.1.1 在head标签中添加对echarts的引用如下:
[csharp] view
plain copy
- <head runat="server">
- <title></title>
- <script src="echarts/esl.js" type="text/javascript"></script>
- </head>
3.1.2 在body标记中,form标记之外,添加一个div,用来做图表渲染的容器。如下:
[csharp] view
plain copy
- <body>
- <div id="main"style="height:500px;border:1px solid #ccc;padding:10px;"></div>
- ……………
- ……………
- </body>
3.1.3 在3.1.3中添加的div标记下,添加如下的js代码段,如下:
[csharp] view
plain copy
- <script type="text/javascript">
- //为模块加载器配置echarts的路径,这里主要是配置map图表的路径,其他的图表跟map的配置还不太一样,下边也会做另一种类型的图表事例。
- 这里引用的主要是echarts文件夹下的echarts-map文件,而其他类型的图表引用的都是echarts文件夹下的echarts文件。
- require.config({
- paths: {
- echarts:‘./echarts/echarts‘,
- ‘echarts/chart/map‘:‘./echarts/echarts-map‘
- }
- });
- //动态加载echarts,在回掉函数中使用,要注意保持按需加载结构定义图表路径
- require(
- [
- ‘echarts‘,
- ‘echarts/chart/map‘
- ],
- function (ec) {
- varmyChart=ec.init(document.getElementById(‘main‘));
- //option主要是图标的一些设置,这不是这篇文章的重点,关于具体的设置可以参考官方的文档说明文档
- option= {
- title: {
- text:‘iphone销¨2量¢?‘,
- subtext:‘纯??属o?虚¨|构1‘,
- x:‘center‘
- },
- tooltip: {
- trigger:‘item‘
- },
- legend: {
- orient:‘vertical‘,
- x:‘left‘,
- data: [‘iphone3‘,‘iphone4‘,‘iphone5‘]
- },
- dataRange: {
- min:0,
- max:2500,
- text: [‘高?‘,‘低ì¨a‘], // 文?本à?,ê?默?认¨?为a数oy值|ì文?本à?
- calculable:true,
- textStyle: {
- color:‘orange‘
- }
- },
- toolbox: {
- show:true,
- orient:‘vertical‘,
- x:‘right‘,
- y:‘center‘,
- feature: {
- mark:true,
- dataView: { readOnly:false },
- restore:true,
- saveAsImage:true
- }
- },
- series: [
- {
- name:‘iphone3‘,
- type:‘map‘,
- mapType:‘china‘,
- selectedMode: ‘single‘,
- itemStyle: {
- normal: { label: { show:true },color:‘#ffd700‘ },// for legend
- emphasis: { label: { show:true} }
- },
- data: [
- { name:‘北à?à京?‘,value:Math.round(Math.random() *1000) },
- { name:‘天?¨?津¨°‘,value:Math.round(Math.random() *1000) },
- { name:‘上|?海?ê‘,value:Math.round(Math.random() *1000) },
- { name:‘重?庆¨?‘,value:Math.round(Math.random() *1000) },
- { name:‘河¨?北à?à‘,value:Math.round(Math.random() *1000) },
- { name:‘河¨?南?‘,value:Math.round(Math.random() *1000) },
- { name:‘云?南?‘,value:Math.round(Math.random() *1000) },
- { name:‘辽¢¨|宁t‘,value:Math.round(Math.random() *1000) },
- { name:‘黑¨2龙¢¨2江-‘,value:Math.round(Math.random() *1000) },
- { name:‘湖t南?‘,value:Math.round(Math.random() *1000) },
- { name:‘安?2徽?‘,value:Math.round(Math.random() *1000) },
- { name:‘山|?东?‘,value:Math.round(Math.random() *1000) },
- { name:‘新?疆?‘,value:Math.round(Math.random() *1000) },
- { name:‘江-苏?‘,value:Math.round(Math.random() *1000) },
- { name:‘浙?江-‘,value:Math.round(Math.random() *1000) },
- { name:‘江-西??‘,value:Math.round(Math.random() *1000) },
- { name:‘湖t北à?à‘,value:Math.round(Math.random() *1000) },
- { name:‘广?西??‘,value:Math.round(Math.random() *1000) },
- { name:‘甘¨o肃¨¤‘,value:Math.round(Math.random() *1000) },
- { name:‘山|?西??‘,value:Math.round(Math.random() *1000) },
- { name:‘内¨2蒙¨|古?‘,value:Math.round(Math.random() *1000) },
- { name:‘陕|?西??‘,value:Math.round(Math.random() *1000) },
- { name:‘吉a林¢?‘,value:Math.round(Math.random() *1000) },
- { name:‘福?ê建?§‘,value:Math.round(Math.random() *1000) },
- { name:‘贵¨?州Y‘,value:Math.round(Math.random() *1000) },
- { name:‘广?东?‘,value:Math.round(Math.random() *1000) },
- { name:‘青¨¤海?ê‘,value:Math.round(Math.random() *1000) },
- { name:‘西??藏?‘,value:Math.round(Math.random() *1000) },
- { name:‘四?川??§‘,value:Math.round(Math.random() *1000) },
- { name:‘宁t夏?‘,value:Math.round(Math.random() *1000) },
- { name:‘海?ê南?‘,value:Math.round(Math.random() *1000) },
- { name:‘台??§湾a?‘,value:Math.round(Math.random() *1000) },
- { name:‘香?港?‘,value:Math.round(Math.random() *1000) },
- { name:‘澳??门?‘,value:Math.round(Math.random() *1000) }
- ]
- },
- {
- name:‘iphone4‘,
- type:‘map‘,
- mapType:‘china‘,
- selectedMode: ‘single‘,
- itemStyle: {
- normal: { label: { show:true },color:‘#ff8c00‘ },// for legend
- emphasis: { label: { show:true} }
- },
- data: [
- { name:‘北à?à京?‘,value:Math.round(Math.random() *1000) },
- { name:‘天?¨?津¨°‘,value:Math.round(Math.random() *1000) },
- { name:‘上|?海?ê‘,value:Math.round(Math.random() *1000) },
- { name:‘重?庆¨?‘,value:Math.round(Math.random() *1000) },
- { name:‘河¨?北à?à‘,value:Math.round(Math.random() *1000) },
- { name:‘安?2徽?‘,value:Math.round(Math.random() *1000) },
- { name:‘新?疆?‘,value:Math.round(Math.random() *1000) },
- { name:‘浙?江-‘,value:Math.round(Math.random() *1000) },
- { name:‘江-西??‘,value:Math.round(Math.random() *1000) },
- { name:‘山|?西??‘,value:Math.round(Math.random() *1000) },
- { name:‘内¨2蒙¨|古?‘,value:Math.round(Math.random() *1000) },
- { name:‘吉a林¢?‘,value:Math.round(Math.random() *1000) },
- { name:‘福?ê建?§‘,value:Math.round(Math.random() *1000) },
- { name:‘广?东?‘,value:Math.round(Math.random() *1000) },
- { name:‘西??藏?‘,value:Math.round(Math.random() *1000) },
- { name:‘四?川??§‘,value:Math.round(Math.random() *1000) },
- { name:‘宁t夏?‘,value:Math.round(Math.random() *1000) },
- { name:‘香?港?‘,value:Math.round(Math.random() *1000) },
- { name:‘澳??门?‘,value:Math.round(Math.random() *1000) }
- ]
- },
- {
- name:‘iphone5‘,
- type:‘map‘,
- mapType:‘china‘,
- selectedMode: ‘single‘,
- itemStyle: {
- normal: { label: { show:true },color:‘#da70d6‘ },// for legend
- emphasis: { label: { show:true} }
- },
- data: [
- { name:‘北à?à京?‘,value:Math.round(Math.random() *1000) },
- { name:‘天?¨?津¨°‘,value:Math.round(Math.random() *1000) },
- { name:‘上|?海?ê‘,value:Math.round(Math.random() *1000) },
- { name:‘广?东?‘,value:Math.round(Math.random() *1000) },
- { name:‘台??§湾a?‘,value:Math.round(Math.random() *1000) },
- { name:‘香?港?‘,value:Math.round(Math.random() *1000) },
- { name:‘澳??门?‘,value:Math.round(Math.random() *1000) }
- ]
- }
- ]
- };
- //以下的这段代码主要是用来处理用户的选择,应用场景是可以做地图的交互,比如点击地图上的某一个省,获取相应的省的指标变化等。
- //需要特别注意的是,如果需要点击某一省作地图的操作交互的话,还需要为series属性的每一项添加一个selectedMode属性,这里的属性值为 ‘single‘即单选,也可多选
- varecConfig= require(‘echarts/config‘);
- myChart.on(ecConfig.EVENT.MAP_SELECTED,function (param) {
- varselected=param.selected;
- varmapSeries=option.series[0];
- vardata= [];
- varlegendData= [];
- varname;
- for (varp=0,len=mapSeries.data.length; p<len; p++) {
- name=mapSeries.data[p].name;
- mapSeries.data[p].selected=selected[name];
- if (selected[name]) {
- alert(name); //这里只是简单的做一个事例说明,弹出用户所选的省,如需做其他的扩展,可以在这里边添加相应的操作
- }
- }
- });
- myChart.setOption(option);
- }
- );
- </script>
3.1.4 完成以上操作之后,效果如下图所示:
3.2 LineChart
除了地图图表之外的其他的图标的使用方式都差不多。事实上其他的图表跟地图图表的区别在于对配置文件的引用。这里只做一个折线图的示例,其它的示例都是一样的。
3.2.1 跟3.1.1一样,引入echarts脚本
3.2.2 跟3.2.2一样,添加渲染图表的div容器
3.2.3 在3.2.2添加的div下添加如下js代码块
[csharp] view
plain copy
- <scripttype="text/javascript">
- require.config({
- paths: {
- echarts:‘./echarts/echarts‘,
- ‘echarts/chart/bar‘:‘./echarts/echarts‘,//这里需要注意的是除了mapchart使用的配置文件为echarts-map之外,
- 其他的图形引用的配置文件都为echarts,这也是一般的图形跟地图的区别
- ‘echarts/chart/line‘:‘./echarts/echarts‘
- }
- });
- require(
- [
- ‘echarts‘,
- ‘echarts/chart/bar‘,
- ‘echarts/chart/line‘
- ],
- function (ec) {
- varmyChart=ec.init(document.getElementById(‘main‘));
- option= {
- tooltip: {
- trigger:‘axis‘
- },
- legend: {
- data: [‘邮?¨o件t营?a销¨2‘,‘联¢a盟?广?告?‘,‘视o¨?频|ì广?告?‘,‘直?à接¨?访¤?问¨o‘,‘搜?索??引°y擎?‘]
- },
- toolbox: {
- show:true,
- feature: {
- mark:true,
- dataView: { readOnly:false },
- magicType: [‘line‘,‘bar‘],
- restore:true,
- saveAsImage:true
- }
- },
- calculable:true,
- xAxis: [
- {
- type:‘category‘,
- boundaryGap:false,
- data: [‘周¨1一°?‘,‘周¨1二t‘,‘周¨1三¨y‘,‘周¨1四?‘,‘周¨1五?‘,‘周¨1六¢¨′‘,‘周¨1日¨?‘]
- }
- ],
- yAxis: [
- {
- type:‘value‘,
- splitArea: { show:true }
- }
- ],
- series: [
- {
- name:‘邮?¨o件t营?a销¨2‘,
- type:‘line‘,
- stack:‘总á¨1量¢?‘,
- data: [120,132,101,134,90,230,210]
- },
- {
- name:‘联¢a盟?广?告?‘,
- type:‘line‘,
- stack:‘总á¨1量¢?‘,
- data: [220,182,191,234,290,330,310]
- },
- {
- name:‘视o¨?频|ì广?告?‘,
- type:‘line‘,
- stack:‘总á¨1量¢?‘,
- data: [150,232,201,154,190,330,410]
- },
- {
- name:‘直?à接¨?访¤?问¨o‘,
- type:‘line‘,
- stack:‘总á¨1量¢?‘,
- data: [320,332,301,334,390,330,320]
- },
- {
- name:‘搜?索??引°y擎?‘,
- type:‘line‘,
- stack:‘总á¨1量¢?‘,
- data: [820,932,901,934,1290,1330,1320]
- }
- ]
- };
- myChart.setOption(option);
- }
- );
- </script>
- <divid="main1"style="height:500px;border:1px solid #ccc;padding:10px;"></div>
- <scripttype="text/javascript">
- require.config({
- paths: {
- echarts:‘./echarts/echarts‘,
- ‘echarts/chart/bar‘:‘./echarts/echarts‘,
- ‘echarts/chart/line‘:‘./echarts/echarts‘
- }
- });
- require(
- [
- ‘echarts‘,
- ‘echarts/chart/bar‘,
- ‘echarts/chart/line‘
- ],
- function (ec) {
- varmyChart=ec.init(document.getElementById(‘main1‘));
- option= {
- title: {
- text:‘未??来¤??一°?周¨1气?温?变à?化?¥‘,
- subtext:‘纯??属o?虚¨|构1‘
- },
- tooltip: {
- trigger:‘axis‘
- },
- legend: {
- data: [‘最á?高?气?温?‘,‘最á?低ì¨a气?温?‘]
- },
- toolbox: {
- show:true,
- feature: {
- mark:true,
- dataView: { readOnly:false },
- magicType: [‘line‘,‘bar‘],
- restore:true,
- saveAsImage:true
- }
- },
- calculable:true,
- xAxis: [
- {
- type:‘category‘,
- boundaryGap:false,
- data: [‘周¨1一°?‘,‘周¨1二t‘,‘周¨1三¨y‘,‘周¨1四?‘,‘周¨1五?‘,‘周¨1六¢¨′‘,‘周¨1日¨?‘]
- }
- ],
- yAxis: [
- {
- type:‘value‘,
- axisLabel: {
- formatter:‘{value} °?C‘
- },
- splitArea: { show:true }
- }
- ],
- series: [
- {
- name:‘最á?高?气?温?‘,
- type:‘line‘,
- itemStyle: {
- normal: {
- lineStyle: {
- shadowColor:‘rgba(0,0,0,0.4)‘
- }
- }
- },
- data: [11,11,15,13,12,13,10]
- },
- {
- name:‘最á?低ì¨a气?温?‘,
- type:‘line‘,
- itemStyle: {
- normal: {
- lineStyle: {
- shadowColor:‘rgba(0,0,0,0.4)‘
- }
- }
- },
- data: [-2,1,2,5,3,2,0]
- }
- ]
- };
- myChart.setOption(option);
- }
- );
- </script>
- <divid="main2"style="height:500px;border:1px solid #ccc;padding:10px;"></div>
- <scripttype="text/javascript">
- require.config({
- paths: {
- echarts:‘./echarts/echarts‘,
- ‘echarts/chart/bar‘:‘./echarts/echarts‘,
- ‘echarts/chart/line‘:‘./echarts/echarts‘
- }
- });
- require(
- [
- ‘echarts‘,
- ‘echarts/chart/bar‘,
- ‘echarts/chart/line‘
- ],
- function (ec) {
- varmyChart=ec.init(document.getElementById(‘main2‘));
- option= {
- title: {
- text:‘某3楼£¤盘¨?销¨2售o?情¨|况?‘,
- subtext:‘纯??属o?虚¨|构1‘
- },
- tooltip: {
- trigger:‘axis‘
- },
- legend: {
- data: [‘意°a向¨°‘,‘预?è购o‘,‘成¨|交?‘]
- },
- toolbox: {
- show:true,
- feature: {
- mark:true,
- dataView: { readOnly:false },
- magicType: [‘line‘,‘bar‘],
- restore:true,
- saveAsImage:true
- }
- },
- calculable:true,
- xAxis: [
- {
- type:‘category‘,
- boundaryGap:false,
- data: [‘周¨1一°?‘,‘周¨1二t‘,‘周¨1三¨y‘,‘周¨1四?‘,‘周¨1五?‘,‘周¨1六¢¨′‘,‘周¨1日¨?‘]
- }
- ],
- yAxis: [
- {
- type:‘value‘
- }
- ],
- series: [
- {
- name:‘成¨|交?‘,
- type:‘line‘,
- smooth:true,
- itemStyle: { normal: { areaStyle: { type:‘default‘}} },
- data: [10,12,21,54,260,830,710]
- },
- {
- name:‘预?è购o‘,
- type:‘line‘,
- smooth:true,
- itemStyle: { normal: { areaStyle: { type:‘default‘}} },
- data: [30,182,434,791,390,30,10]
- },
- {
- name:‘意°a向¨°‘,
- type:‘line‘,
- smooth:true,
- itemStyle: { normal: { areaStyle: { type:‘default‘}} },
- data: [1320,1132,601,234,120,90,20]
- }
- ]
- };
- myChart.setOption(option);
- }
- );
- </script>
3.2.4 完成以上操作之后效果图如下:
好了,今天就总结到这里了,希望能给大家带来一些帮助。这里主要是介绍地图控件的使用,因为其官方文档上关于路径的配置写的很不清楚,所以才会想把这些走的弯路给总结一下。对于其他的图表控件的使用都很简单,大家可以参考官方的文档。http://echarts.baidu.com/doc/doc.html