交互API

关于 全局charts对象 和 echarts实例对象 的方法

1. 全局charts对象

echarts.init(dom?: HTMLDivElement|HTMLCanvasElement, theme?: Object|string, opts?):

• 创建echarts实例对象
• 使用主题

echarts.registerTheme(themeName: string, theme: Object):

• 注册主题，用于初始化实例的时候指定。

echarts.registerMap(mapName: string, geoJSON: Object | string):

• 注册可用的地图，只在 geo 组件或者 map 图表类型中使用。

connect([ echartsIns_1, echartsIns_2, ... ]):

• 多个图表实例实现联动
• 保存，拼接关联的图表
• 刷新按钮
• 重置按钮
• 提示框联动、图例选择、数据范围修改等

2. echarts实例对象

setOption(option: Object, notMerge?: boolean, lazyUpdate?: boolean):

• 设置图表实例的配置项以及数据
• 万能接口，所有参数和数据的修改都可以通过 setOption 完成
• ECharts 会合并新的参数和数据，然后刷新图表
• 如果开启动画的话，ECharts 找到两组数据之间的差异然后通过合适的动画去表现数据的变化

resize(width?: number|string, height?: number|string, silent?: boolean, animation?):

• 改变图表尺寸，在容器大小发生改变时需要手动调用。

on():

• ( eventName: string, handler: Function, context?: Object )
• ( eventName: string, query: string|Object, handler: Function, context?: Object )
• 绑定事件处理函数。
• 查看 events (opens new window)
• 鼠标事件： click 、dblclick、mousedown、mousemove、mouseup 等
• echarts事件： legendselectchanged、datazoom、geoselected 等

off(eventName: string, handler?: Function):

• 解绑事件处理函数。

dispatchAction(payload: Object):

• 触发图表行为
• 触发 action (opens new window) 中的行为
• 触发 events (opens new window) 中的 echarts事件

clear():

• 清空当前实例，会移除实例中所有的组件和图表。
• 相当于把 option 清空
• 可重新设置 option

dispose():

• 销毁实例，销毁后实例无法再被使用。

其他：

方法	说明
getWidth()	获取 ECharts 实例容器的宽度
getHeight()	获取 ECharts 实例容器的高度
getDom()	获取 ECharts 实例容器的 dom 节点。
getOption()	获取当前实例中维护的 option 对象
getDataURL()	导出图表图片，返回一个 base64 的 URL
getConnectedDataURL()	导出联动的图表图片，返回一个 base64 的 url
isDisposed()	当前实例是否已经被释放。