ECharts 3.0底层zrender 3.x源码分析3-Handler（C层）

这一篇，介绍下Handler处理机制。

Handler负责事件处理,包括’click’, ‘dblclick’, ‘mousewheel’, ‘mouseout’, ‘mouseup’, ‘mousedown’, ‘mousemove’, ‘contextmenu’等。我们知道canvas API没有提供监听每个元素的机制，这就需要一些处理。处理的思路是：监听事件的作用坐标（如点击时候的坐标），判断在哪个绘制元素的范围中，如果在某个元素中，这个元素就监听该事件。

一些demo和没有在博客中介绍的源码请进我的github仓库。

https://github.com/zrysmt/echarts3/tree/master/zrender

1.Handle.js整体

同样Handle.js文件的结构是一个构造函数，一个prototype扩展原型，一些混入模式。

我们首先看在入口（zrender.js）中的调用

var handerProxy = !env.node ? new HandlerProxy(painter.getViewportRoot()) : null;//env.node默认为false//HandlerProxy 是移动端的一些处理事件this.handler = new Handler(storage, painter, handerProxy, painter.root);

构造函数：

var Handler = function(storage, painter, proxy, painterRoot) {        Eventful.call(this);        this.storage = storage;        this.painter = painter;        this.painterRoot = painterRoot;        proxy = proxy || new EmptyProxy();        /**         * Proxy of event. can be Dom, WebGLSurface, etc.         */        this.proxy = proxy;        // Attach handler        proxy.handler = this;        this._hovered;        /**         * @private         * @type {Date}         */        this._lastTouchMoment;        this._lastX;//坐标位置x        this._lastY;//坐标位置y        Draggable.call(this);        util.each(handlerNames, function (name) {            proxy.on && proxy.on(name, this[name], this);        }, this);    };

构造函数中保留的有坐标信息。

prototype中的一个重要的方法dispatchToElement,针对目标图形元素触发事件。

/** * 事件分发代理 * * @private * @param {Object} targetEl 目标图形元素 * @param {string} eventName 事件名称 * @param {Object} event 事件对象 */dispatchToElement: function(targetEl, eventName, event) {    var eventHandler = 'on' + eventName;    var eventPacket = makeEventPacket(eventName, targetEl, event);    var el = targetEl;    while (el) {        el[eventHandler] && (eventPacket.cancelBubble = el[eventHandler].call(el, eventPacket));        el.trigger(eventName, eventPacket);//触发        el = el.parent;        if (eventPacket.cancelBubble) {            break;        }    }    if (!eventPacket.cancelBubble) {        // 冒泡到顶级 zrender 对象        this.trigger(eventName, eventPacket);        // 分发事件到用户自定义层        // 用户有可能在全局 click 事件中 dispose，所以需要判断下 painter 是否存在        this.painter && this.painter.eachOtherLayer(function(layer) {            if (typeof(layer[eventHandler]) == 'function') {                layer[eventHandler].call(layer, eventPacket);            }            if (layer.trigger) {                layer.trigger(eventName, eventPacket);//触发            }        });    }}

混入Eventful(发布订阅模式事件)、Draggable（拖动事件）

util.mixin(Handler, Eventful);util.mixin(Handler, Draggable);

2.canvas上元素的监听事件

对于一些事件的处理（Handler.js）

 util.each(['click', 'mousedown', 'mouseup', 'mousewheel', 'dblclick', 'contextmenu'], function (name) {        Handler.prototype[name] = function (event) {            // Find hover again to avoid click event is dispatched manually. Or click is triggered without mouseover            var hovered = this.findHover(event.zrX, event.zrY, null);            if (name === 'mousedown') {                this._downel = hovered;                // In case click triggered before mouseup                this._upel = hovered;            }            else if (name === 'mosueup') {                this._upel = hovered;            }            else if (name === 'click') {                if (this._downel !== this._upel) {                    return;                }            }            console.info("hovered:",hovered);            console.info(this);            this.dispatchToElement(hovered, name, event);        };    });

我们在其中打印了this，通过demo/demo1/demo3-chartHasHover.html的例子我们可以发现，点击的时候都会打印this，而且打印3次。

通过打印的hovered，我们可以看出来hovered就是我们点击的对象。

findHover调用的是isHover函数，在isHover函数中通过displayable（Displayable.js）的contain或者rectContain判断点在哪个元素中。

function isHover(displayable, x, y) {    if (displayable[displayable.rectHover ? 'rectContain' : 'contain'](x, y)) {        var el = displayable;        while (el) {            // If ancestor is silent or clipped by ancestor            if (el.silent || (el.clipPath && !el.clipPath.contain(x, y))) {                return false;            }            el = el.parent;        }        return true;    }    return false;}

Displayable.js的contain或者rectContain方法都是调用rectContain方法，判断x,y是否在图形的包围盒上。

rectContain: function(x, y) {    var coord = this.transformCoordToLocal(x, y);    var rect = this.getBoundingRect();//@module zrender/core/BoundingRect    return rect.contain(coord[0], coord[1]);}

zrender/core/BoundingRect的contain方法

 contain: function(x, y) {     var rect = this;     return x >= rect.x && x <= (rect.x + rect.width) &&      y >= rect.y && y <= (rect.y + rect.height); }

我们再来看看，在painter.js中，其实已经为每个元素生成了它的包围盒上。

 var tmpRect = new BoundingRect(0, 0, 0, 0); var viewRect = new BoundingRect(0, 0, 0, 0); function isDisplayableCulled(el, width, height) {     tmpRect.copy(el.getBoundingRect());     if (el.transform) {         tmpRect.applyTransform(el.transform);     }     viewRect.width = width;     viewRect.height = height;     return !tmpRect.intersect(viewRect); }

在绘制每个元素的时候,在_doPaintEl方法中调用了isDisplayableCulled。

参考阅读：
- canvas-mdn教程
- canvas基本的动画-mdn