ECharts 安装
从上小节学习,相信大家已经了解到了 ECharts 的作用以及它的优势。那么本小节我们就来看一下 学习 ECharts 的第一步 “安装”。ECharts 也像其他的 JavaScript 库那样,它的安装及其简单且多种多样,如果你想要及的使用,只需一行就够了!快来一起看看吧。
直接下载编译或通过 npm
安装 ECharts 包。
解释:
可直接到 github 下载 ECharts 编译,以 4.5.0 为例,下载地址:,打开可看到多个编译版本:
几个主要版本分别为:
剩下的中,名字带 en
的是对应版本的英文版;名字带 min
的是对应版本的压缩版。下载完成后,需要在使用 <script src="echarts.js"></script>
引入。
可以通过 CDN 引入 ECharts :
<!-- bootstrap 服务 -->
<!-- bootstrap 提供的免费CDN服务,亲测非常稳定 -->
<script src="//cdn.bootcss.com/echarts/4.5.0/echarts.common.js"></script>
<!-- 云存储服务 -->
<!-- 国内速度稳定,开放性强 -->
<script src="//cdn.staticfile.org/echarts/4.5.0/echarts.common.js"></script>
<!-- jsdeliver 服务 -->
<!-- 微软的CDN服务,虽然国内比不上国内CDN,但速度不至于太慢,有国际化需求的可以试试 -->
<script src="//cdn.jsdelivr.net/npm/echarts@4.5.0/echarts.common.js"></script>
<!-- cdnjs 服务 -->
<!-- 非常全的CDN服务,存储了大多数主流的js、css、库 -->
<script src="//cdnjs.cloudflare.com/ajax/libs/echarts/4.5.0/echarts.common.js"></script>
安装命令:
npm install echarts
// 或
yarn add echarts
安装完毕后,使用如下引入:
// 使用commonjs:
const echarts = require('echarts');
// ES6的环境也可以使用
import echarts from 'echarts';
上述语句引入 node_modules/echarts/index.js
,认包含 ECharts 图表和组件。根据项目需求,可以选择引入不同版本:
// 认引入完整版
import echarts from 'echarts';
// 引入常用版
import * as echarts from 'echarts/echarts.common.js';
// 引入精简版
import * as echarts from 'echarts/echarts.simple.js';
如果上述版本均不符合需求,可选择按需引入:
// 引入基础模块
import echarts from 'echarts/lib/echarts';
// 引入柱状图
import 'echarts/lib/chart/bar';
// 引入组件
import 'echarts/lib/component/title';
按需引入的模块,可参考 。
如果项目需求比较简单,建议直接下载使用编译。如果项目环境允许使用公共 CDN,建议使用 CDN 方式引入编译,可获得更好 HTTP 。如果开发环境已经配备 webpack、rollup 等工程化环境,则应优先使用 npm
安装,并将 ECharts 与项目中使用到的其他第三方框架一起打包,减少客户端请求数。
使用时,可根据需求,在 echarts.js
、echarts.common.js
、echarts.simple.js
之间选择最合适的编译版本。个人经验是优先使用 echarts.common.js
,但需求无法满足时再使用 echarts.js
,如果运行环境比较苛刻,如 3G 网络下,则自行构建最轻量级的版本,构建方式可参阅第二节 。