Echarts
- Echarts 相关文档
0.1 官网
0.2 配置项
http://echarts.baidu.com/option.html
0.3 API
http://echarts.baidu.com/api.html
- 一些常用的配置项
2.1 title 设置图表的标题
2.2 tooltip 图表上的提示框
其中,有一个formatter配置项,可以配置显示的内容,具体的配置方法,参考上面的文档
2.3 legend 图例
其中的 data 的配置,每一项代表一个系列(series)的 name,name
必须完全相同
2.4 toolbox 五种类型的工具
2.5 grid 网格
直角坐标系内绘图网格,单个 grid 内最多可以放置上下两个 X 轴,左右两个 Y 轴。可以在网格上绘制折线图,柱状图,散点图(气泡图)。
在 ECharts 2.x 里单个 echarts 实例中最多只能存在一个 grid 组件,在 ECharts 3 中可以存在任意个 grid 组件。
2.6 xAxis x轴
直角坐标系 grid 中的 x 轴,单个 grid 组件最多只能放上下两个 x 轴。
关键属性:
Type: 坐标轴类型。
Position: 坐标轴所在的位置,
2.7 yAxis y轴
直角坐标系 grid 中的 y 轴,单个 grid 组件最多只能放左右两个 y 轴。
2.8 series 系列列表。
每个系列通过 type
决定自己的图表类型,不同的图表类型,其配置项也有所不同,具体的配置项,参考文档:http://echarts.baidu.com/option.html#series
- 3. echarts 中的几个重要对象及实例化过程
3.1 echarts 对象
全局 echarts 对象,在 script 标签引入 echarts.js
文件后获得。
常用的方法:init
echarts.init: 创建一个 ECharts 示例,返回echartsInstance,不能再单个容器上初始化多个 ECharts 实例。
3.2 echartsInstance 对象
通过 echarts.init创建的实例。
常用方法:setOption
方法签名:
方法作用:
设置图表实例的配置项以及数据,万能接口,所有参数和数据的修改都可以通过setOption
完成,ECharts 会合并新的参数和数据,然后刷新图表。如果开启动画的话,ECharts 找到两组数据之间的差异然后通过合适的动画去表现数据的变化。
参数含义:
option
图表的配置项和数据,具体见配置项手册。
notMerge
可选,是否不跟之前设置的option
进行合并,默认为false
,即合并。
notRefreshImmediately
可选,在设置完option
后是否不立即刷新画布,默认为false
,即立即刷新。
- echarts3 中地图的使用
echarts3 的js 实现中并没有将地图数据集成进去,所以当使用地图时需要,单独引入地图数据,地图数据的下载:http://echarts.baidu.com/download-map.html
引入地图的代码:
<script src="echarts.js"></script>
<!—引入地图数据 –>
<script src="china.js"></script>
<script>
var chart = echarts.init(document.getElementById(‘main‘));
chart.setOption({
series: [{
type: ‘map‘,
map: ‘china‘
}]
});
</script>
- echarts 特性
echarts 的配置项非常多,非常灵活,需要注意的是,在某些情况下,大多数配置项都是可选的,但是,有些配置项则是必须的,然而, echarts 在某些必须缺失的情况下,仍然能够将图表显示出来,此时就会出现一些问题,例如,注册事件不会成功,这些问题非常隐蔽,找起来非常麻烦,所以一定要注意。例如:当series 是 map 的的时候,如果,其 data 字段没有值,地图仍然会正常显示,但是tooltip 就无法显示了,同时,这时注册事件时,就不会成功。