在 webpack 中使用 ECharts

在 webpack 中使用 ECharts

Webpack 是目前比较流行的模块打包工具，你可以在使用 webpack 的项目中轻松的引入和打包 ECharts，这里假设你已经对 webpack 具有一定的了解并且在自己的项目中使用。

npm 安装 ECharts

在 3.1.1 版本之前 ECharts 在 npm 上的 package 是非官方维护的，从 3.1.1 开始由官方 EFE 维护 npm 上 ECharts 和 zrender 的 package。

你可以使用如下命令通过 npm 安装 ECharts

  2. 1. npm install echarts --save

引入 ECharts

通过 npm 上安装的 ECharts 和 zrender 会放在node_modules目录下。可以直接在项目代码中 require('echarts') 得到 ECharts。

  2. 1. var echarts = require('echarts');
  4. 3. // 基于准备好的dom，初始化echarts实例
  5. 4. var myChart = echarts.init(document.getElementById('main'));
  6. 5. // 绘制图表
  7. 6. myChart.setOption({
  8. 7. title: {
  9. 8. text: 'ECharts 入门示例'
  10. 9. },
  11. 10. tooltip: {},
  12. 11. xAxis: {
  13. 12. data: ['衬衫', '羊毛衫', '雪纺衫', '裤子', '高跟鞋', '袜子']
  14. 13. },
  15. 14. yAxis: {},
  16. 15. series: [{
  17. 16. name: '销量',
  18. 17. type: 'bar',
  19. 18. data: [5, 20, 36, 10, 10, 20]
  20. 19. }]
  21. 20. });

按需引入 ECharts 图表和组件

默认使用 require('echarts') 得到的是已经加载了所有图表和组件的 ECharts 包，因此体积会比较大，如果在项目中对体积要求比较苛刻，也可以只按需引入需要的模块。

例如上面示例代码中只用到了柱状图，提示框和标题组件，因此在引入的时候也只需要引入这些模块，可以有效的将打包后的体积从 400 多 KB 减小到 170 多 KB。

  2. 1. // 引入 ECharts 主模块
  3. 2. var echarts = require('echarts/lib/echarts');
  4. 3. // 引入柱状图
  5. 4. require('echarts/lib/chart/bar');
  6. 5. // 引入提示框和标题组件
  7. 6. require('echarts/lib/component/tooltip');
  8. 7. require('echarts/lib/component/title');
  10. 9. // 基于准备好的dom，初始化echarts实例
  11. 10. var myChart = echarts.init(document.getElementById('main'));
  12. 11. // 绘制图表
  13. 12. myChart.setOption({
  14. 13. title: {
  15. 14. text: 'ECharts 入门示例'
  16. 15. },
  17. 16. tooltip: {},
  18. 17. xAxis: {
  19. 18. data: ['衬衫', '羊毛衫', '雪纺衫', '裤子', '高跟鞋', '袜子']
  20. 19. },
  21. 20. yAxis: {},
  22. 21. series: [{
  23. 22. name: '销量',
  24. 23. type: 'bar',
  25. 24. data: [5, 20, 36, 10, 10, 20]
  26. 25. }]
  27. 26. });

可以按需引入的模块列表见 https://github.com/ecomfe/echarts/blob/master/index.js

对于流行的模块打包工具 browserify 也是同样的用法，这里就不赘述了。而对于使用 rollup 的自定义构建，参见 自定义构建 ECharts。