echarts 对象

这是一个全局对象,由之前加载的echarts.js创建的,在AMD环境下用require('echarts')获取。

我们先来打印这个echarts对象看看

会发现它有这些属性和方法:
connect: (t)
dependencies: Object
disConnect: (t)
dispose: (t)
extendChartView: (t)
extendComponentModel: (t)
extendComponentView: (t)
extendSeriesModel: (t)
format: Object
getInstanceByDom: (t)
getInstanceById: (t)
getMap: (t)
graphic: Object
init: (t,e,i)
loadMap: ()
number: Object
registerAction: (t,e,i)
registerCoordinateSystem: (t,e)
registerLayout: (t)
registerMap: (t,e,i)
registerPreprocessor: (t)
registerProcessor: (t,e)
registerTheme: (t,e)
registerVisualCoding: (t,e)
setCanvasCreator: (t)
util: Object
version: "3.0.2"
__proto__: Object
  • init: 创建一个 ECharts 示例,返回 echartsInstance,不能再单个容器上初始化多个 ECharts 实例。
      (dom: HTMLDivElement|HTMLCanvasElement, theme?: Object|string, opts?: {
          devicePixelRatio?: number
          renderer?: string
      })
    
  • connect:这个方法是将2个echarts实例链接成依赖关系。echarts.connect([chart1, chart2]);
  • dependencies: 这个是一个描述echarts组件是基于哪些组件开发的,打开Object属性,会发现里面是:zrender: "3.0.1",表示它是基于zrender这个组件开发的。
  • disConnect: 这个和connect对应,则是表示断开echarts实例的依赖关系。
  • dispose: 销毁实例,实例销毁后无法再被使用。
  • extendChartView: (t),extendComponentModel: (t),extendComponentView: (t),extendSeriesModel: (t): 这几个方法查看后,发现function scope是Global:window的,说明属于全局的属性方法了,用于面向对象的组件化思想开发的,可以查看源码学习下
  • format: 这个属性里面包含了6个方法:addCommas: e(t),encodeHTML: r(t),formatTime: s(t,e),formatTpl: o(t,e),normalizeCssArray: n(t),toCamelCase: i(t),用来格式化数据的
  • getInstanceByDom:获取容器上的实例(echartsInstance)
  • getInstanceById:通过ID获取实例
  • registerMap:(mapName: string, geoJson: Object, specialAreas?: Object)。
    • mapName:地图名称,在 geo 组件或者 map 图表类型中设置的 map 对应的就是该值。
    • geoJson:GeoJson 格式的数据,具体格式见 http://geojson.org/。
    • specialAreas:可选。将地图中的部分区域缩放到合适的位置,可以使得整个地图的显示更加好看。
    • 注册可用的地图,这个在geo组件和map图表类型的时候回用到,geoJson数据格式可以了解下,以及地图文件下载,演示例子
  • registerTheme: (themeName: string, theme: Object)
    • 注册主题,用于初始化实例的时候指定。

其他属性可以查看源码学习下,也利于适应不同环境的开发。