echarts.js 68.1 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements.  See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership.  The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License.  You may obtain a copy of the License at
*
*   http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied.  See the License for the
* specific language governing permissions and limitations
* under the License.
*/
S
sushuang 已提交
19
import {__DEV__} from './config';
S
sushuang 已提交
20 21 22 23 24 25
import * as zrender from 'zrender/src/zrender';
import * as zrUtil from 'zrender/src/core/util';
import * as colorTool from 'zrender/src/tool/color';
import env from 'zrender/src/core/env';
import timsort from 'zrender/src/core/timsort';
import Eventful from 'zrender/src/mixin/Eventful';
S
sushuang 已提交
26 27 28 29 30
import GlobalModel from './model/Global';
import ExtensionAPI from './ExtensionAPI';
import CoordinateSystemManager from './CoordinateSystem';
import OptionManager from './model/OptionManager';
import backwardCompat from './preprocessor/backwardCompat';
S
sushuang 已提交
31
import dataStack from './processor/dataStack';
S
sushuang 已提交
32 33 34 35 36 37 38 39
import ComponentModel from './model/Component';
import SeriesModel from './model/Series';
import ComponentView from './view/Component';
import ChartView from './view/Chart';
import * as graphic from './util/graphic';
import * as modelUtil from './util/model';
import {throttle} from './util/throttle';
import seriesColor from './visual/seriesColor';
O
Ovilia 已提交
40
import aria from './visual/aria';
S
sushuang 已提交
41
import loadingDefault from './loading/default';
S
tweak  
sushuang 已提交
42
import Scheduler from './stream/Scheduler';
P
pissang 已提交
43 44
import lightTheme from './theme/light';
import darkTheme from './theme/dark';
S
sushuang 已提交
45
import './component/dataset';
S
sushuang 已提交
46
import mapDataStorage from './coord/geo/mapDataStorage';
S
sushuang 已提交
47

S
sushuang 已提交
48
var assert = zrUtil.assert;
S
sushuang 已提交
49
var each = zrUtil.each;
S
sushuang 已提交
50 51
var isFunction = zrUtil.isFunction;
var isObject = zrUtil.isObject;
S
sushuang 已提交
52
var parseClassType = ComponentModel.parseClassType;
L
lang 已提交
53

S
sushuang 已提交
54
export var version = '4.2.1';
55

S
sushuang 已提交
56
export var dependencies = {
S
sushuang 已提交
57
    zrender: '4.0.6'
S
sushuang 已提交
58
};
59

S
sushuang 已提交
60
var TEST_FRAME_REMAIN_TIME = 1;
S
sushuang 已提交
61

S
sushuang 已提交
62 63 64 65
var PRIORITY_PROCESSOR_FILTER = 1000;
var PRIORITY_PROCESSOR_STATISTIC = 5000;

var PRIORITY_VISUAL_LAYOUT = 1000;
S
sushuang 已提交
66
var PRIORITY_VISUAL_PROGRESSIVE_LAYOUT = 1100;
S
sushuang 已提交
67 68 69 70 71 72 73
var PRIORITY_VISUAL_GLOBAL = 2000;
var PRIORITY_VISUAL_CHART = 3000;
var PRIORITY_VISUAL_COMPONENT = 4000;
// FIXME
// necessary?
var PRIORITY_VISUAL_BRUSH = 5000;

S
sushuang 已提交
74 75 76 77 78 79 80
export var PRIORITY = {
    PROCESSOR: {
        FILTER: PRIORITY_PROCESSOR_FILTER,
        STATISTIC: PRIORITY_PROCESSOR_STATISTIC
    },
    VISUAL: {
        LAYOUT: PRIORITY_VISUAL_LAYOUT,
S
sushuang 已提交
81
        PROGRESSIVE_LAYOUT: PRIORITY_VISUAL_PROGRESSIVE_LAYOUT,
S
sushuang 已提交
82 83 84 85 86 87
        GLOBAL: PRIORITY_VISUAL_GLOBAL,
        CHART: PRIORITY_VISUAL_CHART,
        COMPONENT: PRIORITY_VISUAL_COMPONENT,
        BRUSH: PRIORITY_VISUAL_BRUSH
    }
};
88

S
sushuang 已提交
89 90 91 92 93 94 95 96
// 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 OPTION_UPDATED = '__optionUpdated';
var ACTION_REG = /^[a-zA-Z0-9_]+$/;
L
lang 已提交
97

L
lang 已提交
98

S
sushuang 已提交
99 100 101 102 103 104 105
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);
    };
}
L
lang 已提交
106

S
sushuang 已提交
107 108 109 110 111 112 113 114 115 116
/**
 * @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);
117

S
sushuang 已提交
118 119 120 121 122
/**
 * @module echarts~ECharts
 */
function ECharts(dom, theme, opts) {
    opts = opts || {};
123

S
sushuang 已提交
124 125 126
    // Get theme by name
    if (typeof theme === 'string') {
        theme = themeStorage[theme];
L
lang 已提交
127
    }
L
lang 已提交
128

129
    /**
S
sushuang 已提交
130
     * @type {string}
131
     */
S
sushuang 已提交
132
    this.id;
S
sushuang 已提交
133

134
    /**
S
sushuang 已提交
135 136
     * Group id
     * @type {string}
137
     */
S
sushuang 已提交
138
    this.group;
S
sushuang 已提交
139

140
    /**
S
sushuang 已提交
141 142
     * @type {HTMLElement}
     * @private
143
     */
S
sushuang 已提交
144
    this._dom = dom;
S
sushuang 已提交
145 146 147 148

    var defaultRenderer = 'canvas';
    if (__DEV__) {
        defaultRenderer = (
P
pissang 已提交
149
            typeof window === 'undefined' ? global : window
S
sushuang 已提交
150 151 152
        ).__ECHARTS__DEFAULT__RENDERER__ || defaultRenderer;
    }

L
Tweak  
lang 已提交
153
    /**
S
sushuang 已提交
154 155
     * @type {module:zrender/ZRender}
     * @private
L
Tweak  
lang 已提交
156
     */
S
sushuang 已提交
157
    var zr = this._zr = zrender.init(dom, {
S
sushuang 已提交
158
        renderer: opts.renderer || defaultRenderer,
S
sushuang 已提交
159 160 161 162
        devicePixelRatio: opts.devicePixelRatio,
        width: opts.width,
        height: opts.height
    });
P
pah100 已提交
163

L
tweak  
lang 已提交
164
    /**
D
deqingli 已提交
165
     * Expect 60 fps.
S
sushuang 已提交
166 167
     * @type {Function}
     * @private
L
tweak  
lang 已提交
168
     */
S
sushuang 已提交
169
    this._throttledZrFlush = throttle(zrUtil.bind(zr.flush, zr), 17);
L
lang 已提交
170

S
sushuang 已提交
171 172
    var theme = zrUtil.clone(theme);
    theme && backwardCompat(theme, true);
L
lang 已提交
173
    /**
S
sushuang 已提交
174 175
     * @type {Object}
     * @private
L
lang 已提交
176
     */
S
sushuang 已提交
177
    this._theme = theme;
L
lang 已提交
178

L
tweak  
lang 已提交
179
    /**
S
sushuang 已提交
180 181
     * @type {Array.<module:echarts/view/Chart>}
     * @private
L
tweak  
lang 已提交
182
     */
S
sushuang 已提交
183
    this._chartsViews = [];
L
lang 已提交
184

L
tweak  
lang 已提交
185
    /**
S
sushuang 已提交
186 187
     * @type {Object.<string, module:echarts/view/Chart>}
     * @private
L
tweak  
lang 已提交
188
     */
S
sushuang 已提交
189
    this._chartsMap = {};
L
lang 已提交
190

191
    /**
S
sushuang 已提交
192 193
     * @type {Array.<module:echarts/view/Component>}
     * @private
194
     */
S
sushuang 已提交
195
    this._componentsViews = [];
196

L
lang 已提交
197
    /**
S
sushuang 已提交
198 199
     * @type {Object.<string, module:echarts/view/Component>}
     * @private
L
lang 已提交
200
     */
S
sushuang 已提交
201 202
    this._componentsMap = {};

L
lang 已提交
203
    /**
S
sushuang 已提交
204 205
     * @type {module:echarts/CoordinateSystem}
     * @private
L
lang 已提交
206
     */
S
sushuang 已提交
207
    this._coordSysMgr = new CoordinateSystemManager();
L
lang 已提交
208 209

    /**
S
sushuang 已提交
210 211
     * @type {module:echarts/ExtensionAPI}
     * @private
L
lang 已提交
212
     */
S
sushuang 已提交
213
    var api = this._api = createExtensionAPI(this);
L
lang 已提交
214

215 216 217 218 219 220 221
    // Sort on demand
    function prioritySortFunc(a, b) {
        return a.__prio - b.__prio;
    }
    timsort(visualFuncs, prioritySortFunc);
    timsort(dataProcessorFuncs, prioritySortFunc);

S
sushuang 已提交
222
    /**
S
tweak  
sushuang 已提交
223
     * @type {module:echarts/stream/Scheduler}
S
sushuang 已提交
224
     */
225
    this._scheduler = new Scheduler(this, api, dataProcessorFuncs, visualFuncs);
S
sushuang 已提交
226

S
sushuang 已提交
227
    Eventful.call(this, this._ecEventProcessor = new EventProcessor());
228

1
100pah 已提交
229
    /**
S
sushuang 已提交
230 231
     * @type {module:echarts~MessageCenter}
     * @private
1
100pah 已提交
232
     */
S
sushuang 已提交
233
    this._messageCenter = new MessageCenter();
1
100pah 已提交
234

S
sushuang 已提交
235 236
    // Init mouse events
    this._initEvents();
1
100pah 已提交
237

S
sushuang 已提交
238 239
    // In case some people write `window.onresize = chart.resize`
    this.resize = zrUtil.bind(this.resize, this);
1
100pah 已提交
240

S
sushuang 已提交
241 242
    // Can't dispatch action during rendering procedure
    this._pendingActions = [];
1
100pah 已提交
243

S
sushuang 已提交
244
    zr.animation.on('frame', this._onframe, this);
1
100pah 已提交
245

S
sushuang 已提交
246 247
    bindRenderedEvent(zr, this);

S
sushuang 已提交
248 249 250
    // ECharts instance can be used as value.
    zrUtil.setAsPrimitive(this);
}
1
100pah 已提交
251

S
sushuang 已提交
252
var echartsProto = ECharts.prototype;
1
100pah 已提交
253

