ECharts API 全局echarts對象

echarts

全局 echarts 對象，在 script 標簽引入 echarts.js 文件后獲得，或者在 AMD 環(huán)境中通過 require('echarts') 獲得。

echarts.init  | Function

(dom: HTMLDivElement|HTMLCanvasElement, theme?: Object|string, opts?: {
    devicePixelRatio?: number
    renderer?: string
    width?: number|string
    height? number|string
}) => ECharts

創(chuàng)建一個 ECharts 實例，返回 echartsInstance，不能再單個容器上初始化多個 ECharts 實例。

參數(shù)

• dom實例容器，一般是一個具有高寬的div元素。注：如果div是隱藏的，ECharts 可能會獲取不到div的高寬導致初始化失敗，這時候可以明確指定div的style.width和style.height，或者在div顯示后手動調用 echartsInstance.resize 調整尺寸。ECharts 3 中支持直接使用canvas元素作為容器，這樣繪制完圖表可以直接將 canvas 作為圖片應用到其它地方，例如在 WebGL 中作為貼圖，這跟使用 echartsInstance.getDataURL 生成圖片鏈接相比可以支持圖表的實時刷新。
• theme應用的主題?？梢允且粋€主題的配置對象，也可以是使用已經(jīng)通過 echarts.registerTheme 注冊的主題名稱。
• opts附加參數(shù)。有下面幾個可選項：devicePixelRatio設備像素比，默認取瀏覽器的值window.devicePixelRatio。renderer渲染器，目前僅支持'canvas'。width可顯式指定實例寬度，單位為像素。如果傳入值為 null/undefined/'auto'，則表示自動取 dom（實例容器）的寬度。height可顯式指定實例高度，單位為像素。如果傳入值為 null/undefined/'auto'，則表示自動取 dom（實例容器）的高度。

echarts.connect | Function

(group:string|Array)

多個圖表實例實現(xiàn)聯(lián)動。

參數(shù)：

• group group 的 id，或者圖表實例的數(shù)組。

示例：

// 分別設置每個實例的 group id
chart1.group = 'group1';
chart2.group = 'group1';
echarts.connect('group1');
// 或者可以直接傳入需要聯(lián)動的實例數(shù)組
echarts.connect([chart1, chart2]);

echarts.disconnect  | Function

(group:string)

解除圖表實例的聯(lián)動，如果只需要移除單個實例，可以將通過將該圖表實例 group 設為空。

參數(shù)：

• groupgroup 的 id。

echarts.dispose  |  Function

(target: ECharts|HTMLDivElement|HTMLCanvasElement)

銷毀實例，實例銷毀后無法再被使用。

echarts.getInstanceByDom   |  Function

(target: HTMLDivElement|HTMLCanvasElement) => ECharts

獲取 dom 容器上的實例。

echarts.registerMap  |  Function

(mapName: string, geoJson: Object, specialAreas?: Object)

注冊可用的地圖，必須在包括 geo 組件或者 map 圖表類型的時候才能使用。

使用方法見 option.geo。

參數(shù)：

• mapName地圖名稱，在 geo 組件或者 map 圖表類型中設置的 map 對應的就是該值。
• geoJsonGeoJson 格式的數(shù)據(jù)，具體格式見 http://geojson.org/。
• specialAreas可選。將地圖中的部分區(qū)域縮放到合適的位置，可以使得整個地圖的顯示更加好看。示例 USA Population Estimates：echarts.registerMap('USA', usaJson, { // 把阿拉斯加移到美國主大陸左下方 Alaska: { // 左上角經(jīng)度 left: -131, // 左上角緯度 top: 25, // 經(jīng)度橫跨的范圍 width: 15 }, // 夏威夷 Hawaii: { left: -110, top: 28, width: 5 }, // 波多黎各 'Puerto Rico': { left: -76, top: 26, width: 2 } });

echarts.getMap  |  Function

(mapName: string) => Object

獲取已注冊的地圖，返回的對象類型如下

{
    // 地圖的 geoJson 數(shù)據(jù)
    geoJson: Object,
    // 地圖的特殊區(qū)域，見 registerMap
    specialAreas: Object
}

echarts.registerTheme  |  Function

(themeName: string, theme: Object)

注冊主題，用于初始化實例的時候指定。