echarts

2017-08-08  本文已影响1276人  codeSirCao

第一步

获取echarts

1:从官网下载界面选择你需要的版本下载,根据开发者功能和体积上的需求,我们提供了不同打包的下载,如果你在体积上没有要求,可以直接下载完整版本。开发环境建议下载源代码版本,包含了常见的错误提示和警告。

2:在 ECharts 的 GitHub 上下载最新的 release
版本,解压出来的文件夹里的 dist
目录里可以找到最新版本的 echarts 库。

3:通过 npm 获取 echarts,npm install echarts --save
,详见“在 webpack 中使用 echarts

4:cdn 引入,你可以在 cdnjsnpmcdn 或者国内的 bootcdn 上找到 ECharts 的最新版本
【注意】
ECharts 3 开始不再强制使用 AMD 的方式按需引入,代码里也不再内置 AMD 加载器。因此引入方式简单了很多,只需要像普通的 JavaScript 库一样用 script 标签引入。

第二部

引入 ECharts.js 因为我是npm下载的
 <!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<!-- 引入 ECharts 文件 -->
<script src="echarts.min.js"></script>
</head>
</html>

第三步

绘制一个简单的图表

在绘图前我们需要为 ECharts 准备一个具备高宽的 DOM 容器。

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>ECharts</title>

<script src="node_modules/echarts/dist/echarts.min.js"></script>
</head>
<body>

<div id="main" style="width: 600px;height:400px;"></div>
<script type="text/javascript">
// 基于准备好的dom,初始化echarts实例
var myChart = echarts.init(document.getElementById('main'));

                // 指定图表的配置项和数据
                var option = {
                 title: {
                  text: 'ECharts 入门示例'
                },
                tooltip: {},
                legend: {
                  data:['销量']
                },
                xAxis: {
                  data: ["衬衫","羊毛衫","雪纺衫","裤子","高跟鞋","袜子"]
                },
                yAxis: {},
                series: [{
                  name: '销量',
                  type: 'bar',
                  data: [5, 20, 36, 10, 10, 20]
                }]
              };

                // 使用刚指定的配置项和数据显示图表。
                myChart.setOption(option);
              </script>
            </body>
Paste_Image.png

Webpack使用

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

 npm 安装 ECharts

在 3.1.1
版本之前 ECharts 在 npm 上的 package 是非官方维护的,从 3.1.1
开始由官方 EFE 维护 npm 上 ECharts 和 zrender 的 package。
你可以使用如下命令通过 npm 安装 ECharts

第一步

 npm install echarts --save

第二步

引入 ECharts

通过 npm 上安装的 ECharts 和 zrender 会放在node_modules目录下。可以直接在项目代码中

 var echarts = require('echarts');//得到 ECharts。
 // 基于准备好的dom,初始化echarts实例
  var myChart = echarts.init(document.getElementById('main'));
 // 绘制图表
 myChart.setOption({ 
    title: { text: 'ECharts 入门示例' },
    tooltip: {},
    xAxis: { data: ["衬衫","羊毛衫","雪纺衫","裤子","高跟鞋","袜子"] },
    yAxis: {}, 
    series: [{ name: '销量', type: 'bar', data: [5, 20, 36, 10, 10, 20] }]
 });

第二种

按需引入 ECharts 图表和组件
默认使用 require('echarts')

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

例如

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

// 引入 ECharts 主模块
var echarts = require('echarts/lib/echarts');
// 引入柱状图
 require('echarts/lib/chart/bar');
// 引入提示框和标题组件   
 require('echarts/lib/component/tooltip');
 require('echarts/lib/component/title');
 // 基于准备好的dom,
  初始化echarts实例
 var myChart = echarts.init(document.getElementById('main'));
 // 绘制图表
myChart.setOption({ 
 title: { text: 'ECharts 入门示例' }, 
 tooltip: {}, 
 xAxis: { data: ["衬衫","羊毛衫","雪纺衫","裤子","高跟鞋","袜子"] }, 
 yAxis: {}, 
 series: [{ name: '销量', type: 'bar', data: [5, 20, 36, 10, 10, 20] }]
 });

可以按需引入的模块列表见 https://github.com/ecomfe/echarts/blob/master/index.js
对于另一个流行的模块打包工具 browserify 也是同样的用法,这里就不赘述了。
待更新。。。。。

上一篇下一篇

猜你喜欢

热点阅读