S
sushuang 已提交
254
echartsProto._onframe = function () {
S
tweak  
sushuang 已提交
255
    if (this._disposed) {
S
sushuang 已提交
256 257 258
        return;
    }

S
sushuang 已提交
259 260
    var scheduler = this._scheduler;

S
sushuang 已提交
261 262 263
    // Lazy update
    if (this[OPTION_UPDATED]) {
        var silent = this[OPTION_UPDATED].silent;
1
100pah 已提交
264

S
sushuang 已提交
265
        this[IN_MAIN_PROCESS] = true;
1
100pah 已提交
266

S
sushuang 已提交
267 268
        prepare(this);
        updateMethods.update.call(this);
1
100pah 已提交
269

S
sushuang 已提交
270
        this[IN_MAIN_PROCESS] = false;
271

S
sushuang 已提交
272
        this[OPTION_UPDATED] = false;
273

S
sushuang 已提交
274
        flushPendingActions.call(this, silent);
275

S
sushuang 已提交
276 277
        triggerUpdatedEvent.call(this, silent);
    }
S
sushuang 已提交
278
    // Avoid do both lazy update and progress in one frame.
S
sushuang 已提交
279
    else if (scheduler.unfinished) {
S
sushuang 已提交
280 281 282
        // Stream progress.
        var remainTime = TEST_FRAME_REMAIN_TIME;
        var ecModel = this._model;
S
sushuang 已提交
283 284 285 286
        var api = this._api;
        scheduler.unfinished = false;
        do {
            var startTime = +new Date();
S
tweak  
sushuang 已提交
287

S
sushuang 已提交
288
            scheduler.performSeriesTasks(ecModel);
S
tweak  
sushuang 已提交
289

S
sushuang 已提交
290
            // Currently dataProcessorFuncs do not check threshold.
291
            scheduler.performDataProcessorTasks(ecModel);
S
sushuang 已提交
292

S
sushuang 已提交
293
            updateStreamModes(this, ecModel);
S
sushuang 已提交
294

S
sushuang 已提交
295 296 297 298
            // Do not update coordinate system here. Because that coord system update in
            // each frame is not a good user experience. So we follow the rule that
            // the extent of the coordinate system is determin in the first frame (the
            // frame is executed immedietely after task reset.
S
sushuang 已提交
299
            // this._coordSysMgr.update(ecModel, api);
S
sushuang 已提交
300

S
sushuang 已提交
301
            // console.log('--- ec frame visual ---', remainTime);
302
            scheduler.performVisualTasks(ecModel);
S
tweak  
sushuang 已提交
303

S
sushuang 已提交
304
            renderSeries(this, this._model, api, 'remain');
S
sushuang 已提交
305

S
sushuang 已提交
306 307 308
            remainTime -= (+new Date() - startTime);
        }
        while (remainTime > 0 && scheduler.unfinished);
S
sushuang 已提交
309

S
sushuang 已提交
310
        // Call flush explicitly for trigger finished event.
S
sushuang 已提交
311
        if (!scheduler.unfinished) {
S
sushuang 已提交
312
            this._zr.flush();
S
tweak  
sushuang 已提交
313
        }
S
sushuang 已提交
314 315
        // Else, zr flushing be ensue within the same frame,
        // because zr flushing is after onframe event.
S
sushuang 已提交
316
    }
S
tweak  
sushuang 已提交
317
};
S
sushuang 已提交
318

S
sushuang 已提交
319 320 321 322 323 324
/**
 * @return {HTMLElement}
 */
echartsProto.getDom = function () {
    return this._dom;
};
325

S
sushuang 已提交
326 327 328 329 330 331
/**
 * @return {module:zrender~ZRender}
 */
echartsProto.getZr = function () {
    return this._zr;
};
332

S
sushuang 已提交
333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348
/**
 * 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__) {
S
sushuang 已提交
349
        assert(!this[IN_MAIN_PROCESS], '`setOption` should not be called during main process.');
S
sushuang 已提交
350
    }
351

S
sushuang 已提交
352
    var silent;
S
sushuang 已提交
353
    if (isObject(notMerge)) {
S
sushuang 已提交
354 355 356 357
        lazyUpdate = notMerge.lazyUpdate;
        silent = notMerge.silent;
        notMerge = notMerge.notMerge;
    }
358

S
sushuang 已提交
359
    this[IN_MAIN_PROCESS] = true;
360

S
sushuang 已提交
361 362 363
    if (!this._model || notMerge) {
        var optionManager = new OptionManager(this._api);
        var theme = this._theme;
364
        var ecModel = this._model = new GlobalModel();
S
tweak  
sushuang 已提交
365
        ecModel.scheduler = this._scheduler;
S
sushuang 已提交
366 367
        ecModel.init(null, null, theme, optionManager);
    }
368

S
sushuang 已提交
369
    this._model.setOption(option, optionPreprocessorFuncs);
1
100pah 已提交
370

S
sushuang 已提交
371 372 373 374 375
    if (lazyUpdate) {
        this[OPTION_UPDATED] = {silent: silent};
        this[IN_MAIN_PROCESS] = false;
    }
    else {
S
sushuang 已提交
376 377 378 379
        prepare(this);

        updateMethods.update.call(this);

S
sushuang 已提交
380 381 382
        // Ensure zr refresh sychronously, and then pixel in canvas can be
        // fetched after `setOption`.
        this._zr.flush();
L
lang 已提交
383

S
sushuang 已提交
384 385
        this[OPTION_UPDATED] = false;
        this[IN_MAIN_PROCESS] = false;
L
lang 已提交
386

S
sushuang 已提交
387 388 389 390 391 392 393 394 395
        flushPendingActions.call(this, silent);
        triggerUpdatedEvent.call(this, silent);
    }
};

/**
 * @DEPRECATED
 */
echartsProto.setTheme = function () {
S
sushuang 已提交
396
    console.error('ECharts#setTheme() is DEPRECATED in ECharts 3.0');
S
sushuang 已提交
397
};
L
lang 已提交
398

S
sushuang 已提交
399 400 401 402 403 404
/**
 * @return {module:echarts/model/Global}
 */
echartsProto.getModel = function () {
    return this._model;
};
405

S
sushuang 已提交
406 407 408 409 410 411
/**
 * @return {Object}
 */
echartsProto.getOption = function () {
    return this._model && this._model.getOption();
};
P
pah100 已提交
412

S
sushuang 已提交
413 414 415 416 417 418
/**
 * @return {number}
 */
echartsProto.getWidth = function () {
    return this._zr.getWidth();
};
419

S
sushuang 已提交
420 421 422 423 424 425
/**
 * @return {number}
 */
echartsProto.getHeight = function () {
    return this._zr.getHeight();
};
L
lang 已提交
426

S
sushuang 已提交
427 428 429 430 431 432
/**
 * @return {number}
 */
echartsProto.getDevicePixelRatio = function () {
    return this._zr.painter.dpr || window.devicePixelRatio || 1;
};
L
lang 已提交
433

S
sushuang 已提交
434 435 436 437
/**
 * Get canvas which has all thing rendered
 * @param {Object} opts
 * @param {string} [opts.backgroundColor]
S
sushuang 已提交
438
 * @return {string}
S
sushuang 已提交
439 440 441 442 443 444 445 446 447 448
 */
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;
S
sushuang 已提交
449
    // var list = zr.storage.getDisplayList();
S
sushuang 已提交
450
    // Stop animations
S
sushuang 已提交
451 452 453 454
    // Never works before in init animation, so remove it.
    // zrUtil.each(list, function (el) {
    //     el.stopAnimation(true);
    // });
S
sushuang 已提交
455 456
    return zr.painter.getRenderedCanvas(opts);
};
O
Ovilia 已提交
457

S
sushuang 已提交
458 459 460 461 462 463 464 465
/**
 * Get svg data url
 * @return {string}
 */
echartsProto.getSvgDataUrl = function () {
    if (!env.svgSupported) {
        return;
    }
O
Ovilia 已提交
466

S
sushuang 已提交
467 468 469 470 471 472
    var zr = this._zr;
    var list = zr.storage.getDisplayList();
    // Stop animations
    zrUtil.each(list, function (el) {
        el.stopAnimation(true);
    });
473

474
    return zr.painter.pathToDataUrl();
S
sushuang 已提交
475
};
476

S
sushuang 已提交
477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502
/**
 * @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;
            }
        });
    });
L
lang 已提交
503

S
sushuang 已提交
504 505 506 507 508
    var url = this._zr.painter.getType() === 'svg'
        ? this.getSvgDataUrl()
        : this.getRenderedCanvas(opts).toDataURL(
            'image/' + (opts && opts.type || 'png')
        );
509

S
sushuang 已提交
510 511 512
    each(excludesComponentViews, function (view) {
        view.group.ignore = false;
    });
L
lang 已提交
513

S
sushuang 已提交
514 515
    return url;
};
516

517

S
sushuang 已提交
518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554
/**
 * @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
L
lang 已提交
555 556
                });
            }
S
sushuang 已提交
557
        });
L
lang 已提交
558

S
sushuang 已提交
559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575
        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
L
lang 已提交
576
                }
S
sushuang 已提交
577 578 579 580
            });
            zr.add(img);
        });
        zr.refreshImmediately();
L
lang 已提交
581

S
sushuang 已提交
582 583 584 585 586 587
        return targetCanvas.toDataURL('image/' + (opts && opts.type || 'png'));
    }
    else {
        return this.getDataURL(opts);
    }
};
L
lang 已提交
588

S
sushuang 已提交
589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607
/**
 * 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');
608

S
sushuang 已提交
609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627
/**
 * 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');
628

S
sushuang 已提交
629 630 631 632
function doConvertPixel(methodName, finder, value) {
    var ecModel = this._model;
    var coordSysList = this._coordSysMgr.getCoordinateSystems();
    var result;
633

S
sushuang 已提交
634
    finder = modelUtil.parseFinder(ecModel, finder);
635

S
sushuang 已提交
636 637 638 639 640 641 642 643
    for (var i = 0; i < coordSysList.length; i++) {
        var coordSys = coordSysList[i];
        if (coordSys[methodName]
            && (result = coordSys[methodName](ecModel, finder, value)) != null
        ) {
            return result;
        }
    }
P
pah100 已提交
644

S
sushuang 已提交
645 646 647 648 649 650
    if (__DEV__) {
        console.warn(
            'No coordinate system that supports ' + methodName + ' found by the given finder.'
        );
    }
}
651

S
sushuang 已提交
652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671
/**
 * 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;
672

S
sushuang 已提交
673
    finder = modelUtil.parseFinder(ecModel, finder);
674

S
sushuang 已提交
675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693
    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.'
                        ));
                    }
                }
694
            }
S
sushuang 已提交
695 696 697 698 699 700 701
            else {
                if (__DEV__) {
                    console.warn(key + ': containPoint is not supported');
                }
            }
        }, this);
    }, this);
702

S
sushuang 已提交
703 704
    return !!result;
};
P
pah100 已提交
705

S
sushuang 已提交
706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722
/**
 * 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;
723

S
sushuang 已提交
724
    finder = modelUtil.parseFinder(ecModel, finder, {defaultMainType: 'series'});
725

S
sushuang 已提交
726
    var seriesModel = finder.seriesModel;
727

S
sushuang 已提交
728 729 730 731 732
    if (__DEV__) {
        if (!seriesModel) {
            console.warn('There is no specified seires model');
        }
    }
733

S
sushuang 已提交
734
    var data = seriesModel.getData();
735

S
sushuang 已提交
736 737 738 739 740
    var dataIndexInside = finder.hasOwnProperty('dataIndexInside')
        ? finder.dataIndexInside
        : finder.hasOwnProperty('dataIndex')
        ? data.indexOfRawIndex(finder.dataIndex)
        : null;
L
lang 已提交
741

S
sushuang 已提交
742 743 744 745
    return dataIndexInside != null
        ? data.getItemVisual(dataIndexInside, visualType)
        : data.getVisual(visualType);
};
746

S
sushuang 已提交
747 748 749 750 751 752 753 754
/**
 * Get view of corresponding component model
 * @param  {module:echarts/model/Component} componentModel
 * @return {module:echarts/view/Component}
 */
