方式一:模块化包引入

如果你的项目本身就是模块化的,那引入echarts将很简单,只需要配置好packet路径指向src即可,而且你还可以实现图表的按需加载,由于echarts依赖底层zrender,建议你同时下载zrender到本地,可参考demo,你需要配置如下。

需要注意的是,包引入提供了开发阶段最大的灵活性,但并不适合直接上线,减少请求的文件数量是前端性能优化中很基本也是很重要的规则,务必在上线时做文件的连接压缩,实例代码如下所示:

//from echarts example
require.config({
    packages: [
        {
            name: 'echarts',
            location: '../../src',      
            main: 'echarts'
        },
        {
            name: 'zrender',
            location: '../../../zrender/src', // zrender与echarts在同一级目录
            main: 'zrender'
        }
    ]
});

方式二:模块化单文件引入(推荐)

我们建议你使用单一文件引入,如你所发现的,build文件夹下已经生成了多个单文件见下,根据你的需求使用:

1、echarts.js : 经过压缩,包含除地图外的全部图表

2、echarts-original.js : 未压缩,可用于调试,包含除地图外的全部图表

3、echarts-map.js : 经过压缩,全图表,包含world,china以及34个省市级地图数据

4、echarts-original-map.js : 未压缩,可用于调试,全图表,包含world,china以及34个省市级地图数据

如果需要更加定制的打包文件,建议在node环境下安装require.js,build文件夹内为你准备好配置项,可根据你的项目需求,修改config-tpl.js以构建你的最佳配置。

采用单一文件使用例子见ECharts单一文件引入,存放在example/www下,你需要配置如下:

 

//from echarts example
require.config({
    paths:{ 
        'echarts:'./js/echarts',
        'echarts/chart/bar' : './js/echarts',       // 把所需图表指向单文件
        'echarts/chart/line': './js/echarts'
    }
});

 

//from echarts example
require(
    [
        'echarts',
        'echarts/chart/line',   // 按需加载所需图表
        'echarts/chart/bar'
    ],
    function (ec) {
        var myChart = ec.init(domMain);
        var option = {
            ...
        }
        myChart.setOption(option);
    }
);

总结来说,模块化如何引入ECharts,你都需要如下4步:

1、引入一个模块加载器,如esl.js或者require.js

2、为ECharts准备一个具备大小(宽高)的Dom(当然可以是动态生成的)

3、为模块加载器配置echarts的路径,从当前页面链接到echarts.js,见上述说明

4、动态加载echarts然后在回调函数中开始使用(容我罗嗦一句,当你确保同一页面已经加载过echarts,再使用时直接require('echarts').init(dom)就行)

方式三:标签式单文件引入

 

自1.3.5开始,ECharts提供标签式引入。如果你 的项目本身并不是基于模块化开发的,或者是基于CMD规范(如使用的是seajs),那么引入基于AMD模块化的echarts可能并不方便,我们建议你 采用srcipt标签式引入,忘掉require,srcipt标签引入echarts后将可以直接使用两个全局的命名空 间:echarts,zrender,可参考ECharts标签式引入

//from echarts example
< script src="example/www2/js/echarts-plain.js" data-ke-src="example/www2/js/echarts-plain.js" > < /script>
< script >
    var myChart = echarts.init(domMain);
    var option = {
        ...
    }
    myChart.setOption(option);
< /script>

可以直接引入的单文件如下:

1、echarts-plain.js : 经过压缩,包含除地图外的全部图表

2、echarts-plain-original.js : 未压缩,可用于调试,包含除地图外的全部图表

3、echarts-plain-map.js : 经过压缩,全图表,包含world,china以及34个省市级地图数据

4、echarts-plain-original-map.js : 未压缩,可用于调试,全图表,包含world,china以及34个省市级地图数据