ECharts学习总结（四）：echarts的实例⽅法
echarts的实例⽅法⾮常重要，因为在实际运⽤中我们额图表的数据不可能是死的，⽽是动态变化的，实例⽅法为动态改变数据提供了⽅法。故特意从官⽹上⾯把下⾯实例⽅法进⾏记录:
注：下⾯内容摘⾃echarts官⽹，原⽂地址:
实例指的就是接⼝init()返回的对象，即上述代码中的“myChart”，⾮get接⼝均返回⾃⾝self⽀持链式调⽤
名称参数描述setoption
{self} setOption {Object} option,
{boolean=} notMerge
万能接⼝，配置图表实例任何可配置选项（详见），多次调⽤时option选项默认是合并（merge）
的，merge的设计可以让setOption很⽅便的成为更新任何属性的万能⽅法，⽐如你仅需要改title⽂字，
则仅需要：
setOption({title : {text : '新标题'}});
如果不需要，可以通过notMerger参数为true阻⽌与上次option的合并，如多次setOption间数据改变、长
度不⼀致等的场景。
2.0.0起⽀持timeline组件，option中包含timeline（详见）时每⼀个独⽴的option应该放置到命名为
options的数组内，如
myCharts.setOption({
timeline : {...},
options : [
{                // option1
title : {...},
series : [...]
},
{...},          // option2
...
]
});
{Object}
getOption
{void}返回内部持有的当前显⽰option克隆（拷贝）。
{self} setSeries {Array} series,
{boolean=} notMerge数据接⼝，驱动图表⽣成的数据内容（详见），效果等同调⽤ setOption({series : {...}}, notMerge)
{Object}
getSeries
{void}返回内部持有的当前显⽰series克隆（拷贝），效果同 getOption().series
{self} addData 单组数据：
{number} seriesIdx
{number | Object}
data
{boolean=} isHead
{boolean=}
dataGrow
{string=}
additionData
多组数据添加：
{Array} params
动态数据接⼝，
seriesIdx 系列索引
data 增加数据
isHead 是否队头加⼊，默认，不指定或false时为队尾插⼊
dataGrow 是否增长数据队列长度，默认，不指定或false时移出⽬标数组对位数据
additionData 是否增加类⽬轴(饼图为图例)数据，附加操作同isHead和dataGrow
多组数据添加时参数为：
params == [[seriesIdx, data, isHead, dataGrow, additionData], [...]]
{self} addMarkPoint {number} seriesIdx
{Object} markData
新增标注接⼝，其中
seriesIdx 系列索引
markData [标注]对象，同，⽀持多个
{self} addMarkLine {number} seriesIdx
{Object} markData
新增标线接⼝，其中
seriesIdx 系列索引
markData [标线]对象，同，⽀持多个
{self} delMarkPoint {number} seriesIdx
{string} markName
删除单个标注接⼝，其中
seriesIdx 系列索引
markName [标注]名称
{self} delMarkLine {number} seriesIdx
{string} markName
删除单个标线接⼝，其中
seriesIdx 系列索引
markName [标线]名称，已构建的标线名称默认为markLine数据中起始点的name，如果同时终点也有
name属性，如地图标线，则标线名称等于“nameStart > nameEnd”，如markLine的data为
[{name:'北京', value:100}, {name:'上海'}]
则删除该标线时传⼊的markName为 "北京 > 上海"
事件绑定，事件命名统⼀挂载到require('echarts/config').EVENT（⾮模块化为fig.EVENT）
命名空间下，建议使⽤此命名空间作为事件名引⽤，当前版本⽀持事件有：
-----------------------基础事件-----------------------
REFRESH（刷新），
RESTORE（还原），
RESIZE（显⽰空间变化），
{self} on {string} eventName,
{Function}
eventListener
RESIZE（显⽰空间变化），
CLICK（点击），
DBLCLICK（双击），
HOVER（悬浮），
MOUSEOUT（⿏标离开数据图形），
---------------------交互逻辑事件--------------------
DATA_CHANGED（数据修改，如拖拽重计算），
DATA_VIEW_CHANGED（数据视图修改），
MAGIC_TYPE_CHANGED（动态类型切换），
TIMELINE_CHANGED（时间轴变化），
DATA_ZOOM（数据区域缩放），
DATA_RANGE（值域漫游），
DATA_RANGE_SELECTED（值域开关选择），
DATA_RANGE_HOVERLINK（值域漫游hover），
LEGEND_SELECTED（图例开关选择），
LEGEND_HOVERLINK（图例hover），
MAP_ROAM（地图漫游），
MAP_SELECTED（地图选择），
PIE_SELECTED（饼图选择），
FORCE_LAYOUT_END（⼒导向布局结束）
{self} un {string} eventName, {Function}
eventListener
事件解绑定
{self} setTheme {string | Object}
theme设置主题，内置主题（'macarons', 'infographic'）直接传⼊名称，⾃定义扩展主题可传⼊主题对象
{self} connect {ECharts | Array
<ECharts>}
connectTarget
多图联动，传⼊联动⽬标为EChart实例，⽀持数组。多图联动⽀持直⾓系下tooltip联动，保存图⽚的⾃
动拼接，同时⽀持的联动事件有：
REFRESH，RESTORE，MAGIC_TYPE_CHANGED
DATA_ZOOM，DATA_RANGE，LEGEND_SELECTED
{self} disConnect {ECharts | Array
<ECharts>}
connectTarget
解除已连结的多图联动
{self} showLoading {Object}
loadingOption过渡控制（详见），显⽰loading（读取中）
{self}
hideLoading
{void}过渡控制，隐藏loading（读取中）
{ZRender}
getZrender
{void}获取当前图表所⽤ZRender实例，可⽤于添加额外图形或进⾏深度定制，zrender接⼝详见{string}
getDataURL
{string=} imgType获取当前图表的Base64图⽚dataURL，IE8-不⽀持，imgType 图⽚类型，⽀持png|jpeg，默认为png {Dom}
getImage
{string=} imgType获取⼀个当前图表的img，imgType 图⽚类型，⽀持png|jpeg，默认为png
{self} resize{void}ECharts没有绑定resize事件，显⽰区域⼤⼩发⽣改变内部并不知道，使⽤⽅可以根据⾃⼰的需求绑定关⼼的事件，主动调⽤resize达到⾃适应的效果，常见如size = size。
{self} refresh{void}刷新图表，图例选择、数据区域缩放，拖拽状态均保持。{self} restore{void}还原图表，各种状态均被清除，还原为最初展现时的状态。{self} clear{void}清空绘画内容，清空后实例可⽤
{void}
dispose
{void}释放图表实例，释放后实例不再可⽤

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。