1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879 |
- // Enable DEV mode when using source code without build. which has no __DEV__ variable
- // In build process 'typeof __DEV__' will be replace with 'boolean'
- // So this code will be removed or disabled anyway after built.
- if (typeof __DEV__ === 'undefined') {
- // In browser
- if (typeof window !== 'undefined') {
- window.__DEV__ = true;
- }
- // In node
- else if (typeof global !== 'undefined') {
- global.__DEV__ = true;
- }
- }
- /*!
- * ECharts, a javascript interactive chart library.
- *
- * Copyright (c) 2015, Baidu Inc.
- * All rights reserved.
- *
- * LICENSE
- * https://github.com/ecomfe/echarts/blob/master/LICENSE.txt
- */
- /**
- * @module echarts
- */
- define(function (require) {
- var env = require('zrender/core/env');
- var GlobalModel = require('./model/Global');
- var ExtensionAPI = require('./ExtensionAPI');
- var CoordinateSystemManager = require('./CoordinateSystem');
- var OptionManager = require('./model/OptionManager');
- var ComponentModel = require('./model/Component');
- var SeriesModel = require('./model/Series');
- var ComponentView = require('./view/Component');
- var ChartView = require('./view/Chart');
- var graphic = require('./util/graphic');
- var modelUtil = require('./util/model');
- var throttle = require('./util/throttle');
- var zrender = require('zrender');
- var zrUtil = require('zrender/core/util');
- var colorTool = require('zrender/tool/color');
- var Eventful = require('zrender/mixin/Eventful');
- var timsort = require('zrender/core/timsort');
- var each = zrUtil.each;
- var parseClassType = ComponentModel.parseClassType;
- var PRIORITY_PROCESSOR_FILTER = 1000;
- var PRIORITY_PROCESSOR_STATISTIC = 5000;
- var PRIORITY_VISUAL_LAYOUT = 1000;
- var PRIORITY_VISUAL_GLOBAL = 2000;
- var PRIORITY_VISUAL_CHART = 3000;
- var PRIORITY_VISUAL_COMPONENT = 4000;
- // FIXME
- // necessary?
- var PRIORITY_VISUAL_BRUSH = 5000;
- // Main process have three entries: `setOption`, `dispatchAction` and `resize`,
- // where they must not be invoked nestedly, except the only case: invoke
- // dispatchAction with updateMethod "none" in main process.
- // This flag is used to carry out this rule.
- // All events will be triggered out side main process (i.e. when !this[IN_MAIN_PROCESS]).
- var IN_MAIN_PROCESS = '__flagInMainProcess';
- var HAS_GRADIENT_OR_PATTERN_BG = '__hasGradientOrPatternBg';
- var OPTION_UPDATED = '__optionUpdated';
- var ACTION_REG = /^[a-zA-Z0-9_]+$/;
- function createRegisterEventWithLowercaseName(method) {
- return function (eventName, handler, context) {
- // Event name is all lowercase
- eventName = eventName && eventName.toLowerCase();
- Eventful.prototype[method].call(this, eventName, handler, context);
- };
- }
- /**
- * @module echarts~MessageCenter
- */
- function MessageCenter() {
- Eventful.call(this);
- }
- MessageCenter.prototype.on = createRegisterEventWithLowercaseName('on');
- MessageCenter.prototype.off = createRegisterEventWithLowercaseName('off');
- MessageCenter.prototype.one = createRegisterEventWithLowercaseName('one');
- zrUtil.mixin(MessageCenter, Eventful);
- /**
- * @module echarts~ECharts
- */
- function ECharts (dom, theme, opts) {
- opts = opts || {};
- // Get theme by name
- if (typeof theme === 'string') {
- theme = themeStorage[theme];
- }
- /**
- * @type {string}
- */
- this.id;
- /**
- * Group id
- * @type {string}
- */
- this.group;
- /**
- * @type {HTMLDomElement}
- * @private
- */
- this._dom = dom;
- /**
- * @type {module:zrender/ZRender}
- * @private
- */
- var zr = this._zr = zrender.init(dom, {
- renderer: opts.renderer || 'canvas',
- devicePixelRatio: opts.devicePixelRatio,
- width: opts.width,
- height: opts.height
- });
- /**
- * Expect 60 pfs.
- * @type {Function}
- * @private
- */
- this._throttledZrFlush = throttle.throttle(zrUtil.bind(zr.flush, zr), 17);
- /**
- * @type {Object}
- * @private
- */
- this._theme = zrUtil.clone(theme);
- /**
- * @type {Array.<module:echarts/view/Chart>}
- * @private
- */
- this._chartsViews = [];
- /**
- * @type {Object.<string, module:echarts/view/Chart>}
- * @private
- */
- this._chartsMap = {};
- /**
- * @type {Array.<module:echarts/view/Component>}
- * @private
- */
- this._componentsViews = [];
- /**
- * @type {Object.<string, module:echarts/view/Component>}
- * @private
- */
- this._componentsMap = {};
- /**
- * @type {module:echarts/ExtensionAPI}
- * @private
- */
- this._api = new ExtensionAPI(this);
- /**
- * @type {module:echarts/CoordinateSystem}
- * @private
- */
- this._coordSysMgr = new CoordinateSystemManager();
- Eventful.call(this);
- /**
- * @type {module:echarts~MessageCenter}
- * @private
- */
- this._messageCenter = new MessageCenter();
- // Init mouse events
- this._initEvents();
- // In case some people write `window.onresize = chart.resize`
- this.resize = zrUtil.bind(this.resize, this);
- // Can't dispatch action during rendering procedure
- this._pendingActions = [];
- // Sort on demand
- function prioritySortFunc(a, b) {
- return a.prio - b.prio;
- }
- timsort(visualFuncs, prioritySortFunc);
- timsort(dataProcessorFuncs, prioritySortFunc);
- zr.animation.on('frame', this._onframe, this);
- }
- var echartsProto = ECharts.prototype;
- echartsProto._onframe = function () {
- // Lazy update
- if (this[OPTION_UPDATED]) {
- var silent = this[OPTION_UPDATED].silent;
- this[IN_MAIN_PROCESS] = true;
- updateMethods.prepareAndUpdate.call(this);
- this[IN_MAIN_PROCESS] = false;
- this[OPTION_UPDATED] = false;
- flushPendingActions.call(this, silent);
- triggerUpdatedEvent.call(this, silent);
- }
- };
- /**
- * @return {HTMLDomElement}
- */
- echartsProto.getDom = function () {
- return this._dom;
- };
- /**
- * @return {module:zrender~ZRender}
- */
- echartsProto.getZr = function () {
- return this._zr;
- };
- /**
- * Usage:
- * chart.setOption(option, notMerge, lazyUpdate);
- * chart.setOption(option, {
- * notMerge: ...,
- * lazyUpdate: ...,
- * silent: ...
- * });
- *
- * @param {Object} option
- * @param {Object|boolean} [opts] opts or notMerge.
- * @param {boolean} [opts.notMerge=false]
- * @param {boolean} [opts.lazyUpdate=false] Useful when setOption frequently.
- */
- echartsProto.setOption = function (option, notMerge, lazyUpdate) {
- if (__DEV__) {
- zrUtil.assert(!this[IN_MAIN_PROCESS], '`setOption` should not be called during main process.');
- }
- var silent;
- if (zrUtil.isObject(notMerge)) {
- lazyUpdate = notMerge.lazyUpdate;
- silent = notMerge.silent;
- notMerge = notMerge.notMerge;
- }
- this[IN_MAIN_PROCESS] = true;
- if (!this._model || notMerge) {
- var optionManager = new OptionManager(this._api);
- var theme = this._theme;
- var ecModel = this._model = new GlobalModel(null, null, theme, optionManager);
- ecModel.init(null, null, theme, optionManager);
- }
- // FIXME
- // ugly
- this.__lastOnlyGraphic = !!(option && option.graphic);
- zrUtil.each(option, function (o, mainType) {
- mainType !== 'graphic' && (this.__lastOnlyGraphic = false);
- }, this);
- this._model.setOption(option, optionPreprocessorFuncs);
- if (lazyUpdate) {
- this[OPTION_UPDATED] = {silent: silent};
- this[IN_MAIN_PROCESS] = false;
- }
- else {
- updateMethods.prepareAndUpdate.call(this);
- // Ensure zr refresh sychronously, and then pixel in canvas can be
- // fetched after `setOption`.
- this._zr.flush();
- this[OPTION_UPDATED] = false;
- this[IN_MAIN_PROCESS] = false;
- flushPendingActions.call(this, silent);
- triggerUpdatedEvent.call(this, silent);
- }
- };
- /**
- * @DEPRECATED
- */
- echartsProto.setTheme = function () {
- console.log('ECharts#setTheme() is DEPRECATED in ECharts 3.0');
- };
- /**
- * @return {module:echarts/model/Global}
- */
- echartsProto.getModel = function () {
- return this._model;
- };
- /**
- * @return {Object}
- */
- echartsProto.getOption = function () {
- return this._model && this._model.getOption();
- };
- /**
- * @return {number}
- */
- echartsProto.getWidth = function () {
- return this._zr.getWidth();
- };
- /**
- * @return {number}
- */
- echartsProto.getHeight = function () {
- return this._zr.getHeight();
- };
- /**
- * Get canvas which has all thing rendered
- * @param {Object} opts
- * @param {string} [opts.backgroundColor]
- */
- echartsProto.getRenderedCanvas = function (opts) {
- if (!env.canvasSupported) {
- return;
- }
- opts = opts || {};
- opts.pixelRatio = opts.pixelRatio || 1;
- opts.backgroundColor = opts.backgroundColor
- || this._model.get('backgroundColor');
- var zr = this._zr;
- var list = zr.storage.getDisplayList();
- // Stop animations
- zrUtil.each(list, function (el) {
- el.stopAnimation(true);
- });
- return zr.painter.getRenderedCanvas(opts);
- };
- /**
- * @return {string}
- * @param {Object} opts
- * @param {string} [opts.type='png']
- * @param {string} [opts.pixelRatio=1]
- * @param {string} [opts.backgroundColor]
- * @param {string} [opts.excludeComponents]
- */
- echartsProto.getDataURL = function (opts) {
- opts = opts || {};
- var excludeComponents = opts.excludeComponents;
- var ecModel = this._model;
- var excludesComponentViews = [];
- var self = this;
- each(excludeComponents, function (componentType) {
- ecModel.eachComponent({
- mainType: componentType
- }, function (component) {
- var view = self._componentsMap[component.__viewId];
- if (!view.group.ignore) {
- excludesComponentViews.push(view);
- view.group.ignore = true;
- }
- });
- });
- var url = this.getRenderedCanvas(opts).toDataURL(
- 'image/' + (opts && opts.type || 'png')
- );
- each(excludesComponentViews, function (view) {
- view.group.ignore = false;
- });
- return url;
- };
- /**
- * @return {string}
- * @param {Object} opts
- * @param {string} [opts.type='png']
- * @param {string} [opts.pixelRatio=1]
- * @param {string} [opts.backgroundColor]
- */
- echartsProto.getConnectedDataURL = function (opts) {
- if (!env.canvasSupported) {
- return;
- }
- var groupId = this.group;
- var mathMin = Math.min;
- var mathMax = Math.max;
- var MAX_NUMBER = Infinity;
- if (connectedGroups[groupId]) {
- var left = MAX_NUMBER;
- var top = MAX_NUMBER;
- var right = -MAX_NUMBER;
- var bottom = -MAX_NUMBER;
- var canvasList = [];
- var dpr = (opts && opts.pixelRatio) || 1;
- zrUtil.each(instances, function (chart, id) {
- if (chart.group === groupId) {
- var canvas = chart.getRenderedCanvas(
- zrUtil.clone(opts)
- );
- var boundingRect = chart.getDom().getBoundingClientRect();
- left = mathMin(boundingRect.left, left);
- top = mathMin(boundingRect.top, top);
- right = mathMax(boundingRect.right, right);
- bottom = mathMax(boundingRect.bottom, bottom);
- canvasList.push({
- dom: canvas,
- left: boundingRect.left,
- top: boundingRect.top
- });
- }
- });
- left *= dpr;
- top *= dpr;
- right *= dpr;
- bottom *= dpr;
- var width = right - left;
- var height = bottom - top;
- var targetCanvas = zrUtil.createCanvas();
- targetCanvas.width = width;
- targetCanvas.height = height;
- var zr = zrender.init(targetCanvas);
- each(canvasList, function (item) {
- var img = new graphic.Image({
- style: {
- x: item.left * dpr - left,
- y: item.top * dpr - top,
- image: item.dom
- }
- });
- zr.add(img);
- });
- zr.refreshImmediately();
- return targetCanvas.toDataURL('image/' + (opts && opts.type || 'png'));
- }
- else {
- return this.getDataURL(opts);
- }
- };
- /**
- * Convert from logical coordinate system to pixel coordinate system.
- * See CoordinateSystem#convertToPixel.
- * @param {string|Object} finder
- * If string, e.g., 'geo', means {geoIndex: 0}.
- * If Object, could contain some of these properties below:
- * {
- * seriesIndex / seriesId / seriesName,
- * geoIndex / geoId, geoName,
- * bmapIndex / bmapId / bmapName,
- * xAxisIndex / xAxisId / xAxisName,
- * yAxisIndex / yAxisId / yAxisName,
- * gridIndex / gridId / gridName,
- * ... (can be extended)
- * }
- * @param {Array|number} value
- * @return {Array|number} result
- */
- echartsProto.convertToPixel = zrUtil.curry(doConvertPixel, 'convertToPixel');
- /**
- * Convert from pixel coordinate system to logical coordinate system.
- * See CoordinateSystem#convertFromPixel.
- * @param {string|Object} finder
- * If string, e.g., 'geo', means {geoIndex: 0}.
- * If Object, could contain some of these properties below:
- * {
- * seriesIndex / seriesId / seriesName,
- * geoIndex / geoId / geoName,
- * bmapIndex / bmapId / bmapName,
- * xAxisIndex / xAxisId / xAxisName,
- * yAxisIndex / yAxisId / yAxisName
- * gridIndex / gridId / gridName,
- * ... (can be extended)
- * }
- * @param {Array|number} value
- * @return {Array|number} result
- */
- echartsProto.convertFromPixel = zrUtil.curry(doConvertPixel, 'convertFromPixel');
- function doConvertPixel(methodName, finder, value) {
- var ecModel = this._model;
- var coordSysList = this._coordSysMgr.getCoordinateSystems();
- var result;
- finder = modelUtil.parseFinder(ecModel, finder);
- for (var i = 0; i < coordSysList.length; i++) {
- var coordSys = coordSysList[i];
- if (coordSys[methodName]
- && (result = coordSys[methodName](ecModel, finder, value)) != null
- ) {
- return result;
- }
- }
- if (__DEV__) {
- console.warn(
- 'No coordinate system that supports ' + methodName + ' found by the given finder.'
- );
- }
- }
- /**
- * Is the specified coordinate systems or components contain the given pixel point.
- * @param {string|Object} finder
- * If string, e.g., 'geo', means {geoIndex: 0}.
- * If Object, could contain some of these properties below:
- * {
- * seriesIndex / seriesId / seriesName,
- * geoIndex / geoId / geoName,
- * bmapIndex / bmapId / bmapName,
- * xAxisIndex / xAxisId / xAxisName,
- * yAxisIndex / yAxisId / yAxisName
- * gridIndex / gridId / gridName,
- * ... (can be extended)
- * }
- * @param {Array|number} value
- * @return {boolean} result
- */
- echartsProto.containPixel = function (finder, value) {
- var ecModel = this._model;
- var result;
- finder = modelUtil.parseFinder(ecModel, finder);
- zrUtil.each(finder, function (models, key) {
- key.indexOf('Models') >= 0 && zrUtil.each(models, function (model) {
- var coordSys = model.coordinateSystem;
- if (coordSys && coordSys.containPoint) {
- result |= !!coordSys.containPoint(value);
- }
- else if (key === 'seriesModels') {
- var view = this._chartsMap[model.__viewId];
- if (view && view.containPoint) {
- result |= view.containPoint(value, model);
- }
- else {
- if (__DEV__) {
- console.warn(key + ': ' + (view
- ? 'The found component do not support containPoint.'
- : 'No view mapping to the found component.'
- ));
- }
- }
- }
- else {
- if (__DEV__) {
- console.warn(key + ': containPoint is not supported');
- }
- }
- }, this);
- }, this);
- return !!result;
- };
- /**
- * Get visual from series or data.
- * @param {string|Object} finder
- * If string, e.g., 'series', means {seriesIndex: 0}.
- * If Object, could contain some of these properties below:
- * {
- * seriesIndex / seriesId / seriesName,
- * dataIndex / dataIndexInside
- * }
- * If dataIndex is not specified, series visual will be fetched,
- * but not data item visual.
- * If all of seriesIndex, seriesId, seriesName are not specified,
- * visual will be fetched from first series.
- * @param {string} visualType 'color', 'symbol', 'symbolSize'
- */
- echartsProto.getVisual = function (finder, visualType) {
- var ecModel = this._model;
- finder = modelUtil.parseFinder(ecModel, finder, {defaultMainType: 'series'});
- var seriesModel = finder.seriesModel;
- if (__DEV__) {
- if (!seriesModel) {
- console.warn('There is no specified seires model');
- }
- }
- var data = seriesModel.getData();
- var dataIndexInside = finder.hasOwnProperty('dataIndexInside')
- ? finder.dataIndexInside
- : finder.hasOwnProperty('dataIndex')
- ? data.indexOfRawIndex(finder.dataIndex)
- : null;
- return dataIndexInside != null
- ? data.getItemVisual(dataIndexInside, visualType)
- : data.getVisual(visualType);
- };
- var updateMethods = {
- /**
- * @param {Object} payload
- * @private
- */
- update: function (payload) {
- // console.time && console.time('update');
- var ecModel = this._model;
- var api = this._api;
- var coordSysMgr = this._coordSysMgr;
- var zr = this._zr;
- // update before setOption
- if (!ecModel) {
- return;
- }
- // Fixme First time update ?
- ecModel.restoreData();
- // TODO
- // Save total ecModel here for undo/redo (after restoring data and before processing data).
- // Undo (restoration of total ecModel) can be carried out in 'action' or outside API call.
- // Create new coordinate system each update
- // In LineView may save the old coordinate system and use it to get the orignal point
- coordSysMgr.create(this._model, this._api);
- processData.call(this, ecModel, api);
- stackSeriesData.call(this, ecModel);
- coordSysMgr.update(ecModel, api);
- doVisualEncoding.call(this, ecModel, payload);
- doRender.call(this, ecModel, payload);
- // Set background
- var backgroundColor = ecModel.get('backgroundColor') || 'transparent';
- var painter = zr.painter;
- // TODO all use clearColor ?
- if (painter.isSingleCanvas && painter.isSingleCanvas()) {
- zr.configLayer(0, {
- clearColor: backgroundColor
- });
- }
- else {
- // In IE8
- if (!env.canvasSupported) {
- var colorArr = colorTool.parse(backgroundColor);
- backgroundColor = colorTool.stringify(colorArr, 'rgb');
- if (colorArr[3] === 0) {
- backgroundColor = 'transparent';
- }
- }
- if (backgroundColor.colorStops || backgroundColor.image) {
- // Gradient background
- // FIXME Fixed layer?
- zr.configLayer(0, {
- clearColor: backgroundColor
- });
- this[HAS_GRADIENT_OR_PATTERN_BG] = true;
- this._dom.style.background = 'transparent';
- }
- else {
- if (this[HAS_GRADIENT_OR_PATTERN_BG]) {
- zr.configLayer(0, {
- clearColor: null
- });
- }
- this[HAS_GRADIENT_OR_PATTERN_BG] = false;
- this._dom.style.background = backgroundColor;
- }
- }
- // console.time && console.timeEnd('update');
- },
- /**
- * @param {Object} payload
- * @private
- */
- updateView: function (payload) {
- var ecModel = this._model;
- // update before setOption
- if (!ecModel) {
- return;
- }
- ecModel.eachSeries(function (seriesModel) {
- seriesModel.getData().clearAllVisual();
- });
- doVisualEncoding.call(this, ecModel, payload);
- invokeUpdateMethod.call(this, 'updateView', ecModel, payload);
- },
- /**
- * @param {Object} payload
- * @private
- */
- updateVisual: function (payload) {
- var ecModel = this._model;
- // update before setOption
- if (!ecModel) {
- return;
- }
- ecModel.eachSeries(function (seriesModel) {
- seriesModel.getData().clearAllVisual();
- });
- doVisualEncoding.call(this, ecModel, payload, true);
- invokeUpdateMethod.call(this, 'updateVisual', ecModel, payload);
- },
- /**
- * @param {Object} payload
- * @private
- */
- updateLayout: function (payload) {
- var ecModel = this._model;
- // update before setOption
- if (!ecModel) {
- return;
- }
- doLayout.call(this, ecModel, payload);
- invokeUpdateMethod.call(this, 'updateLayout', ecModel, payload);
- },
- /**
- * @param {Object} payload
- * @private
- */
- prepareAndUpdate: function (payload) {
- var ecModel = this._model;
- prepareView.call(this, 'component', ecModel);
- prepareView.call(this, 'chart', ecModel);
- // FIXME
- // ugly
- if (this.__lastOnlyGraphic) {
- each(this._componentsViews, function (componentView) {
- var componentModel = componentView.__model;
- if (componentModel && componentModel.mainType === 'graphic') {
- componentView.render(componentModel, ecModel, this._api, payload);
- updateZ(componentModel, componentView);
- }
- }, this);
- this.__lastOnlyGraphic = false;
- }
- else {
- updateMethods.update.call(this, payload);
- }
- }
- };
- /**
- * @private
- */
- function updateDirectly(ecIns, method, payload, mainType, subType) {
- var ecModel = ecIns._model;
- var query = {};
- query[mainType + 'Id'] = payload[mainType + 'Id'];
- query[mainType + 'Index'] = payload[mainType + 'Index'];
- query[mainType + 'Name'] = payload[mainType + 'Name'];
- var condition = {mainType: mainType, query: query};
- subType && (condition.subType = subType); // subType may be '' by parseClassType;
- // If dispatchAction before setOption, do nothing.
- ecModel && ecModel.eachComponent(condition, function (model, index) {
- var view = ecIns[
- mainType === 'series' ? '_chartsMap' : '_componentsMap'
- ][model.__viewId];
- if (view && view.__alive) {
- view[method](model, ecModel, ecIns._api, payload);
- }
- }, ecIns);
- }
- /**
- * Resize the chart
- * @param {Object} opts
- * @param {number} [opts.width] Can be 'auto' (the same as null/undefined)
- * @param {number} [opts.height] Can be 'auto' (the same as null/undefined)
- * @param {boolean} [opts.silent=false]
- */
- echartsProto.resize = function (opts) {
- if (__DEV__) {
- zrUtil.assert(!this[IN_MAIN_PROCESS], '`resize` should not be called during main process.');
- }
- this[IN_MAIN_PROCESS] = true;
- this._zr.resize(opts);
- var optionChanged = this._model && this._model.resetOption('media');
- var updateMethod = optionChanged ? 'prepareAndUpdate' : 'update';
- updateMethods[updateMethod].call(this);
- // Resize loading effect
- this._loadingFX && this._loadingFX.resize();
- this[IN_MAIN_PROCESS] = false;
- var silent = opts && opts.silent;
- flushPendingActions.call(this, silent);
- triggerUpdatedEvent.call(this, silent);
- };
- /**
- * Show loading effect
- * @param {string} [name='default']
- * @param {Object} [cfg]
- */
- echartsProto.showLoading = function (name, cfg) {
- if (zrUtil.isObject(name)) {
- cfg = name;
- name = '';
- }
- name = name || 'default';
- this.hideLoading();
- if (!loadingEffects[name]) {
- if (__DEV__) {
- console.warn('Loading effects ' + name + ' not exists.');
- }
- return;
- }
- var el = loadingEffects[name](this._api, cfg);
- var zr = this._zr;
- this._loadingFX = el;
- zr.add(el);
- };
- /**
- * Hide loading effect
- */
- echartsProto.hideLoading = function () {
- this._loadingFX && this._zr.remove(this._loadingFX);
- this._loadingFX = null;
- };
- /**
- * @param {Object} eventObj
- * @return {Object}
- */
- echartsProto.makeActionFromEvent = function (eventObj) {
- var payload = zrUtil.extend({}, eventObj);
- payload.type = eventActionMap[eventObj.type];
- return payload;
- };
- /**
- * @pubilc
- * @param {Object} payload
- * @param {string} [payload.type] Action type
- * @param {Object|boolean} [opt] If pass boolean, means opt.silent
- * @param {boolean} [opt.silent=false] Whether trigger events.
- * @param {boolean} [opt.flush=undefined]
- * true: Flush immediately, and then pixel in canvas can be fetched
- * immediately. Caution: it might affect performance.
- * false: Not not flush.
- * undefined: Auto decide whether perform flush.
- */
- echartsProto.dispatchAction = function (payload, opt) {
- if (!zrUtil.isObject(opt)) {
- opt = {silent: !!opt};
- }
- if (!actions[payload.type]) {
- return;
- }
- // if (__DEV__) {
- // zrUtil.assert(
- // !this[IN_MAIN_PROCESS],
- // '`dispatchAction` should not be called during main process.'
- // + 'unless updateMathod is "none".'
- // );
- // }
- // May dispatchAction in rendering procedure
- if (this[IN_MAIN_PROCESS]) {
- this._pendingActions.push(payload);
- return;
- }
- doDispatchAction.call(this, payload, opt.silent);
- if (opt.flush) {
- this._zr.flush(true);
- }
- else if (opt.flush !== false && env.browser.weChat) {
- // In WeChat embeded browser, `requestAnimationFrame` and `setInterval`
- // hang when sliding page (on touch event), which cause that zr does not
- // refresh util user interaction finished, which is not expected.
- // But `dispatchAction` may be called too frequently when pan on touch
- // screen, which impacts performance if do not throttle them.
- this._throttledZrFlush();
- }
- flushPendingActions.call(this, opt.silent);
- triggerUpdatedEvent.call(this, opt.silent);
- };
- function doDispatchAction(payload, silent) {
- var payloadType = payload.type;
- var actionWrap = actions[payloadType];
- var actionInfo = actionWrap.actionInfo;
- var cptType = (actionInfo.update || 'update').split(':');
- var updateMethod = cptType.pop();
- cptType = cptType[0] && parseClassType(cptType[0]);
- this[IN_MAIN_PROCESS] = true;
- var payloads = [payload];
- var batched = false;
- // Batch action
- if (payload.batch) {
- batched = true;
- payloads = zrUtil.map(payload.batch, function (item) {
- item = zrUtil.defaults(zrUtil.extend({}, item), payload);
- item.batch = null;
- return item;
- });
- }
- var eventObjBatch = [];
- var eventObj;
- var isHighDown = payloadType === 'highlight' || payloadType === 'downplay';
- for (var i = 0; i < payloads.length; i++) {
- var batchItem = payloads[i];
- // Action can specify the event by return it.
- eventObj = actionWrap.action(batchItem, this._model);
- // Emit event outside
- eventObj = eventObj || zrUtil.extend({}, batchItem);
- // Convert type to eventType
- eventObj.type = actionInfo.event || eventObj.type;
- eventObjBatch.push(eventObj);
- // light update does not perform data process, layout and visual.
- if (isHighDown) {
- // method, payload, mainType, subType
- updateDirectly(this, updateMethod, batchItem, 'series');
- }
- else if (cptType) {
- updateDirectly(this, updateMethod, batchItem, cptType.main, cptType.sub);
- }
- }
- if (updateMethod !== 'none' && !isHighDown && !cptType) {
- // Still dirty
- if (this[OPTION_UPDATED]) {
- // FIXME Pass payload ?
- updateMethods.prepareAndUpdate.call(this, payload);
- this[OPTION_UPDATED] = false;
- }
- else {
- updateMethods[updateMethod].call(this, payload);
- }
- }
- // Follow the rule of action batch
- if (batched) {
- eventObj = {
- type: actionInfo.event || payloadType,
- batch: eventObjBatch
- };
- }
- else {
- eventObj = eventObjBatch[0];
- }
- this[IN_MAIN_PROCESS] = false;
- !silent && this._messageCenter.trigger(eventObj.type, eventObj);
- }
- function flushPendingActions(silent) {
- var pendingActions = this._pendingActions;
- while (pendingActions.length) {
- var payload = pendingActions.shift();
- doDispatchAction.call(this, payload, silent);
- }
- }
- function triggerUpdatedEvent(silent) {
- !silent && this.trigger('updated');
- }
- /**
- * Register event
- * @method
- */
- echartsProto.on = createRegisterEventWithLowercaseName('on');
- echartsProto.off = createRegisterEventWithLowercaseName('off');
- echartsProto.one = createRegisterEventWithLowercaseName('one');
- /**
- * @param {string} methodName
- * @private
- */
- function invokeUpdateMethod(methodName, ecModel, payload) {
- var api = this._api;
- // Update all components
- each(this._componentsViews, function (component) {
- var componentModel = component.__model;
- component[methodName](componentModel, ecModel, api, payload);
- updateZ(componentModel, component);
- }, this);
- // Upate all charts
- ecModel.eachSeries(function (seriesModel, idx) {
- var chart = this._chartsMap[seriesModel.__viewId];
- chart[methodName](seriesModel, ecModel, api, payload);
- updateZ(seriesModel, chart);
- updateProgressiveAndBlend(seriesModel, chart);
- }, this);
- // If use hover layer
- updateHoverLayerStatus(this._zr, ecModel);
- }
- /**
- * Prepare view instances of charts and components
- * @param {module:echarts/model/Global} ecModel
- * @private
- */
- function prepareView(type, ecModel) {
- var isComponent = type === 'component';
- var viewList = isComponent ? this._componentsViews : this._chartsViews;
- var viewMap = isComponent ? this._componentsMap : this._chartsMap;
- var zr = this._zr;
- for (var i = 0; i < viewList.length; i++) {
- viewList[i].__alive = false;
- }
- ecModel[isComponent ? 'eachComponent' : 'eachSeries'](function (componentType, model) {
- if (isComponent) {
- if (componentType === 'series') {
- return;
- }
- }
- else {
- model = componentType;
- }
- // Consider: id same and type changed.
- var viewId = model.id + '_' + model.type;
- var view = viewMap[viewId];
- if (!view) {
- var classType = parseClassType(model.type);
- var Clazz = isComponent
- ? ComponentView.getClass(classType.main, classType.sub)
- : ChartView.getClass(classType.sub);
- if (Clazz) {
- view = new Clazz();
- view.init(ecModel, this._api);
- viewMap[viewId] = view;
- viewList.push(view);
- zr.add(view.group);
- }
- else {
- // Error
- return;
- }
- }
- model.__viewId = viewId;
- view.__alive = true;
- view.__id = viewId;
- view.__model = model;
- }, this);
- for (var i = 0; i < viewList.length;) {
- var view = viewList[i];
- if (!view.__alive) {
- zr.remove(view.group);
- view.dispose(ecModel, this._api);
- viewList.splice(i, 1);
- delete viewMap[view.__id];
- }
- else {
- i++;
- }
- }
- }
- /**
- * Processor data in each series
- *
- * @param {module:echarts/model/Global} ecModel
- * @private
- */
- function processData(ecModel, api) {
- each(dataProcessorFuncs, function (process) {
- process.func(ecModel, api);
- });
- }
- /**
- * @private
- */
- function stackSeriesData(ecModel) {
- var stackedDataMap = {};
- ecModel.eachSeries(function (series) {
- var stack = series.get('stack');
- var data = series.getData();
- if (stack && data.type === 'list') {
- var previousStack = stackedDataMap[stack];
- if (previousStack) {
- data.stackedOn = previousStack;
- }
- stackedDataMap[stack] = data;
- }
- });
- }
- /**
- * Layout before each chart render there series, special visual encoding stage
- *
- * @param {module:echarts/model/Global} ecModel
- * @private
- */
- function doLayout(ecModel, payload) {
- var api = this._api;
- each(visualFuncs, function (visual) {
- if (visual.isLayout) {
- visual.func(ecModel, api, payload);
- }
- });
- }
- /**
- * Encode visual infomation from data after data processing
- *
- * @param {module:echarts/model/Global} ecModel
- * @param {object} layout
- * @param {boolean} [excludesLayout]
- * @private
- */
- function doVisualEncoding(ecModel, payload, excludesLayout) {
- var api = this._api;
- ecModel.clearColorPalette();
- ecModel.eachSeries(function (seriesModel) {
- seriesModel.clearColorPalette();
- });
- each(visualFuncs, function (visual) {
- (!excludesLayout || !visual.isLayout)
- && visual.func(ecModel, api, payload);
- });
- }
- /**
- * Render each chart and component
- * @private
- */
- function doRender(ecModel, payload) {
- var api = this._api;
- // Render all components
- each(this._componentsViews, function (componentView) {
- var componentModel = componentView.__model;
- componentView.render(componentModel, ecModel, api, payload);
- updateZ(componentModel, componentView);
- }, this);
- each(this._chartsViews, function (chart) {
- chart.__alive = false;
- }, this);
- // Render all charts
- ecModel.eachSeries(function (seriesModel, idx) {
- var chartView = this._chartsMap[seriesModel.__viewId];
- chartView.__alive = true;
- chartView.render(seriesModel, ecModel, api, payload);
- chartView.group.silent = !!seriesModel.get('silent');
- updateZ(seriesModel, chartView);
- updateProgressiveAndBlend(seriesModel, chartView);
- }, this);
- // If use hover layer
- updateHoverLayerStatus(this._zr, ecModel);
- // Remove groups of unrendered charts
- each(this._chartsViews, function (chart) {
- if (!chart.__alive) {
- chart.remove(ecModel, api);
- }
- }, this);
- }
- var MOUSE_EVENT_NAMES = [
- 'click', 'dblclick', 'mouseover', 'mouseout', 'mousemove',
- 'mousedown', 'mouseup', 'globalout', 'contextmenu'
- ];
- /**
- * @private
- */
- echartsProto._initEvents = function () {
- each(MOUSE_EVENT_NAMES, function (eveName) {
- this._zr.on(eveName, function (e) {
- var ecModel = this.getModel();
- var el = e.target;
- var params;
- // no e.target when 'globalout'.
- if (eveName === 'globalout') {
- params = {};
- }
- else if (el && el.dataIndex != null) {
- var dataModel = el.dataModel || ecModel.getSeriesByIndex(el.seriesIndex);
- params = dataModel && dataModel.getDataParams(el.dataIndex, el.dataType) || {};
- }
- // If element has custom eventData of components
- else if (el && el.eventData) {
- params = zrUtil.extend({}, el.eventData);
- }
- if (params) {
- params.event = e;
- params.type = eveName;
- this.trigger(eveName, params);
- }
- }, this);
- }, this);
- each(eventActionMap, function (actionType, eventType) {
- this._messageCenter.on(eventType, function (event) {
- this.trigger(eventType, event);
- }, this);
- }, this);
- };
- /**
- * @return {boolean}
- */
- echartsProto.isDisposed = function () {
- return this._disposed;
- };
- /**
- * Clear
- */
- echartsProto.clear = function () {
- this.setOption({ series: [] }, true);
- };
- /**
- * Dispose instance
- */
- echartsProto.dispose = function () {
- if (this._disposed) {
- if (__DEV__) {
- console.warn('Instance ' + this.id + ' has been disposed');
- }
- return;
- }
- this._disposed = true;
- var api = this._api;
- var ecModel = this._model;
- each(this._componentsViews, function (component) {
- component.dispose(ecModel, api);
- });
- each(this._chartsViews, function (chart) {
- chart.dispose(ecModel, api);
- });
- // Dispose after all views disposed
- this._zr.dispose();
- delete instances[this.id];
- };
- zrUtil.mixin(ECharts, Eventful);
- function updateHoverLayerStatus(zr, ecModel) {
- var storage = zr.storage;
- var elCount = 0;
- storage.traverse(function (el) {
- if (!el.isGroup) {
- elCount++;
- }
- });
- if (elCount > ecModel.get('hoverLayerThreshold') && !env.node) {
- storage.traverse(function (el) {
- if (!el.isGroup) {
- el.useHoverLayer = true;
- }
- });
- }
- }
- /**
- * Update chart progressive and blend.
- * @param {module:echarts/model/Series|module:echarts/model/Component} model
- * @param {module:echarts/view/Component|module:echarts/view/Chart} view
- */
- function updateProgressiveAndBlend(seriesModel, chartView) {
- // Progressive configuration
- var elCount = 0;
- chartView.group.traverse(function (el) {
- if (el.type !== 'group' && !el.ignore) {
- elCount++;
- }
- });
- var frameDrawNum = +seriesModel.get('progressive');
- var needProgressive = elCount > seriesModel.get('progressiveThreshold') && frameDrawNum && !env.node;
- if (needProgressive) {
- chartView.group.traverse(function (el) {
- // FIXME marker and other components
- if (!el.isGroup) {
- el.progressive = needProgressive ?
- Math.floor(elCount++ / frameDrawNum) : -1;
- if (needProgressive) {
- el.stopAnimation(true);
- }
- }
- });
- }
- // Blend configration
- var blendMode = seriesModel.get('blendMode') || null;
- if (__DEV__) {
- if (!env.canvasSupported && blendMode && blendMode !== 'source-over') {
- console.warn('Only canvas support blendMode');
- }
- }
- chartView.group.traverse(function (el) {
- // FIXME marker and other components
- if (!el.isGroup) {
- el.setStyle('blend', blendMode);
- }
- });
- }
- /**
- * @param {module:echarts/model/Series|module:echarts/model/Component} model
- * @param {module:echarts/view/Component|module:echarts/view/Chart} view
- */
- function updateZ(model, view) {
- var z = model.get('z');
- var zlevel = model.get('zlevel');
- // Set z and zlevel
- view.group.traverse(function (el) {
- if (el.type !== 'group') {
- z != null && (el.z = z);
- zlevel != null && (el.zlevel = zlevel);
- }
- });
- }
- /**
- * @type {Array.<Function>}
- * @inner
- */
- var actions = [];
- /**
- * Map eventType to actionType
- * @type {Object}
- */
- var eventActionMap = {};
- /**
- * Data processor functions of each stage
- * @type {Array.<Object.<string, Function>>}
- * @inner
- */
- var dataProcessorFuncs = [];
- /**
- * @type {Array.<Function>}
- * @inner
- */
- var optionPreprocessorFuncs = [];
- /**
- * Visual encoding functions of each stage
- * @type {Array.<Object.<string, Function>>}
- * @inner
- */
- var visualFuncs = [];
- /**
- * Theme storage
- * @type {Object.<key, Object>}
- */
- var themeStorage = {};
- /**
- * Loading effects
- */
- var loadingEffects = {};
- var instances = {};
- var connectedGroups = {};
- var idBase = new Date() - 0;
- var groupIdBase = new Date() - 0;
- var DOM_ATTRIBUTE_KEY = '_echarts_instance_';
- /**
- * @alias module:echarts
- */
- var echarts = {
- /**
- * @type {number}
- */
- version: '3.4.0',
- dependencies: {
- zrender: '3.3.0'
- }
- };
- function enableConnect(chart) {
- var STATUS_PENDING = 0;
- var STATUS_UPDATING = 1;
- var STATUS_UPDATED = 2;
- var STATUS_KEY = '__connectUpdateStatus';
- function updateConnectedChartsStatus(charts, status) {
- for (var i = 0; i < charts.length; i++) {
- var otherChart = charts[i];
- otherChart[STATUS_KEY] = status;
- }
- }
- zrUtil.each(eventActionMap, function (actionType, eventType) {
- chart._messageCenter.on(eventType, function (event) {
- if (connectedGroups[chart.group] && chart[STATUS_KEY] !== STATUS_PENDING) {
- var action = chart.makeActionFromEvent(event);
- var otherCharts = [];
- zrUtil.each(instances, function (otherChart) {
- if (otherChart !== chart && otherChart.group === chart.group) {
- otherCharts.push(otherChart);
- }
- });
- updateConnectedChartsStatus(otherCharts, STATUS_PENDING);
- each(otherCharts, function (otherChart) {
- if (otherChart[STATUS_KEY] !== STATUS_UPDATING) {
- otherChart.dispatchAction(action);
- }
- });
- updateConnectedChartsStatus(otherCharts, STATUS_UPDATED);
- }
- });
- });
- }
- /**
- * @param {HTMLDomElement} dom
- * @param {Object} [theme]
- * @param {Object} opts
- * @param {number} [opts.devicePixelRatio] Use window.devicePixelRatio by default
- * @param {string} [opts.renderer] Currently only 'canvas' is supported.
- * @param {number} [opts.width] Use clientWidth of the input `dom` by default.
- * Can be 'auto' (the same as null/undefined)
- * @param {number} [opts.height] Use clientHeight of the input `dom` by default.
- * Can be 'auto' (the same as null/undefined)
- */
- echarts.init = function (dom, theme, opts) {
- if (__DEV__) {
- // Check version
- if ((zrender.version.replace('.', '') - 0) < (echarts.dependencies.zrender.replace('.', '') - 0)) {
- throw new Error(
- 'ZRender ' + zrender.version
- + ' is too old for ECharts ' + echarts.version
- + '. Current version need ZRender '
- + echarts.dependencies.zrender + '+'
- );
- }
- if (!dom) {
- throw new Error('Initialize failed: invalid dom.');
- }
- if (zrUtil.isDom(dom) && dom.nodeName.toUpperCase() !== 'CANVAS' && (!dom.clientWidth || !dom.clientHeight)) {
- console.warn('Can\'t get dom width or height');
- }
- }
- var chart = new ECharts(dom, theme, opts);
- chart.id = 'ec_' + idBase++;
- instances[chart.id] = chart;
- dom.setAttribute &&
- dom.setAttribute(DOM_ATTRIBUTE_KEY, chart.id);
- enableConnect(chart);
- return chart;
- };
- /**
- * @return {string|Array.<module:echarts~ECharts>} groupId
- */
- echarts.connect = function (groupId) {
- // Is array of charts
- if (zrUtil.isArray(groupId)) {
- var charts = groupId;
- groupId = null;
- // If any chart has group
- zrUtil.each(charts, function (chart) {
- if (chart.group != null) {
- groupId = chart.group;
- }
- });
- groupId = groupId || ('g_' + groupIdBase++);
- zrUtil.each(charts, function (chart) {
- chart.group = groupId;
- });
- }
- connectedGroups[groupId] = true;
- return groupId;
- };
- /**
- * @return {string} groupId
- */
- echarts.disConnect = function (groupId) {
- connectedGroups[groupId] = false;
- };
- /**
- * Dispose a chart instance
- * @param {module:echarts~ECharts|HTMLDomElement|string} chart
- */
- echarts.dispose = function (chart) {
- if (zrUtil.isDom(chart)) {
- chart = echarts.getInstanceByDom(chart);
- }
- else if (typeof chart === 'string') {
- chart = instances[chart];
- }
- if ((chart instanceof ECharts) && !chart.isDisposed()) {
- chart.dispose();
- }
- };
- /**
- * @param {HTMLDomElement} dom
- * @return {echarts~ECharts}
- */
- echarts.getInstanceByDom = function (dom) {
- var key = dom.getAttribute(DOM_ATTRIBUTE_KEY);
- return instances[key];
- };
- /**
- * @param {string} key
- * @return {echarts~ECharts}
- */
- echarts.getInstanceById = function (key) {
- return instances[key];
- };
- /**
- * Register theme
- */
- echarts.registerTheme = function (name, theme) {
- themeStorage[name] = theme;
- };
- /**
- * Register option preprocessor
- * @param {Function} preprocessorFunc
- */
- echarts.registerPreprocessor = function (preprocessorFunc) {
- optionPreprocessorFuncs.push(preprocessorFunc);
- };
- /**
- * @param {number} [priority=1000]
- * @param {Function} processorFunc
- */
- echarts.registerProcessor = function (priority, processorFunc) {
- if (typeof priority === 'function') {
- processorFunc = priority;
- priority = PRIORITY_PROCESSOR_FILTER;
- }
- if (__DEV__) {
- if (isNaN(priority)) {
- throw new Error('Unkown processor priority');
- }
- }
- dataProcessorFuncs.push({
- prio: priority,
- func: processorFunc
- });
- };
- /**
- * Usage:
- * registerAction('someAction', 'someEvent', function () { ... });
- * registerAction('someAction', function () { ... });
- * registerAction(
- * {type: 'someAction', event: 'someEvent', update: 'updateView'},
- * function () { ... }
- * );
- *
- * @param {(string|Object)} actionInfo
- * @param {string} actionInfo.type
- * @param {string} [actionInfo.event]
- * @param {string} [actionInfo.update]
- * @param {string} [eventName]
- * @param {Function} action
- */
- echarts.registerAction = function (actionInfo, eventName, action) {
- if (typeof eventName === 'function') {
- action = eventName;
- eventName = '';
- }
- var actionType = zrUtil.isObject(actionInfo)
- ? actionInfo.type
- : ([actionInfo, actionInfo = {
- event: eventName
- }][0]);
- // Event name is all lowercase
- actionInfo.event = (actionInfo.event || actionType).toLowerCase();
- eventName = actionInfo.event;
- // Validate action type and event name.
- zrUtil.assert(ACTION_REG.test(actionType) && ACTION_REG.test(eventName));
- if (!actions[actionType]) {
- actions[actionType] = {action: action, actionInfo: actionInfo};
- }
- eventActionMap[eventName] = actionType;
- };
- /**
- * @param {string} type
- * @param {*} CoordinateSystem
- */
- echarts.registerCoordinateSystem = function (type, CoordinateSystem) {
- CoordinateSystemManager.register(type, CoordinateSystem);
- };
- /**
- * Layout is a special stage of visual encoding
- * Most visual encoding like color are common for different chart
- * But each chart has it's own layout algorithm
- *
- * @param {number} [priority=1000]
- * @param {Function} layoutFunc
- */
- echarts.registerLayout = function (priority, layoutFunc) {
- if (typeof priority === 'function') {
- layoutFunc = priority;
- priority = PRIORITY_VISUAL_LAYOUT;
- }
- if (__DEV__) {
- if (isNaN(priority)) {
- throw new Error('Unkown layout priority');
- }
- }
- visualFuncs.push({
- prio: priority,
- func: layoutFunc,
- isLayout: true
- });
- };
- /**
- * @param {number} [priority=3000]
- * @param {Function} visualFunc
- */
- echarts.registerVisual = function (priority, visualFunc) {
- if (typeof priority === 'function') {
- visualFunc = priority;
- priority = PRIORITY_VISUAL_CHART;
- }
- if (__DEV__) {
- if (isNaN(priority)) {
- throw new Error('Unkown visual priority');
- }
- }
- visualFuncs.push({
- prio: priority,
- func: visualFunc
- });
- };
- /**
- * @param {string} name
- */
- echarts.registerLoading = function (name, loadingFx) {
- loadingEffects[name] = loadingFx;
- };
- /**
- * @param {Object} opts
- * @param {string} [superClass]
- */
- echarts.extendComponentModel = function (opts/*, superClass*/) {
- // var Clazz = ComponentModel;
- // if (superClass) {
- // var classType = parseClassType(superClass);
- // Clazz = ComponentModel.getClass(classType.main, classType.sub, true);
- // }
- return ComponentModel.extend(opts);
- };
- /**
- * @param {Object} opts
- * @param {string} [superClass]
- */
- echarts.extendComponentView = function (opts/*, superClass*/) {
- // var Clazz = ComponentView;
- // if (superClass) {
- // var classType = parseClassType(superClass);
- // Clazz = ComponentView.getClass(classType.main, classType.sub, true);
- // }
- return ComponentView.extend(opts);
- };
- /**
- * @param {Object} opts
- * @param {string} [superClass]
- */
- echarts.extendSeriesModel = function (opts/*, superClass*/) {
- // var Clazz = SeriesModel;
- // if (superClass) {
- // superClass = 'series.' + superClass.replace('series.', '');
- // var classType = parseClassType(superClass);
- // Clazz = ComponentModel.getClass(classType.main, classType.sub, true);
- // }
- return SeriesModel.extend(opts);
- };
- /**
- * @param {Object} opts
- * @param {string} [superClass]
- */
- echarts.extendChartView = function (opts/*, superClass*/) {
- // var Clazz = ChartView;
- // if (superClass) {
- // superClass = superClass.replace('series.', '');
- // var classType = parseClassType(superClass);
- // Clazz = ChartView.getClass(classType.main, true);
- // }
- return ChartView.extend(opts);
- };
- /**
- * ZRender need a canvas context to do measureText.
- * But in node environment canvas may be created by node-canvas.
- * So we need to specify how to create a canvas instead of using document.createElement('canvas')
- *
- * Be careful of using it in the browser.
- *
- * @param {Function} creator
- * @example
- * var Canvas = require('canvas');
- * var echarts = require('echarts');
- * echarts.setCanvasCreator(function () {
- * // Small size is enough.
- * return new Canvas(32, 32);
- * });
- */
- echarts.setCanvasCreator = function (creator) {
- zrUtil.createCanvas = creator;
- };
- echarts.registerVisual(PRIORITY_VISUAL_GLOBAL, require('./visual/seriesColor'));
- echarts.registerPreprocessor(require('./preprocessor/backwardCompat'));
- echarts.registerLoading('default', require('./loading/default'));
- // Default action
- echarts.registerAction({
- type: 'highlight',
- event: 'highlight',
- update: 'highlight'
- }, zrUtil.noop);
- echarts.registerAction({
- type: 'downplay',
- event: 'downplay',
- update: 'downplay'
- }, zrUtil.noop);
- // --------
- // Exports
- // --------
- //
- echarts.List = require('./data/List');
- echarts.Model = require('./model/Model');
- echarts.graphic = require('./util/graphic');
- echarts.number = require('./util/number');
- echarts.format = require('./util/format');
- echarts.throttle = throttle.throttle;
- echarts.matrix = require('zrender/core/matrix');
- echarts.vector = require('zrender/core/vector');
- echarts.color = require('zrender/tool/color');
- echarts.util = {};
- each([
- 'map', 'each', 'filter', 'indexOf', 'inherits', 'reduce', 'filter',
- 'bind', 'curry', 'isArray', 'isString', 'isObject', 'isFunction',
- 'extend', 'defaults', 'clone'
- ],
- function (name) {
- echarts.util[name] = zrUtil[name];
- }
- );
- // PRIORITY
- echarts.PRIORITY = {
- PROCESSOR: {
- FILTER: PRIORITY_PROCESSOR_FILTER,
- STATISTIC: PRIORITY_PROCESSOR_STATISTIC
- },
- VISUAL: {
- LAYOUT: PRIORITY_VISUAL_LAYOUT,
- GLOBAL: PRIORITY_VISUAL_GLOBAL,
- CHART: PRIORITY_VISUAL_CHART,
- COMPONENT: PRIORITY_VISUAL_COMPONENT,
- BRUSH: PRIORITY_VISUAL_BRUSH
- }
- };
- return echarts;
- });
|