縱觀ECharts圖表實例化的API,主要有一下幾個相關的實例化方法: 1、setOption(Object option,{boolean = true} notMerge) 參數: 1)、Object類型的參數 option,表示圖表數據結構 ,形如: 1.var option = { 2. t ...
縱觀ECharts圖表實例化的API,主要有一下幾個相關的實例化方法:
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初始化對象過後才可以進行,否則會產生報錯現象。
此文來源於:https://blog.csdn.net/Uncle_long/article/details/80483175