更新时间：2016年5月2日12:18:16

2016年1月12日，ECharts3.0.0版本发布，本文档写于1月13日，具有时效性。
2016年1月18日，ECharts3.0.1版本发布；
2016年1月24日，ECharts3.0.2版本发布；
2016年2月22日，ECharts3.1.1版本发布 ;
官方提供NPM支持，fix bugs。
2016年3月02日，ECharts3.1.2版本发布；
官方提供多Theme下载支持，fix bugs。
2016年3月10日，ECharts3.1.3版本发布
雷达图，webpack构建，fix bugs。
2016年3月21日，ECharts3.1.4版本发布
2016年3月29日，ECharts3.1.5版本发布
2016年4月11日，ECharts3.1.6版本发布
2016年4月21日，ECharts3.1.7版本发布,详见changelog
fix bugs。

不过定期会进行修改，望周知。另：本人并非ECharts团队成员，写这篇文字纯粹为了支持社区。

推荐阅读官方->ECharts 3 带来了什么

关键字

  • UI，主题
  • 拖拽重计算
  • 属性事件用法
  • 移动端
  • BUG
  • etc…

整理成一句就是：3.x是大更新，目前尚不稳定，但肯定会更优秀。

提问的方式

  1. 是什么样的问题，想清楚怎么描述？
  2. 是自己的问题，不会多了逗号吧？囧
  3. 是ECharts的问题，console里有奇怪的log？
  4. 提issue或者群里提问[注意最好提供完整的option，截图，并说明版本]
  5. 多看文档多实践，多看文档多实践，多看文档多实践。重要的事情说三遍，也想三遍
  6. 添加一个例子，issues2475

建议

ECharts是百度全端团队EFE做的免费开源的项目，历经几年，越来越好。
如果你希望用到最新的UI，最好的图表，且商业使用免费的话，那么选择BSD协议的ECharts就对了。
BUT，事实上，如果你的项目有很多限制，或者别的原因，正式项目可以先不用切换成最新的3.x版本，可以使用比较稳定的2.2.7版本，不过我也建议你试用一下，可以帮助社区改进。

还有就是，初始版本bug多,但是不会再有breaking changes了，也请大家多多包涵，再说一下初期的版本切换原则。

正式项目看上了新的图表，例如原来d3里有的【平行坐标系】新图表，支持gexf的关系图，或者新的冷酷UI，或者以往2.x时对移动端的不够好等等，可以切换。若暂时没有大的情况，先不要修改正式项目或者以往项目的2.x系。

测试项目，抓紧上，发现的BUG多，回头发糖吃，哈哈哈。

TIPS

1:文档的读法

建议首先阅读一下参考手册2.x版本，里面会介绍基本图表的一些知识，让你明白什么是坐标系，什么是序列数据，什么是配置项，每种图表是哪种样子？

没有编程基础的童鞋也没关系，可以再阅读一下上手基本教程，基本上在例子的基础上，修改一下属性，看一下实时效果是没有问题的。

如果想修改一下特性，又不知道具体的属性是什么，这时候第一靠猜，第二是慢慢找了。不过基本上你对最外层的属性熟悉了，再去找也就自然而然了。

举个例子

问：如何想修改柱状图的颜色？

答：第一肯定想到series序列，bar图表里面的属性基本没有什么特殊性，与line，pie基本都是一样的，一共也只有22个属性，大致浏览一下也只需要1分钟时间，会定位到itemStyle类似这样的样式属性上，接下来只需要细看文档就好了。

问：如何刷新图表？怎么调用？

答：事件API文档打开，一共4项。

  • 全局ECharts对象：echarts
  • 通过 echarts.init 创建的实例：echartsInstance
  • ECharts 中支持的图表行为，通过 dispatchAction 触发：action
  • ECharts 中的事件列表：events

因为2.x与3.x代码相差比较大，这里以最新的3.x为例。ECharts 3.x版本里所有的事件均是可以通过dispatchAction来触发，包括你读代码，也会发现这也是源代码调用不同组件事件的写法。

etc….陆续会再写一篇，问题答疑类

2：待定

传送门

ECharts3.x相关

ECharts2.x相关

注：2.x版本官网有些以往存储的链接可能失效，是因为官网对结构进行了变更，不要认为官网挂掉了。

ECharts3.x离线版文档

QQ交流群

QQ群：465958031,里面的群管理员全是百度的成员。

需要注意的是：ECharts项目是这些成员所谓20%的时间做出来的，平时可能还会有别的开发任务。

所以….你可能遇到以下几种情况：

  • 群里提的问题，没人回答
  • ISSUES上提的，没人回答
  • 私聊，没人回答
  • 加好友，没人同意
  • etc

SO…
如果，你确认是BUG的话，请到issues上面提，开发人员100%会看，暂时没看的话有可能正在确认，也希望大家能把问题想清楚，描述清楚。因为童鞋们都是有工作任务的人，不可能一方面兼顾到所有人，一方面还能完成自己的工作任务，所以私聊，加好友大家还是不要想了。不过在群里@他们，他们看到肯定会有回复的。