echartsProto.getViewOfComponentModel = function (componentModel) {
    return this._componentsMap[componentModel.__viewId];
};
P
pah100 已提交
755

S
sushuang 已提交
756 757 758 759 760 761 762 763
/**
 * Get view of corresponding series model
 * @param  {module:echarts/model/Series} seriesModel
 * @return {module:echarts/view/Chart}
 */
echartsProto.getViewOfSeriesModel = function (seriesModel) {
    return this._chartsMap[seriesModel.__viewId];
};
P
pah100 已提交
764

S
sushuang 已提交
765
var updateMethods = {
766

S
sushuang 已提交
767 768 769 770 771
    prepareAndUpdate: function (payload) {
        prepare(this);
        updateMethods.update.call(this, payload);
    },

772
    /**
S
sushuang 已提交
773
     * @param {Object} payload
774 775
     * @private
     */
S
sushuang 已提交
776 777
    update: function (payload) {
        // console.profile && console.profile('update');
P
pah100 已提交
778

S
sushuang 已提交
779 780 781
        var ecModel = this._model;
        var api = this._api;
        var zr = this._zr;
S
sushuang 已提交
782
        var coordSysMgr = this._coordSysMgr;
S
tweak  
sushuang 已提交
783 784
        var scheduler = this._scheduler;

S
sushuang 已提交
785 786
        // update before setOption
        if (!ecModel) {
P
pah100 已提交
787 788 789
            return;
        }

790
        scheduler.restoreData(ecModel, payload);
S
sushuang 已提交
791

S
sushuang 已提交
792
        scheduler.performSeriesTasks(ecModel);
793

S
sushuang 已提交
794 795 796
        // 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.
1
100pah 已提交
797

S
sushuang 已提交
798 799
        // Create new coordinate system each update
        // In LineView may save the old coordinate system and use it to get the orignal point
S
sushuang 已提交
800
        coordSysMgr.create(ecModel, api);
S
tweak  
sushuang 已提交
801

802
        scheduler.performDataProcessorTasks(ecModel, payload);
S
sushuang 已提交
803

S
sushuang 已提交
804 805
        // Current stream render is not supported in data process. So we can update
        // stream modes after data processing, where the filtered data is used to
806
        // deteming whether use progressive rendering.
S
sushuang 已提交
807
        updateStreamModes(this, ecModel);
808

809 810 811 812 813 814
        // We update stream modes before coordinate system updated, then the modes info
        // can be fetched when coord sys updating (consider the barGrid extent fix). But
        // the drawback is the full coord info can not be fetched. Fortunately this full
        // coord is not requied in stream mode updater currently.
        coordSysMgr.update(ecModel, api);

S
sushuang 已提交
815
        clearColorPalette(ecModel);
816
        scheduler.performVisualTasks(ecModel, payload);
817

S
sushuang 已提交
818
        render(this, ecModel, api, payload);
S
tweak  
sushuang 已提交
819

S
sushuang 已提交
820 821
        // Set background
        var backgroundColor = ecModel.get('backgroundColor') || 'transparent';
L
lang 已提交
822

P
pissang 已提交
823 824 825 826 827 828 829
        // In IE8
        if (!env.canvasSupported) {
            var colorArr = colorTool.parse(backgroundColor);
            backgroundColor = colorTool.stringify(colorArr, 'rgb');
            if (colorArr[3] === 0) {
                backgroundColor = 'transparent';
            }
S
sushuang 已提交
830 831
        }
        else {
P
pissang 已提交
832
            zr.setBackgroundColor(backgroundColor);
S
sushuang 已提交
833
        }
834

S
sushuang 已提交
835
        performPostUpdateFuncs(ecModel, api);
836

S
sushuang 已提交
837 838
        // console.profile && console.profileEnd('update');
    },
L
lang 已提交
839

S
sushuang 已提交
840 841 842 843 844 845 846 847 848 849 850 851 852 853
    /**
     * @param {Object} payload
     * @private
     */
    updateTransform: function (payload) {
        var ecModel = this._model;
        var ecIns = this;
        var api = this._api;

        // update before setOption
        if (!ecModel) {
            return;
        }

854
        // ChartView.markUpdateMethod(payload, 'updateTransform');
S
sushuang 已提交
855

S
sushuang 已提交
856 857 858 859 860 861 862 863 864 865 866 867 868 869 870
        var componentDirtyList = [];
        ecModel.eachComponent(function (componentType, componentModel) {
            var componentView = ecIns.getViewOfComponentModel(componentModel);
            if (componentView && componentView.__alive) {
                if (componentView.updateTransform) {
                    var result = componentView.updateTransform(componentModel, ecModel, api, payload);
                    result && result.update && componentDirtyList.push(componentView);
                }
                else {
                    componentDirtyList.push(componentView);
                }
            }
        });

        var seriesDirtyMap = zrUtil.createHashMap();
S
sushuang 已提交
871 872 873
        ecModel.eachSeries(function (seriesModel) {
            var chartView = ecIns._chartsMap[seriesModel.__viewId];
            if (chartView.updateTransform) {
S
sushuang 已提交
874 875
                var result = chartView.updateTransform(seriesModel, ecModel, api, payload);
                result && result.update && seriesDirtyMap.set(seriesModel.uid, 1);
S
sushuang 已提交
876 877
            }
            else {
S
sushuang 已提交
878
                seriesDirtyMap.set(seriesModel.uid, 1);
S
sushuang 已提交
879 880 881
            }
        });

S
sushuang 已提交
882
        clearColorPalette(ecModel);
S
sushuang 已提交
883
        // Keep pipe to the exist pipeline because it depends on the render task of the full pipeline.
884
        // this._scheduler.performVisualTasks(ecModel, payload, 'layout', true);
S
sushuang 已提交
885
        this._scheduler.performVisualTasks(
886
            ecModel, payload, {setDirty: true, dirtyMap: seriesDirtyMap}
S
sushuang 已提交
887 888
        );

S
sushuang 已提交
889 890
        // Currently, not call render of components. Geo render cost a lot.
        // renderComponents(ecIns, ecModel, api, payload, componentDirtyList);
S
sushuang 已提交
891
        renderSeries(ecIns, ecModel, api, payload, seriesDirtyMap);
S
sushuang 已提交
892 893 894 895

        performPostUpdateFuncs(ecModel, this._api);
    },

L
lang 已提交
896
    /**
S
sushuang 已提交
897 898
     * @param {Object} payload
     * @private
L
lang 已提交
899
     */
S
sushuang 已提交
900 901
    updateView: function (payload) {
        var ecModel = this._model;
902

S
sushuang 已提交
903 904
        // update before setOption
        if (!ecModel) {
L
lang 已提交
905 906
            return;
        }
L
lang 已提交
907

S
sushuang 已提交
908
        ChartView.markUpdateMethod(payload, 'updateView');
S
tweak  
sushuang 已提交
909

S
sushuang 已提交
910
        clearColorPalette(ecModel);
L
lang 已提交
911

S
tweak  
sushuang 已提交
912
        // Keep pipe to the exist pipeline because it depends on the render task of the full pipeline.
913
        this._scheduler.performVisualTasks(ecModel, payload, {setDirty: true});
P
pah100 已提交
914

S
sushuang 已提交
915
        render(this, this._model, this._api, payload);
S
tweak  
sushuang 已提交
916

S
sushuang 已提交
917
        performPostUpdateFuncs(ecModel, this._api);
S
sushuang 已提交
918
    },
L
lang 已提交
919

L
tweak  
lang 已提交
920 921
    /**
     * @param {Object} payload
S
sushuang 已提交
922
     * @private
L
tweak  
lang 已提交
923
     */
S
sushuang 已提交
924
    updateVisual: function (payload) {
925
        updateMethods.update.call(this, payload);
926

927
        // var ecModel = this._model;
L
lang 已提交
928

929 930 931 932
        // // update before setOption
        // if (!ecModel) {
        //     return;
        // }
S
tweak  
sushuang 已提交
933

934
        // ChartView.markUpdateMethod(payload, 'updateVisual');
935

936
        // clearColorPalette(ecModel);
937

938
        // // Keep pipe to the exist pipeline because it depends on the render task of the full pipeline.
939
        // this._scheduler.performVisualTasks(ecModel, payload, {visualType: 'visual', setDirty: true});
S
tweak  
sushuang 已提交
940

941 942 943
        // render(this, this._model, this._api, payload);

        // performPostUpdateFuncs(ecModel, this._api);
S
sushuang 已提交
944
    },
1
tweak  
100pah 已提交
945

S
sushuang 已提交
946 947 948 949 950
    /**
     * @param {Object} payload
     * @private
     */
    updateLayout: function (payload) {
951
        updateMethods.update.call(this, payload);
S
sushuang 已提交
952

953
        // var ecModel = this._model;
954

955 956 957 958
        // // update before setOption
        // if (!ecModel) {
        //     return;
        // }
S
tweak  
sushuang 已提交
959

960
        // ChartView.markUpdateMethod(payload, 'updateLayout');
961

962
        // // Keep pipe to the exist pipeline because it depends on the render task of the full pipeline.
963 964
        // // this._scheduler.performVisualTasks(ecModel, payload, 'layout', true);
        // this._scheduler.performVisualTasks(ecModel, payload, {setDirty: true});
S
tweak  
sushuang 已提交
965

966 967 968
        // render(this, this._model, this._api, payload);

        // performPostUpdateFuncs(ecModel, this._api);
S
sushuang 已提交
969 970
    }
};
S
sushuang 已提交
971

