异步数据加载和更新

异步数据加载和更新

异步加载

入门示例中的数据是在初始化后setOption中直接填入的，但是很多时候可能数据需要异步加载后再填入。ECharts 中实现异步数据的更新非常简单，在图表初始化后不管任何时候只要通过 jQuery 等工具异步获取数据后通过 setOption 填入数据和配置项就行。

  2. 1. var myChart = echarts.init(document.getElementById('main'));
  4. 3. $.get('data.json').done(function (data) {
  5. 4. myChart.setOption({
  6. 5. title: {
  7. 6. text: '异步数据加载示例'
  8. 7. },
  9. 8. tooltip: {},
  10. 9. legend: {
  11. 10. data:['销量']
  12. 11. },
  13. 12. xAxis: {
  14. 13. data: ["衬衫","羊毛衫","雪纺衫","裤子","高跟鞋","袜子"]
  15. 14. },
  16. 15. yAxis: {},
  17. 16. series: [{
  18. 17. name: '销量',
  19. 18. type: 'bar',
  20. 19. data: [5, 20, 36, 10, 10, 20]
  21. 20. }]
  22. 21. });
  23. 22. });

或者先设置完其它的样式，显示一个空的直角坐标轴，然后获取数据后填入数据。

  2. 1. var myChart = echarts.init(document.getElementById('main'));
  3. 2. // 显示标题，图例和空的坐标轴
  4. 3. myChart.setOption({
  5. 4. title: {
  6. 5. text: '异步数据加载示例'
  7. 6. },
  8. 7. tooltip: {},
  9. 8. legend: {
  10. 9. data:['销量']
  11. 10. },
  12. 11. xAxis: {
  13. 12. data: []
  14. 13. },
  15. 14. yAxis: {},
  16. 15. series: [{
  17. 16. name: '销量',
  18. 17. type: 'bar',
  19. 18. data: []
  20. 19. }]
  21. 20. });
  23. 22. // 异步加载数据
  24. 23. $.get('data.json').done(function (data) {
  25. 24. // 填入数据
  26. 25. myChart.setOption({
  27. 26. xAxis: {
  28. 27. data: data.categories
  29. 28. },
  30. 29. series: [{
  31. 30. // 根据名字对应到相应的系列
  32. 31. name: '销量',
  33. 32. data: data.data
  34. 33. }]
  35. 34. });
  36. 35. });

如下： https://echarts.baidu.com/gallery/view.html?c=doc-example/tutorial-async&edit=1&reset=1

ECharts 中在更新数据的时候需要通过name属性对应到相应的系列，上面示例中如果name不存在也可以根据系列的顺序正常更新，但是更多时候推荐更新数据的时候加上系列的name数据。

loading 动画

如果数据加载时间较长，一个空的坐标轴放在画布上也会让用户觉得是不是产生 bug 了，因此需要一个 loading 的动画来提示用户数据正在加载。

ECharts 默认有提供了一个简单的加载动画。只需要调用 showLoading 方法显示。数据加载完成后再调用 hideLoading 方法隐藏加载动画。

  2. 1. myChart.showLoading();
  3. 2. $.get('data.json').done(function (data) {
  4. 3. myChart.hideLoading();
  5. 4. myChart.setOption(...);
  6. 5. });

效果如下： https://echarts.baidu.com/gallery/view.html?c=doc-example/tutorial-loading&edit=1&reset=1

数据的动态更新

ECharts 由数据驱动，数据的改变驱动图表展现的改变，因此动态数据的实现也变得异常简单。

所有数据的更新都通过 setOption实现，你只需要定时获取数据，setOption 填入数据，而不用考虑数据到底产生了那些变化，ECharts 会找到两组数据之间的差异然后通过合适的动画去表现数据的变化。

ECharts 3 中移除了 ECharts 2 中的 addData 方法。如果只需要加入单个数据，可以先 data.push(value) 后 setOption

具体可以看下面示例： https://echarts.baidu.com/gallery/view.html?c=doc-example/tutorial-dynamic-data&edit=1&reset=1