ECharts對象的數據實例化方法彙總以及注意事項

幾個相關的實例化方法:

1、setOption(Object option,{boolean = true} notMerge)

參數:

1)、Object類型的參數 option,表示圖表數據結構 ,形如:

 

 
1.var option  = {
2.                title: {
3.                    text: "我的第一個ECharts圖表示例"
4.                },
5.                tooltip: {
6.                    trigger: 'axis'
7.                }
8.            };

 

2)、boolean notMerge,表示是否合併option。默認爲false,可以不設置。

描述:

萬能接口,配置圖表實例任何可配置選項(詳見option),多次調用時option選項是默認是合併(merge)的,如果不需求,可以通過notMerger參數爲true阻止與上次option的合併。

2、getOption()

描述:

返回內部持有的當前顯示option克隆

3、setSeries(Array series,{boolean=}notMerge)

參數:

1)、Array類型的series序列數據,形如:

 

 
01.var Array seriesList = new Array();
02. 
03.var seriesObj = new seriesObj();
04.seriesObj.name = "蒸發量";
05.seriesObj.type = "line";
06.seriesObj.data = [2.0, 4.9, 7.0, 23.2, 25.6, 76.7, 135.6, 162.2, 32.6, 20.0, 6.4, 3.3];
07. 
08.//設置series
09.myChart.setSeries(seriesList,false);

 

2)、boolean notMerge 表示是否合併series,默認爲false,可以不設置。

描述:

數據接口,驅動圖表生成的數據內容,效果等同調用setOption({series:{...}})

4、getSeries()

描述:

返回內部持有的當前顯示series克隆,效果同return getOption().series

5、addData(....)

參數:

1)、單組數據參數

11)、{number} seriesIdx :表示給哪一條series添加數據,series腳標從0開始;

12)、{number | Object} data;

13)、{boolean=} isHead ;

14)、{boolean=} dataGrow;

15)、{string=} additionData;

2)、多組數據參數

其實就是多個單組數據的形成的集合或者數組{Array} params

描述:

動態數據接口

seriesIdx 系列索引 

data 增加數據 

isHead 是否隊頭加入,默認,不指定或false時爲隊尾插入 

dataGrow 是否增長數據隊列長度,默認,不指定或false時移出目標數組對位數據 

additionData 是否增加類目軸(餅圖爲圖例)數據,附加操作同isHead和dataGrow 

多組數據添加時參數爲: 

params == [[seriesIdx, data, isHead, dataGrow, additionData], [...]]

6、on(string eventName,function eventListner)

描述:

事件綁定,支持事件有:REFRESH,RESTORE,CLICK,HOVER,DATA_CHANGED,MAGIC_TYPE_CHANGED,DATA_VIEW_CHANGED,DATA_ZOOM,DATA_RANGE,LEGEND_SELECTED,MAP_SELECTED

示例代碼形如:

 

 
1.//ECharts圖表的click事件監聽
2.myChart.on("click", function () {
3.        alert("你點擊我了!");
4.});

 

7、un(string eventName,function eventListner)

描述:

解除某個事件的綁定,示例代碼形如:

 

 
1.myChart.un("click", function () {
2.             alert("悲劇,你註銷我了!");
3.});

8、showLoading(Object loadingOption)

描述:

過渡控制(詳見loadingOption),顯示loading(讀取中)代碼片段形如:

 

 
01.//圖表顯示提示信息
02.myChart.showLoading({
03.    text: "圖表數據正在努力加載...",
04.    x: "center",
05.    y: "center",
06.    textStyle: {
07.        color:"red",
08.        fontSize:14
09.    },
10.    effect:"spin"
11.});

注意:

 

9、hideLoading()

描述:

隱藏圖表數據加載過度提示信息,示例代碼:

 

 
1.myChart.hideLoading();

 

10、getZrender()

描述:

獲取當前圖表所用ZRender實例,可用於添加額外圖形或進行深度定製,zrender接口詳見ZRender 示例代碼如下所示:

 

 
1.nyChart.getZrender();

 

11、getDataURL(string imgType)

描述:

獲取當前圖表的Base64圖片dataURL,imgType 圖片類型,支持png|jpeg,默認爲png

示例代碼如下所示:

 

 
1.var imgUrl = myChart.getDataURL("png");

12、getImage(string imgType)

描述:

獲取一個當前圖表的img,imgType 圖片類型,支持png|jpeg,默認爲png,示例代碼片段:

 

 
1.//前端導出圖表圖片
2.var imgObj = myChart.getImage("jpeg");

 

主要是拿到一個圖片對象,然後獲取其outerHTML屬性就是一個圖表image的html完整標籤,我們可以使用其直接顯示在頁面上。

13、resize()

描述:

ECharts沒有綁定resize事件,顯示區域大小發生改變內部並不知道,

使用方可以根據自己的需求綁定關心的事件,主動調用resize達到區域更新的效果。

 

 
1.myChart.resize();

 

14、refresh()

描述:

刷新圖表,圖例選擇、數據區域縮放,拖拽狀態均保持。

 

 
1.myChart.refresh();

 

15、restore()

描述:

還原圖表,各種狀態均被清除,還原爲最初展現時的狀態。

16、clear()

描述:

清空繪畫內容,清空後實例可用,因爲並非釋放示例的資源,釋放資源我們需要dispose()

 

 
1.myChart.clear();

 

17、dispose()

描述:

釋放圖表實例,釋放後實例不再可用。

 

 
1.myChart.dispose();

 

目前ECharts圖表的實例化主要包含當前十七個相關方法,後期不保證有補充的節奏,就目前來說,這十七個已經夠用了的。

注意:

1、以上方法的使用前提都是需要獲得ECharts初始化對象過後纔可以進行,否則會產生報錯現象。

*轉自* http://www.cnblogs.com/jessical626/p/7109799.html
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章