S
sushuang 已提交
972
function prepare(ecIns) {
S
sushuang 已提交
973 974
    var ecModel = ecIns._model;
    var scheduler = ecIns._scheduler;
1
tweak  
100pah 已提交
975

S
sushuang 已提交
976 977
    scheduler.restorePipelines(ecModel);

978
    scheduler.prepareStageTasks();
1
tweak  
100pah 已提交
979

S
sushuang 已提交
980
    prepareView(ecIns, 'component', ecModel, scheduler);
S
sushuang 已提交
981

S
sushuang 已提交
982
    prepareView(ecIns, 'chart', ecModel, scheduler);
S
sushuang 已提交
983

S
sushuang 已提交
984
    scheduler.plan();
S
sushuang 已提交
985
}
L
lang 已提交
986

S
sushuang 已提交
987 988 989 990 991
/**
 * @private
 */
function updateDirectly(ecIns, method, payload, mainType, subType) {
    var ecModel = ecIns._model;
P
pah100 已提交
992

S
sushuang 已提交
993 994
    // broadcast
    if (!mainType) {
995 996 997
        // FIXME
        // Chart will not be update directly here, except set dirty.
        // But there is no such scenario now.
S
sushuang 已提交
998 999 1000
        each(ecIns._componentsViews.concat(ecIns._chartsViews), callView);
        return;
    }
1001

S
sushuang 已提交
1002 1003 1004 1005
    var query = {};
    query[mainType + 'Id'] = payload[mainType + 'Id'];
    query[mainType + 'Index'] = payload[mainType + 'Index'];
    query[mainType + 'Name'] = payload[mainType + 'Name'];
1006

S
sushuang 已提交
1007 1008
    var condition = {mainType: mainType, query: query};
    subType && (condition.subType = subType); // subType may be '' by parseClassType;
1009

1010 1011 1012 1013 1014
    var excludeSeriesId = payload.excludeSeriesId;
    if (excludeSeriesId != null) {
        excludeSeriesId = zrUtil.createHashMap(modelUtil.normalizeToArray(excludeSeriesId));
    }

S
sushuang 已提交
1015
    // If dispatchAction before setOption, do nothing.
1016 1017 1018 1019 1020 1021
    ecModel && ecModel.eachComponent(condition, function (model) {
        if (!excludeSeriesId || excludeSeriesId.get(model.id) == null) {
            callView(ecIns[
                mainType === 'series' ? '_chartsMap' : '_componentsMap'
            ][model.__viewId]);
        }
S
sushuang 已提交
1022
    }, ecIns);
1023

S
sushuang 已提交
1024 1025 1026 1027
    function callView(view) {
        view && view.__alive && view[method] && view[method](
            view.__model, ecModel, ecIns._api, payload
        );
1
tweak  
100pah 已提交
1028
    }
S
sushuang 已提交
1029
}
L
tweak  
lang 已提交
1030

S
sushuang 已提交
1031 1032 1033 1034 1035 1036 1037 1038 1039
/**
 * 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__) {
S
sushuang 已提交
1040
        assert(!this[IN_MAIN_PROCESS], '`resize` should not be called during main process.');
1
tweak  
100pah 已提交
1041
    }
L
lang 已提交
1042

S
sushuang 已提交
1043
    this._zr.resize(opts);
L
lang 已提交
1044

S
sushuang 已提交
1045 1046
    var ecModel = this._model;

P
pissang 已提交
1047 1048 1049 1050 1051 1052 1053 1054
    // Resize loading effect
    this._loadingFX && this._loadingFX.resize();

    if (!ecModel) {
        return;
    }

    var optionChanged = ecModel.resetOption('media');
S
sushuang 已提交
1055

S
sushuang 已提交
1056
    var silent = opts && opts.silent;
S
sushuang 已提交
1057

S
sushuang 已提交
1058
    this[IN_MAIN_PROCESS] = true;
S
sushuang 已提交
1059

S
sushuang 已提交
1060 1061
    optionChanged && prepare(this);
    updateMethods.update.call(this);
1062

S
sushuang 已提交
1063
    this[IN_MAIN_PROCESS] = false;
1064

S
sushuang 已提交
1065
    flushPendingActions.call(this, silent);
1066

S
sushuang 已提交
1067 1068
    triggerUpdatedEvent.call(this, silent);
};
1069

S
sushuang 已提交
1070 1071 1072 1073 1074 1075 1076 1077
function updateStreamModes(ecIns, ecModel) {
    var chartsMap = ecIns._chartsMap;
    var scheduler = ecIns._scheduler;
    ecModel.eachSeries(function (seriesModel) {
        scheduler.updateStreamModes(seriesModel, chartsMap[seriesModel.__viewId]);
    });
}

S
sushuang 已提交
1078 1079 1080 1081 1082 1083
/**
 * Show loading effect
 * @param  {string} [name='default']
 * @param  {Object} [cfg]
 */
echartsProto.showLoading = function (name, cfg) {
S
sushuang 已提交
1084
    if (isObject(name)) {
S
sushuang 已提交
1085 1086
        cfg = name;
        name = '';
1087
    }
S
sushuang 已提交
1088
    name = name || 'default';
L
lang 已提交
1089

S
sushuang 已提交
1090 1091 1092 1093
    this.hideLoading();
    if (!loadingEffects[name]) {
        if (__DEV__) {
            console.warn('Loading effects ' + name + ' not exists.');
L
tweak  
lang 已提交
1094
        }
S
sushuang 已提交
1095 1096 1097 1098 1099
        return;
    }
    var el = loadingEffects[name](this._api, cfg);
    var zr = this._zr;
    this._loadingFX = el;
L
lang 已提交
1100

S
sushuang 已提交
1101 1102
    zr.add(el);
};
L
tweak  
lang 已提交
1103

S
sushuang 已提交
1104 1105 1106 1107 1108 1109 1110
/**
 * Hide loading effect
 */
echartsProto.hideLoading = function () {
    this._loadingFX && this._zr.remove(this._loadingFX);
    this._loadingFX = null;
};
L
Tweak  
lang 已提交
1111

S
sushuang 已提交
1112 1113 1114 1115 1116 1117 1118 1119 1120
/**
 * @param {Object} eventObj
 * @return {Object}
 */
echartsProto.makeActionFromEvent = function (eventObj) {
    var payload = zrUtil.extend({}, eventObj);
    payload.type = eventActionMap[eventObj.type];
    return payload;
};
L
tweak  
lang 已提交
1121

S
sushuang 已提交
1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134
/**
 * @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) {
S
sushuang 已提交
1135
    if (!isObject(opt)) {
S
sushuang 已提交
1136
        opt = {silent: !!opt};
1137 1138
    }

S
sushuang 已提交
1139 1140
    if (!actions[payload.type]) {
        return;
1141
    }
L
lang 已提交
1142

S
sushuang 已提交
1143 1144 1145
    // Avoid dispatch action before setOption. Especially in `connect`.
    if (!this._model) {
        return;
1146
    }
L
lang 已提交
1147

S
sushuang 已提交
1148 1149 1150 1151
    // May dispatchAction in rendering procedure
    if (this[IN_MAIN_PROCESS]) {
        this._pendingActions.push(payload);
        return;
1152
    }
L
lang 已提交
1153

S
sushuang 已提交
1154
    doDispatchAction.call(this, payload, opt.silent);
L
lang 已提交
1155

S
sushuang 已提交
1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166
    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();
    }
L
tweak  
lang 已提交
1167

S
sushuang 已提交
1168
    flushPendingActions.call(this, opt.silent);
L
tweak  
lang 已提交
1169

S
sushuang 已提交
1170 1171
    triggerUpdatedEvent.call(this, opt.silent);
};
L
tweak  
lang 已提交
1172

S
sushuang 已提交
1173 1174 1175 1176 1177
function doDispatchAction(payload, silent) {
    var payloadType = payload.type;
    var escapeConnect = payload.escapeConnect;
    var actionWrap = actions[payloadType];
    var actionInfo = actionWrap.actionInfo;
L
tweak  
lang 已提交
1178

S
sushuang 已提交
1179 1180 1181
    var cptType = (actionInfo.update || 'update').split(':');
    var updateMethod = cptType.pop();
    cptType = cptType[0] != null && parseClassType(cptType[0]);
L
lang 已提交
1182

S
sushuang 已提交
1183
    this[IN_MAIN_PROCESS] = true;
1184

S
sushuang 已提交
1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195
    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;
        });
    }
L
lang 已提交
1196

S
sushuang 已提交
1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218
    var eventObjBatch = [];
    var eventObj;
    var isHighDown = payloadType === 'highlight' || payloadType === 'downplay';

    each(payloads, function (batchItem) {
        // Action can specify the event by return it.
        eventObj = actionWrap.action(batchItem, this._model, this._api);
        // 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);
        }
    }, this);
L
tweak  
lang 已提交
1219

S
sushuang 已提交
1220 1221 1222 1223
    if (updateMethod !== 'none' && !isHighDown && !cptType) {
        // Still dirty
        if (this[OPTION_UPDATED]) {
            // FIXME Pass payload ?
S
sushuang 已提交
1224 1225
            prepare(this);
            updateMethods.update.call(this, payload);
S
sushuang 已提交
1226 1227 1228 1229 1230 1231
            this[OPTION_UPDATED] = false;
        }
        else {
            updateMethods[updateMethod].call(this, payload);
        }
    }
1232

S
sushuang 已提交
1233 1234 1235 1236 1237 1238 1239 1240 1241 1242
    // Follow the rule of action batch
    if (batched) {
        eventObj = {
            type: actionInfo.event || payloadType,
            escapeConnect: escapeConnect,
            batch: eventObjBatch
        };
    }
    else {
        eventObj = eventObjBatch[0];
1243
    }
L
lang 已提交
1244

S
sushuang 已提交
1245
    this[IN_MAIN_PROCESS] = false;
1
100pah 已提交
1246

S
sushuang 已提交
1247 1248
    !silent && this._messageCenter.trigger(eventObj.type, eventObj);
}
1
100pah 已提交
1249

S
sushuang 已提交
1250 1251 1252 1253 1254 1255 1256
function flushPendingActions(silent) {
    var pendingActions = this._pendingActions;
    while (pendingActions.length) {
        var payload = pendingActions.shift();
        doDispatchAction.call(this, payload, silent);
    }
}
L
lang 已提交
1257

S
sushuang 已提交
1258 1259 1260
function triggerUpdatedEvent(silent) {
    !silent && this.trigger('updated');
}
L
lang 已提交
1261

S
sushuang 已提交
1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296
/**
 * Event `rendered` is triggered when zr
 * rendered. It is useful for realtime
 * snapshot (reflect animation).
 *
 * Event `finished` is triggered when:
 * (1) zrender rendering finished.
 * (2) initial animation finished.
 * (3) progressive rendering finished.
 * (4) no pending action.
 * (5) no delayed setOption needs to be processed.
 */
