Echarts常用API主要包括echarts和echartsInstance两个对象。
1. echarts对象:
- echarts.init(dom, theme, opts):初始化一个echarts实例,传入dom节点、主题和配置项。
- echarts.version:获取echarts的版本号。
- echarts.registerMap(mapName, geoJson, specialAreas):注册自定义地图。
- echarts.getMap(mapName):获取地图的geoJson数据。
- echarts.registerTheme(themeName, theme):注册自定义主题。
- echarts.getTheme(themeName):获取主题数据。
- echarts.dispose(dom):销毁echarts实例,释放资源。
2. echartsInstance对象:
- setOption(option, notMerge, lazyUpdate):设置图表的配置项和数据,参数notMerge表示是否合并已有的配置项,默认为false,参数lazyUpdate表示是否延迟更新,默认为false。
- getWidth():获取图表的宽度。
- getHeight():获取图表的高度。
- getDom():获取图表所在的dom节点。
- getOption():获取图表的配置项。
- resize():调整图表的大小。
- dispatchAction(payload):触发图表的行为,比如点击某个系列的图标,参数payload为具体的行为描述。
- on(eventName, handler):绑定事件处理函数,比如click、legendselectchanged等。
- off(eventName, handler):解绑事件处理函数。
这些API可以通过echarts.init()方法创建的echarts实例对象来调用,比如:
```javascript
var myChart = echarts.init(dom);
myChart.setOption(option);
```
其中,option是一个配置项,用来描述图表的样式、数据、系列等。