function bindRenderedEvent(zr, ecIns) {
    zr.on('rendered', function () {

        ecIns.trigger('rendered');

        // The `finished` event should not be triggered repeatly,
        // so it should only be triggered when rendering indeed happend
        // in zrender. (Consider the case that dipatchAction is keep
        // triggering when mouse move).
        if (
            // Although zr is dirty if initial animation is not finished
            // and this checking is called on frame, we also check
            // animation finished for robustness.
            zr.animation.isFinished()
            && !ecIns[OPTION_UPDATED]
            && !ecIns._scheduler.unfinished
            && !ecIns._pendingActions.length
        ) {
            ecIns.trigger('finished');
        }
    });
}

S
sushuang 已提交
1297 1298 1299 1300 1301 1302
/**
 * @param {Object} params
 * @param {number} params.seriesIndex
 * @param {Array|TypedArray} params.data
 */
echartsProto.appendData = function (params) {
S
tweak  
sushuang 已提交
1303 1304
    var seriesIndex = params.seriesIndex;
    var ecModel = this.getModel();
S
sushuang 已提交
1305
    var seriesModel = ecModel.getSeriesByIndex(seriesIndex);
S
sushuang 已提交
1306

S
tweak  
sushuang 已提交
1307
    if (__DEV__) {
S
sushuang 已提交
1308
        assert(params.data && seriesModel);
S
tweak  
sushuang 已提交
1309
    }
S
sushuang 已提交
1310

P
pissang 已提交
1311
    seriesModel.appendData(params);
S
sushuang 已提交
1312

1313 1314 1315 1316 1317 1318 1319 1320
    // Note: `appendData` does not support that update extent of coordinate
    // system, util some scenario require that. In the expected usage of
    // `appendData`, the initial extent of coordinate system should better
    // be fixed by axis `min`/`max` setting or initial data, otherwise if
    // the extent changed while `appendData`, the location of the painted
    // graphic elements have to be changed, which make the usage of
    // `appendData` meaningless.

S
sushuang 已提交
1321
    this._scheduler.unfinished = true;
S
tweak  
sushuang 已提交
1322
};
S
sushuang 已提交
1323

S
sushuang 已提交
1324 1325 1326 1327 1328 1329 1330
/**
 * Register event
 * @method
 */
echartsProto.on = createRegisterEventWithLowercaseName('on');
echartsProto.off = createRegisterEventWithLowercaseName('off');
echartsProto.one = createRegisterEventWithLowercaseName('one');
L
lang 已提交
1331

S
sushuang 已提交
1332 1333 1334 1335 1336
/**
 * Prepare view instances of charts and components
 * @param  {module:echarts/model/Global} ecModel
 * @private
 */
S
sushuang 已提交
1337
function prepareView(ecIns, type, ecModel, scheduler) {
S
sushuang 已提交
1338
    var isComponent = type === 'component';
S
sushuang 已提交
1339 1340 1341 1342
    var viewList = isComponent ? ecIns._componentsViews : ecIns._chartsViews;
    var viewMap = isComponent ? ecIns._componentsMap : ecIns._chartsMap;
    var zr = ecIns._zr;
    var api = ecIns._api;
S
sushuang 已提交
1343 1344 1345

    for (var i = 0; i < viewList.length; i++) {
        viewList[i].__alive = false;
1346
    }
1347

S
sushuang 已提交
1348 1349 1350 1351 1352
    isComponent
        ? ecModel.eachComponent(function (componentType, model) {
            componentType !== 'series' && doPrepare(model);
        })
        : ecModel.eachSeries(doPrepare);
1353

S
sushuang 已提交
1354
    function doPrepare(model) {
S
sushuang 已提交
1355 1356 1357 1358 1359 1360 1361 1362
        // Consider: id same and type changed.
        var viewId = '_ec_' + 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);
S
sushuang 已提交
1363 1364

            if (__DEV__) {
S
sushuang 已提交
1365
                assert(Clazz, classType.sub + ' does not exist.');
1366
            }
S
sushuang 已提交
1367 1368

            view = new Clazz();
S
sushuang 已提交
1369
            view.init(ecModel, api);
S
sushuang 已提交
1370 1371 1372
            viewMap[viewId] = view;
            viewList.push(view);
            zr.add(view.group);
S
sushuang 已提交
1373
        }
1374

S
sushuang 已提交
1375 1376 1377 1378 1379 1380 1381
        model.__viewId = view.__id = viewId;
        view.__alive = true;
        view.__model = model;
        view.group.__ecComponentInfo = {
            mainType: model.mainType,
            index: model.componentIndex
        };
S
sushuang 已提交
1382
        !isComponent && scheduler.prepareView(view, model, ecModel, api);
S
sushuang 已提交
1383
    }
S
sushuang 已提交
1384 1385 1386 1387

    for (var i = 0; i < viewList.length;) {
        var view = viewList[i];
        if (!view.__alive) {
S
sushuang 已提交
1388
            !isComponent && view.renderTask.dispose();
S
sushuang 已提交
1389
            zr.remove(view.group);
S
sushuang 已提交
1390
            view.dispose(ecModel, api);
S
sushuang 已提交
1391 1392 1393 1394 1395 1396 1397
            viewList.splice(i, 1);
            delete viewMap[view.__id];
            view.__id = view.group.__ecComponentInfo = null;
        }
        else {
            i++;
        }
L
lang 已提交
1398
    }
S
sushuang 已提交
1399
}
1400

S
sushuang 已提交
1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427
// /**
//  * Encode visual infomation from data after data processing
//  *
//  * @param {module:echarts/model/Global} ecModel
//  * @param {object} layout
//  * @param {boolean} [layoutFilter] `true`: only layout,
//  *                                 `false`: only not layout,
//  *                                 `null`/`undefined`: all.
//  * @param {string} taskBaseTag
//  * @private
//  */
// function startVisualEncoding(ecIns, ecModel, api, payload, layoutFilter) {
//     each(visualFuncs, function (visual, index) {
//         var isLayout = visual.isLayout;
//         if (layoutFilter == null
//             || (layoutFilter === false && !isLayout)
//             || (layoutFilter === true && isLayout)
//         ) {
//             visual.func(ecModel, api, payload);
//         }
//     });
// }

function clearColorPalette(ecModel) {
    ecModel.clearColorPalette();
    ecModel.eachSeries(function (seriesModel) {
        seriesModel.clearColorPalette();
S
sushuang 已提交
1428
    });
S
sushuang 已提交
1429 1430
}

S
sushuang 已提交
1431 1432
function render(ecIns, ecModel, api, payload) {

S
sushuang 已提交
1433
    renderComponents(ecIns, ecModel, api, payload);
S
sushuang 已提交
1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448

    each(ecIns._chartsViews, function (chart) {
        chart.__alive = false;
    });

    renderSeries(ecIns, ecModel, api, payload);

    // Remove groups of unrendered charts
    each(ecIns._chartsViews, function (chart) {
        if (!chart.__alive) {
            chart.remove(ecModel, api);
        }
    });
}

S
sushuang 已提交
1449 1450 1451 1452 1453 1454 1455 1456 1457
function renderComponents(ecIns, ecModel, api, payload, dirtyList) {
    each(dirtyList || ecIns._componentsViews, function (componentView) {
        var componentModel = componentView.__model;
        componentView.render(componentModel, ecModel, api, payload);

        updateZ(componentModel, componentView);
    });
}

S
sushuang 已提交
1458 1459 1460 1461
/**
 * Render each chart and component
 * @private
 */
1462
function renderSeries(ecIns, ecModel, api, payload, dirtyMap) {
S
sushuang 已提交
1463
    // Render all charts
S
sushuang 已提交
1464 1465
    var scheduler = ecIns._scheduler;
    var unfinished;
1466
    ecModel.eachSeries(function (seriesModel) {
S
sushuang 已提交
1467
        var chartView = ecIns._chartsMap[seriesModel.__viewId];
S
sushuang 已提交
1468
        chartView.__alive = true;
L
lang 已提交
1469

S
sushuang 已提交
1470
        var renderTask = chartView.renderTask;
S
sushuang 已提交
1471
        scheduler.updatePayload(renderTask, payload);
1472 1473 1474 1475 1476

        if (dirtyMap && dirtyMap.get(seriesModel.uid)) {
            renderTask.dirty();
        }

S
sushuang 已提交
1477
        unfinished |= renderTask.perform(scheduler.getPerformArgs(renderTask));
L
lang 已提交
1478

S
sushuang 已提交
1479
        chartView.group.silent = !!seriesModel.get('silent');
P
pah100 已提交
1480

S
sushuang 已提交
1481
        updateZ(seriesModel, chartView);
S
sushuang 已提交
1482

P
pissang 已提交
1483
        updateBlend(seriesModel, chartView);
1484
    });
S
sushuang 已提交
1485
    scheduler.unfinished |= unfinished;
S
sushuang 已提交
1486 1487

    // If use hover layer
P
pissang 已提交
1488
    updateHoverLayerStatus(ecIns._zr, ecModel);
O
Ovilia 已提交
1489 1490

    // Add aria
1491
    aria(ecIns._zr.dom, ecModel);
S
sushuang 已提交
1492 1493
}

S
sushuang 已提交
1494 1495 1496
function performPostUpdateFuncs(ecModel, api) {
    each(postUpdateFuncs, function (func) {
        func(ecModel, api);
S
sushuang 已提交
1497
    });
S
tweak  
sushuang 已提交
1498 1499
}

S
sushuang 已提交
1500

S
sushuang 已提交
1501 1502 1503 1504
var MOUSE_EVENT_NAMES = [
    'click', 'dblclick', 'mouseover', 'mouseout', 'mousemove',
    'mousedown', 'mouseup', 'globalout', 'contextmenu'
];
S
sushuang 已提交
1505

S
sushuang 已提交
1506 1507 1508 1509 1510
/**
 * @private
 */
echartsProto._initEvents = function () {
    each(MOUSE_EVENT_NAMES, function (eveName) {
1511
        var handler = function (e) {
S
sushuang 已提交
1512 1513 1514
            var ecModel = this.getModel();
            var el = e.target;
            var params;
1515
            var isGlobalOut = eveName === 'globalout';
S
sushuang 已提交
1516 1517

            // no e.target when 'globalout'.
1518
            if (isGlobalOut) {
S
sushuang 已提交
1519 1520 1521 1522
                params = {};
            }
            else if (el && el.dataIndex != null) {
                var dataModel = el.dataModel || ecModel.getSeriesByIndex(el.seriesIndex);
1523
                params = dataModel && dataModel.getDataParams(el.dataIndex, el.dataType, el) || {};
S
sushuang 已提交
1524 1525 1526 1527 1528
            }
            // If element has custom eventData of components
            else if (el && el.eventData) {
                params = zrUtil.extend({}, el.eventData);
            }
P
pah100 已提交
1529

S
sushuang 已提交
1530 1531 1532 1533 1534 1535 1536 1537
            // Contract: if params prepared in mouse event,
            // these properties must be specified:
            // {
            //    componentType: string (component main type)
            //    componentIndex: number
            // }
            // Otherwise event query can not work.

S
sushuang 已提交
1538
            if (params) {
S
sushuang 已提交
1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552
                var componentType = params.componentType;
                var componentIndex = params.componentIndex;
                // Special handling for historic reason: when trigger by
                // markLine/markPoint/markArea, the componentType is
                // 'markLine'/'markPoint'/'markArea', but we should better
                // enable them to be queried by seriesIndex, since their
                // option is set in each series.
                if (componentType === 'markLine'
                    || componentType === 'markPoint'
                    || componentType === 'markArea'
                ) {
                    componentType = 'series';
                    componentIndex = params.seriesIndex;
                }
1553 1554 1555 1556 1557 1558 1559 1560 1561 1562
                var model = componentType && componentIndex != null
                    && ecModel.getComponent(componentType, componentIndex);
                var view = model && this[
                    model.mainType === 'series' ? '_chartsMap' : '_componentsMap'
                ][model.__viewId];

                if (__DEV__) {
                    // `event.componentType` and `event[componentTpype + 'Index']` must not
                    // be missed, otherwise there is no way to distinguish source component.
                    // See `dataFormat.getDataParams`.
S
sushuang 已提交
1563 1564 1565
                    if (!isGlobalOut && !(model && view)) {
                        console.warn('model or view can not be found by params');
                    }
1566 1567
                }

S
sushuang 已提交
1568 1569
                params.event = e;
                params.type = eveName;
1570

S
sushuang 已提交
1571 1572 1573 1574 1575 1576
                this._ecEventProcessor.eventInfo = {
                    targetEl: el,
                    packedEvent: params,
                    model: model,
                    view: view
                };
1577

S
sushuang 已提交
1578
                this.trigger(eveName, params);
L
lang 已提交
1579
            }
1580 1581 1582 1583 1584 1585 1586 1587
        };
        // Consider that some component (like tooltip, brush, ...)
        // register zr event handler, but user event handler might
        // do anything, such as call `setOption` or `dispatchAction`,
        // which probably update any of the content and probably
        // cause problem if it is called previous other inner handlers.
        handler.zrEventfulCallAtLast = true;
        this._zr.on(eveName, handler, this);
S
sushuang 已提交
1588 1589 1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617
    }, 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');
L
lang 已提交
1618
        }
S
sushuang 已提交
1619 1620 1621
        return;
    }
    this._disposed = true;
P
pah100 已提交
1622

S
sushuang 已提交
1623 1624
    modelUtil.setAttribute(this.getDom(), DOM_ATTRIBUTE_KEY, '');

S
sushuang 已提交
1625 1626
    var api = this._api;
    var ecModel = this._model;
P
pah100 已提交
1627

S
sushuang 已提交
1628 1629 1630 1631 1632 1633
    each(this._componentsViews, function (component) {
        component.dispose(ecModel, api);
    });
    each(this._chartsViews, function (chart) {
        chart.dispose(ecModel, api);
    });
1
100pah 已提交
1634

S
sushuang 已提交
1635 1636
    // Dispose after all views disposed
    this._zr.dispose();
1
100pah 已提交
1637

S
sushuang 已提交
1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653
    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) {
P
pissang 已提交
1654
                // Don't switch back.
S
sushuang 已提交
1655 1656
                el.useHoverLayer = true;
            }
L
lang 已提交
1657 1658
        });
    }
S
sushuang 已提交
1659
}
P
pah100 已提交
1660

S
sushuang 已提交
1661 1662 1663 1664 1665
/**
 * 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
 */
P
pissang 已提交
1666
function updateBlend(seriesModel, chartView) {
S
sushuang 已提交
1667 1668 1669 1670
    var blendMode = seriesModel.get('blendMode') || null;
    if (__DEV__) {
        if (!env.canvasSupported && blendMode && blendMode !== 'source-over') {
            console.warn('Only canvas support blendMode');
P
pah100 已提交
1671
        }
S
sushuang 已提交
1672 1673 1674 1675
    }
    chartView.group.traverse(function (el) {
        // FIXME marker and other components
        if (!el.isGroup) {
1676 1677 1678 1679
            // Only set if blendMode is changed. In case element is incremental and don't wan't to rerender.
            if (el.style.blend !== blendMode) {
                el.setStyle('blend', blendMode);
            }
S
sushuang 已提交
1680
        }
P
pissang 已提交
1681 1682
        if (el.eachPendingDisplayable) {
            el.eachPendingDisplayable(function (displayable) {
P
pissang 已提交
1683
                displayable.setStyle('blend', blendMode);
P
pissang 已提交
1684 1685
            });
        }
S
sushuang 已提交
1686 1687
    });
}
P
pah100 已提交
1688

S
sushuang 已提交
1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700
/**
 * @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);
P
pah100 已提交
1701
        }
S
sushuang 已提交
1702 1703
    });
}
P
pah100 已提交
1704

S
sushuang 已提交
1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718
function createExtensionAPI(ecInstance) {
    var coordSysMgr = ecInstance._coordSysMgr;
    return zrUtil.extend(new ExtensionAPI(ecInstance), {
        // Inject methods
        getCoordinateSystems: zrUtil.bind(
            coordSysMgr.getCoordinateSystems, coordSysMgr
        ),
        getComponentByElement: function (el) {
            while (el) {
                var modelInfo = el.__ecComponentInfo;
                if (modelInfo != null) {
                    return ecInstance._model.getComponent(modelInfo.mainType, modelInfo.index);
                }
                el = el.parent;
1719
            }
1720
        }
S
sushuang 已提交
1721 1722
    });
}
L
lang 已提交
1723

S
sushuang 已提交
1724

1725
/**
S
sushuang 已提交
1726
 * @class
1727 1728 1729 1730 1731 1732 1733 1734
 * Usage of query:
 * `chart.on('click', query, handler);`
 * The `query` can be:
 * + The component type query string, only `mainType` or `mainType.subType`,
 *   like: 'xAxis', 'series', 'xAxis.category' or 'series.line'.
 * + The component query object, like:
 *   `{seriesIndex: 2}`, `{seriesName: 'xx'}`, `{seriesId: 'some'}`,
 *   `{xAxisIndex: 2}`, `{xAxisName: 'xx'}`, `{xAxisId: 'some'}`.
1735 1736 1737 1738
 * + The data query object, like:
 *   `{dataIndex: 123}`, `{dataType: 'link'}`, `{name: 'some'}`.
 * + The other query object (cmponent customized query), like:
 *   `{element: 'some'}` (only available in custom series).
1739 1740 1741 1742
 *
 * Caveat: If a prop in the `query` object is `null/undefined`, it is the
 * same as there is no such prop in the `query` object.
 */
S
sushuang 已提交
1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768
function EventProcessor() {
    // These info required: targetEl, packedEvent, model, view
    this.eventInfo;
}
EventProcessor.prototype = {
    constructor: EventProcessor,

    normalizeQuery: function (query) {
        var cptQuery = {};
        var dataQuery = {};
        var otherQuery = {};

        // `query` is `mainType` or `mainType.subType` of component.
        if (zrUtil.isString(query)) {
            var condCptType = parseClassType(query);
            // `.main` and `.sub` may be ''.
            cptQuery.mainType = condCptType.main || null;
            cptQuery.subType = condCptType.sub || null;
        }
        // `query` is an object, convert to {mainType, index, name, id}.
        else {
            // `xxxIndex`, `xxxName`, `xxxId`, `name`, `dataIndex`, `dataType` is reserved,
            // can not be used in `compomentModel.filterForExposedEvent`.
            var suffixes = ['Index', 'Name', 'Id'];
            var dataKeys = {name: 1, dataIndex: 1, dataType: 1};
            zrUtil.each(query, function (val, key) {
1769
                var reserved = false;
S
sushuang 已提交
1770 1771 1772 1773 1774 1775 1776 1777 1778 1779
                for (var i = 0; i < suffixes.length; i++) {
                    var propSuffix = suffixes[i];
                    var suffixPos = key.lastIndexOf(propSuffix);
                    if (suffixPos > 0 && suffixPos === key.length - propSuffix.length) {
                        var mainType = key.slice(0, suffixPos);
                        // Consider `dataIndex`.
                        if (mainType !== 'data') {
                            cptQuery.mainType = mainType;
                            cptQuery[propSuffix.toLowerCase()] = val;
                            reserved = true;
1780 1781
                        }
                    }
S
sushuang 已提交
1782 1783 1784 1785 1786 1787 1788 1789 1790 1791
                }
                if (dataKeys.hasOwnProperty(key)) {
                    dataQuery[key] = val;
                    reserved = true;
                }
                if (!reserved) {
                    otherQuery[key] = val;
                }
            });
        }
1792

S
sushuang 已提交
1793 1794 1795 1796 1797 1798
        return {
            cptQuery: cptQuery,
            dataQuery: dataQuery,
            otherQuery: otherQuery
        };
    },
1799

S
sushuang 已提交
1800 1801 1802
    filter: function (eventType, query, args) {
        // They should be assigned before each trigger call.
        var eventInfo = this.eventInfo;
S
sushuang 已提交
1803 1804 1805 1806 1807

        if (!eventInfo) {
            return true;
        }

S
sushuang 已提交
1808 1809 1810 1811 1812 1813 1814 1815
        var targetEl = eventInfo.targetEl;
        var packedEvent = eventInfo.packedEvent;
        var model = eventInfo.model;
        var view = eventInfo.view;

        // For event like 'globalout'.
        if (!model || !view) {
            return true;
1816 1817
        }

S
sushuang 已提交
1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838
        var cptQuery = query.cptQuery;
        var dataQuery = query.dataQuery;

        return check(cptQuery, model, 'mainType')
            && check(cptQuery, model, 'subType')
            && check(cptQuery, model, 'index', 'componentIndex')
            && check(cptQuery, model, 'name')
            && check(cptQuery, model, 'id')
            && check(dataQuery, packedEvent, 'name')
            && check(dataQuery, packedEvent, 'dataIndex')
            && check(dataQuery, packedEvent, 'dataType')
            && (!view.filterForExposedEvent || view.filterForExposedEvent(
                eventType, query.otherQuery, targetEl, packedEvent
            ));

        function check(query, host, prop, propOnHost) {
            return query[prop] == null || host[propOnHost || prop] === query[prop];
        }
    },

    afterTrigger: function () {
S
sushuang 已提交
1839
        // Make sure the eventInfo wont be used in next trigger.
S
sushuang 已提交
1840
        this.eventInfo = null;
1841
    }
S
sushuang 已提交
1842 1843
};

1844

S
sushuang 已提交
1845 1846 1847 1848 1849
/**
 * @type {Object} key: actionType.
 * @inner
 */
var actions = {};
L
lang 已提交
1850

S
sushuang 已提交
1851 1852 1853 1854 1855
/**
 * Map eventType to actionType
 * @type {Object}
 */
var eventActionMap = {};
L
lang 已提交
1856

S
sushuang 已提交
1857 1858 1859 1860 1861 1862
/**
 * Data processor functions of each stage
 * @type {Array.<Object.<string, Function>>}
 * @inner
 */
var dataProcessorFuncs = [];
L
lang 已提交
1863

S
sushuang 已提交
1864 1865 1866 1867 1868
/**
 * @type {Array.<Function>}
 * @inner
 */
var optionPreprocessorFuncs = [];
L
lang 已提交
1869

S
sushuang 已提交
1870 1871 1872 1873 1874
/**
 * @type {Array.<Function>}
 * @inner
 */
var postUpdateFuncs = [];
L
lang 已提交
1875

S
sushuang 已提交
1876 1877 1878 1879 1880
/**
 * Visual encoding functions of each stage
 * @type {Array.<Object.<string, Function>>}
 */
var visualFuncs = [];
S
sushuang 已提交
1881

S
sushuang 已提交
1882 1883 1884 1885 1886 1887 1888 1889 1890
/**
 * Theme storage
 * @type {Object.<key, Object>}
 */
var themeStorage = {};
/**
 * Loading effects
 */
var loadingEffects = {};
L
lang 已提交
1891

S
sushuang 已提交
1892 1893 1894 1895 1896 1897 1898 1899 1900 1901 1902 1903 1904 1905 1906 1907 1908
var instances = {};
var connectedGroups = {};

var idBase = new Date() - 0;
var groupIdBase = new Date() - 0;
var DOM_ATTRIBUTE_KEY = '_echarts_instance_';

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;
L
lang 已提交
1909
        }
S
sushuang 已提交
1910 1911
    }

S
sushuang 已提交
1912
    each(eventActionMap, function (actionType, eventType) {
S
sushuang 已提交
1913 1914 1915 1916 1917 1918 1919 1920 1921
        chart._messageCenter.on(eventType, function (event) {
            if (connectedGroups[chart.group] && chart[STATUS_KEY] !== STATUS_PENDING) {
                if (event && event.escapeConnect) {
                    return;
                }

                var action = chart.makeActionFromEvent(event);
                var otherCharts = [];

S
sushuang 已提交
1922
                each(instances, function (otherChart) {
S
sushuang 已提交
1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943 1944
                    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 {HTMLElement} dom
 * @param {Object} [theme]
 * @param {Object} opts
 * @param {number} [opts.devicePixelRatio] Use window.devicePixelRatio by default
D
deqingli 已提交
1945
 * @param {string} [opts.renderer] Can choose 'canvas' or 'svg' to render the chart.
S
sushuang 已提交
1946 1947 1948 1949 1950
 * @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)
 */
S
sushuang 已提交
1951
export function init(dom, theme, opts) {
S
sushuang 已提交
1952 1953
    if (__DEV__) {
        // Check version
S
sushuang 已提交
1954
        if ((zrender.version.replace('.', '') - 0) < (dependencies.zrender.replace('.', '') - 0)) {
S
sushuang 已提交
1955
            throw new Error(
S
sushuang 已提交
1956
                'zrender/src ' + zrender.version
S
sushuang 已提交
1957
                + ' is too old for ECharts ' + version
S
sushuang 已提交
1958
                + '. Current version need ZRender '
S
sushuang 已提交
1959
                + dependencies.zrender + '+'
S
sushuang 已提交
1960
            );
P
pissang 已提交
1961
        }
S
sushuang 已提交
1962 1963 1964

        if (!dom) {
            throw new Error('Initialize failed: invalid dom.');
L
lang 已提交
1965
        }
S
sushuang 已提交
1966
    }
L
lang 已提交
1967

S
sushuang 已提交
1968
    var existInstance = getInstanceByDom(dom);
S
sushuang 已提交
1969 1970 1971
    if (existInstance) {
        if (__DEV__) {
            console.warn('There is a chart instance already initialized on the dom.');
P
pissang 已提交
1972
        }
S
sushuang 已提交
1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 1984
        return existInstance;
    }

    if (__DEV__) {
        if (zrUtil.isDom(dom)
            && dom.nodeName.toUpperCase() !== 'CANVAS'
            && (
                (!dom.clientWidth && (!opts || opts.width == null))
                || (!dom.clientHeight && (!opts || opts.height == null))
            )
        ) {
            console.warn('Can\'t get dom width or height');
P
pissang 已提交
1985
        }
S
sushuang 已提交
1986
    }
P
pah100 已提交
1987

S
sushuang 已提交
1988 1989 1990
    var chart = new ECharts(dom, theme, opts);
    chart.id = 'ec_' + idBase++;
    instances[chart.id] = chart;
L
lang 已提交
1991

S
sushuang 已提交
1992
    modelUtil.setAttribute(dom, DOM_ATTRIBUTE_KEY, chart.id);
L
lang 已提交
1993

S
sushuang 已提交
1994
    enableConnect(chart);
1995

S
sushuang 已提交
1996
    return chart;
S
sushuang 已提交
1997
}
S
sushuang 已提交
1998 1999 2000 2001

/**
 * @return {string|Array.<module:echarts~ECharts>} groupId
 */
S
sushuang 已提交
2002
export function connect(groupId) {
S
sushuang 已提交
2003 2004 2005 2006 2007
    // Is array of charts
    if (zrUtil.isArray(groupId)) {
        var charts = groupId;
        groupId = null;
        // If any chart has group
S
sushuang 已提交
2008
        each(charts, function (chart) {
S
sushuang 已提交
2009 2010
            if (chart.group != null) {
                groupId = chart.group;
2011
            }
2012
        });
S
sushuang 已提交
2013
        groupId = groupId || ('g_' + groupIdBase++);
S
sushuang 已提交
2014
        each(charts, function (chart) {
S
sushuang 已提交
2015 2016 2017 2018 2019
            chart.group = groupId;
        });
    }
    connectedGroups[groupId] = true;
    return groupId;
S
sushuang 已提交
2020
}
L
lang 已提交
2021

S
sushuang 已提交
2022 2023 2024 2025
/**
 * @DEPRECATED
 * @return {string} groupId
 */
S
sushuang 已提交
2026
export function disConnect(groupId) {
S
sushuang 已提交
2027
    connectedGroups[groupId] = false;
S
sushuang 已提交
2028
}
2029

S
sushuang 已提交
2030 2031 2032
/**
 * @return {string} groupId
 */
S
sushuang 已提交
2033
export var disconnect = disConnect;
L
lang 已提交
2034

S
sushuang 已提交
2035 2036 2037 2038
/**
 * Dispose a chart instance
 * @param  {module:echarts~ECharts|HTMLDomElement|string} chart
 */
S
sushuang 已提交
2039
export function dispose(chart) {
S
sushuang 已提交
2040 2041 2042
    if (typeof chart === 'string') {
        chart = instances[chart];
    }
S
sushuang 已提交
2043
    else if (!(chart instanceof ECharts)) {
S
sushuang 已提交
2044
        // Try to treat as dom
S
sushuang 已提交
2045
        chart = getInstanceByDom(chart);
S
sushuang 已提交
2046 2047 2048 2049
    }
    if ((chart instanceof ECharts) && !chart.isDisposed()) {
        chart.dispose();
    }
S
sushuang 已提交
2050
}
2051

S
sushuang 已提交
2052 2053 2054 2055
/**
 * @param  {HTMLElement} dom
 * @return {echarts~ECharts}
 */
S
sushuang 已提交
2056
export function getInstanceByDom(dom) {
S
sushuang 已提交
2057
    return instances[modelUtil.getAttribute(dom, DOM_ATTRIBUTE_KEY)];
S
sushuang 已提交
2058
}
1
100pah 已提交
2059

S
sushuang 已提交
2060 2061 2062 2063
/**
 * @param {string} key
 * @return {echarts~ECharts}
 */
S
sushuang 已提交
2064
export function getInstanceById(key) {
S
sushuang 已提交
2065
    return instances[key];
S
sushuang 已提交
2066
}
P
pah100 已提交
2067

S
sushuang 已提交
2068 2069 2070
/**
 * Register theme
 */
S
sushuang 已提交
2071
export function registerTheme(name, theme) {
S
sushuang 已提交
2072
    themeStorage[name] = theme;
S
sushuang 已提交
2073
}
L
lang 已提交
2074

S
sushuang 已提交
2075 2076 2077 2078
/**
 * Register option preprocessor
 * @param {Function} preprocessorFunc
 */
S
sushuang 已提交
2079
export function registerPreprocessor(preprocessorFunc) {
S
sushuang 已提交
2080
    optionPreprocessorFuncs.push(preprocessorFunc);
S
sushuang 已提交
2081
}
2082

S
sushuang 已提交
2083 2084
/**
 * @param {number} [priority=1000]
S
sushuang 已提交
2085
 * @param {Object|Function} processor
S
sushuang 已提交
2086
 */
S
sushuang 已提交
2087 2088
export function registerProcessor(priority, processor) {
    normalizeRegister(dataProcessorFuncs, priority, processor, PRIORITY_PROCESSOR_FILTER);
S
sushuang 已提交
2089
}
L
lang 已提交
2090

S
sushuang 已提交
2091 2092 2093 2094
/**
 * Register postUpdater
 * @param {Function} postUpdateFunc
 */
S
sushuang 已提交
2095
export function registerPostUpdate(postUpdateFunc) {
S
sushuang 已提交
2096
    postUpdateFuncs.push(postUpdateFunc);
S
sushuang 已提交
2097
}
L
Update  
lang 已提交
2098

S
sushuang 已提交
2099 2100 2101 2102 2103 2104 2105 2106 2107 2108 2109 2110 2111 2112 2113 2114
/**
 * 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
 */
S
sushuang 已提交
2115
export function registerAction(actionInfo, eventName, action) {
S
sushuang 已提交
2116 2117 2118 2119
    if (typeof eventName === 'function') {
        action = eventName;
        eventName = '';
    }
S
sushuang 已提交
2120
    var actionType = isObject(actionInfo)
S
sushuang 已提交
2121 2122 2123 2124
        ? actionInfo.type
        : ([actionInfo, actionInfo = {
            event: eventName
        }][0]);
L
lang 已提交
2125

S
sushuang 已提交
2126 2127 2128
    // Event name is all lowercase
    actionInfo.event = (actionInfo.event || actionType).toLowerCase();
    eventName = actionInfo.event;
L
Update  
lang 已提交
2129

S
sushuang 已提交
2130
    // Validate action type and event name.
S
sushuang 已提交
2131
    assert(ACTION_REG.test(actionType) && ACTION_REG.test(eventName));
L
Update  
lang 已提交
2132

S
sushuang 已提交
2133 2134 2135 2136
    if (!actions[actionType]) {
        actions[actionType] = {action: action, actionInfo: actionInfo};
    }
    eventActionMap[eventName] = actionType;
S
sushuang 已提交
2137
}
P
pah100 已提交
2138

S
sushuang 已提交
2139 2140 2141 2142
/**
 * @param {string} type
 * @param {*} CoordinateSystem
 */
S
sushuang 已提交
2143
export function registerCoordinateSystem(type, CoordinateSystem) {
S
sushuang 已提交
2144
    CoordinateSystemManager.register(type, CoordinateSystem);
S
sushuang 已提交
2145
}
L
lang 已提交
2146

S
sushuang 已提交
2147 2148 2149 2150 2151
/**
 * Get dimensions of specified coordinate system.
 * @param {string} type
 * @return {Array.<string|Object>}
 */
S
sushuang 已提交
2152
export function getCoordinateSystemDimensions(type) {
S
sushuang 已提交
2153 2154 2155 2156 2157 2158
    var coordSysCreator = CoordinateSystemManager.get(type);
    if (coordSysCreator) {
        return coordSysCreator.getDimensionsInfo
                ? coordSysCreator.getDimensionsInfo()
                : coordSysCreator.dimensions.slice();
    }
S
sushuang 已提交
2159
}
2160

S
sushuang 已提交
2161 2162 2163 2164 2165 2166
/**
 * 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]
S
sushuang 已提交
2167
 * @param {Function} layoutTask
S
sushuang 已提交
2168
 */
S
sushuang 已提交
2169
export function registerLayout(priority, layoutTask) {
S
sushuang 已提交
2170
    normalizeRegister(visualFuncs, priority, layoutTask, PRIORITY_VISUAL_LAYOUT, 'layout');
S
sushuang 已提交
2171
}
P
pah100 已提交
2172

S
sushuang 已提交
2173 2174
/**
 * @param {number} [priority=3000]
S
sushuang 已提交
2175
 * @param {module:echarts/stream/Task} visualTask
S
sushuang 已提交
2176
 */
S
sushuang 已提交
2177
export function registerVisual(priority, visualTask) {
S
sushuang 已提交
2178
    normalizeRegister(visualFuncs, priority, visualTask, PRIORITY_VISUAL_CHART, 'visual');
S
sushuang 已提交
2179 2180
}

S
sushuang 已提交
2181
/**
2182
 * @param {Object|Function} fn: {seriesType, createOnAllSeries, performRawSeries, reset}
S
sushuang 已提交
2183
 */
S
sushuang 已提交
2184
function normalizeRegister(targetList, priority, fn, defaultPriority, visualType) {
S
sushuang 已提交
2185
    if (isFunction(priority) || isObject(priority)) {
S
sushuang 已提交
2186 2187
        fn = priority;
        priority = defaultPriority;
S
sushuang 已提交
2188
    }
S
sushuang 已提交
2189

S
sushuang 已提交
2190
    if (__DEV__) {
S
sushuang 已提交
2191 2192
        if (isNaN(priority) || priority == null) {
            throw new Error('Illegal priority');
2193
        }
S
sushuang 已提交
2194
        // Check duplicate
S
sushuang 已提交
2195
        each(targetList, function (wrap) {
S
sushuang 已提交
2196
            assert(wrap.__raw !== fn);
S
sushuang 已提交
2197
        });
S
sushuang 已提交
2198
    }
S
sushuang 已提交
2199

S
sushuang 已提交
2200 2201 2202 2203
    var stageHandler = Scheduler.wrapStageHandler(fn, visualType);

    stageHandler.__prio = priority;
    stageHandler.__raw = fn;
S
sushuang 已提交
2204
    targetList.push(stageHandler);
S
sushuang 已提交
2205

S
sushuang 已提交
2206
    return stageHandler;
S
sushuang 已提交
2207
}
S
sushuang 已提交
2208 2209 2210 2211

/**
 * @param {string} name
 */
S
sushuang 已提交
2212
export function registerLoading(name, loadingFx) {
S
sushuang 已提交
2213
    loadingEffects[name] = loadingFx;
S
sushuang 已提交
2214
}
S
sushuang 已提交
2215 2216 2217 2218 2219

/**
 * @param {Object} opts
 * @param {string} [superClass]
 */
S
sushuang 已提交
2220
export function extendComponentModel(opts/*, superClass*/) {
S
sushuang 已提交
2221 2222 2223 2224 2225 2226
    // var Clazz = ComponentModel;
    // if (superClass) {
    //     var classType = parseClassType(superClass);
    //     Clazz = ComponentModel.getClass(classType.main, classType.sub, true);
    // }
    return ComponentModel.extend(opts);
S
sushuang 已提交
2227
}
S
sushuang 已提交
2228 2229 2230 2231 2232

/**
 * @param {Object} opts
 * @param {string} [superClass]
 */
S
sushuang 已提交
2233
export function extendComponentView(opts/*, superClass*/) {
S
sushuang 已提交
2234 2235 2236 2237 2238 2239
    // var Clazz = ComponentView;
    // if (superClass) {
    //     var classType = parseClassType(superClass);
    //     Clazz = ComponentView.getClass(classType.main, classType.sub, true);
    // }
    return ComponentView.extend(opts);
S
sushuang 已提交
2240
}
S
sushuang 已提交
2241 2242 2243 2244 2245

/**
 * @param {Object} opts
 * @param {string} [superClass]
 */
S
sushuang 已提交
2246
export function extendSeriesModel(opts/*, superClass*/) {
S
sushuang 已提交
2247 2248 2249 2250 2251 2252 2253
    // 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);
S
sushuang 已提交
2254
}
S
sushuang 已提交
2255 2256 2257 2258 2259

/**
 * @param {Object} opts
 * @param {string} [superClass]
 */
S
sushuang 已提交
2260
export function extendChartView(opts/*, superClass*/) {
S
sushuang 已提交
2261 2262 2263 2264 2265 2266 2267
    // var Clazz = ChartView;
    // if (superClass) {
    //     superClass = superClass.replace('series.', '');
    //     var classType = parseClassType(superClass);
    //     Clazz = ChartView.getClass(classType.main, true);
    // }
    return ChartView.extend(opts);
S
sushuang 已提交
2268
}
S
sushuang 已提交
2269 2270 2271 2272 2273 2274 2275 2276 2277 2278 2279 2280 2281 2282 2283 2284 2285

/**
 * 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);
 *     });
 */
S
sushuang 已提交
2286
export function setCanvasCreator(creator) {
S
sushuang 已提交
2287 2288 2289 2290 2291
    zrUtil.$override('createCanvas', creator);
}

/**
 * @param {string} mapName
S
sushuang 已提交
2292
 * @param {Array.<Object>|Object|string} geoJson
S
sushuang 已提交
2293 2294
 * @param {Object} [specialAreas]
 *
S
sushuang 已提交
2295
 * @example GeoJSON
S
sushuang 已提交
2296 2297 2298 2299 2300 2301 2302 2303
 *     $.get('USA.json', function (geoJson) {
 *         echarts.registerMap('USA', geoJson);
 *         // Or
 *         echarts.registerMap('USA', {
 *             geoJson: geoJson,
 *             specialAreas: {}
 *         })
 *     });
S
sushuang 已提交
2304 2305 2306 2307 2308 2309 2310 2311 2312 2313 2314
 *
 *     $.get('airport.svg', function (svg) {
 *         echarts.registerMap('airport', {
 *             svg: svg
 *         }
 *     });
 *
 *     echarts.registerMap('eu', [
 *         {svg: eu-topographic.svg},
 *         {geoJSON: eu.json}
 *     ])
S
sushuang 已提交
2315 2316
 */
export function registerMap(mapName, geoJson, specialAreas) {
S
sushuang 已提交
2317
    mapDataStorage.registerMap(mapName, geoJson, specialAreas);
S
sushuang 已提交
2318 2319 2320 2321 2322 2323 2324
}

/**
 * @param {string} mapName
 * @return {Object}
 */
export function getMap(mapName) {
S
sushuang 已提交
2325 2326 2327 2328 2329 2330
    // For backward compatibility, only return the first one.
    var records = mapDataStorage.retrieveMap(mapName);
    return records && records[0] && {
        geoJson: records[0].geoJSON,
        specialAreas: records[0].specialAreas
    };
S
sushuang 已提交
2331
}
S
sushuang 已提交
2332

S
sushuang 已提交
2333 2334
registerVisual(PRIORITY_VISUAL_GLOBAL, seriesColor);
registerPreprocessor(backwardCompat);
S
sushuang 已提交
2335
registerProcessor(PRIORITY_PROCESSOR_STATISTIC, dataStack);
S
sushuang 已提交
2336
registerLoading('default', loadingDefault);
S
sushuang 已提交
2337

S
sushuang 已提交
2338 2339
// Default actions

S
sushuang 已提交
2340
registerAction({
S
sushuang 已提交
2341 2342 2343 2344
    type: 'highlight',
    event: 'highlight',
    update: 'highlight'
}, zrUtil.noop);
S
sushuang 已提交
2345

S
sushuang 已提交
2346
registerAction({
S
sushuang 已提交
2347 2348 2349 2350 2351
    type: 'downplay',
    event: 'downplay',
    update: 'downplay'
}, zrUtil.noop);

P
pissang 已提交
2352 2353 2354
// Default theme
registerTheme('light', lightTheme);
registerTheme('dark', darkTheme);
S
sushuang 已提交
2355

S
sushuang 已提交
2356 2357 2358
// For backward compatibility, where the namespace `dataTool` will
// be mounted on `echarts` is the extension `dataTool` is imported.
export var dataTool = {};