/**
 *  事件对象
 *  bubbles  表示事件是否通过DOM已冒泡形式触发
 *
 *  button  如果有鼠标按下的按钮
 *
 *  altKey  Alt键
 *
 *  shiftKey shift
 *
 *  meate Meate
 *
 *  isChar 当前按下的键是否标示一个字符
 *
 *  charCode unicode值 (仅对keypress)
 *
 *  keyCode 非unicode
 *
 *  which
 *
 *  pageX,pageY  事件发生时相对于页面(viewprot) 的坐标
 *
 *  screenX screeY
 *
 *  currentTarget  当前DOM元素
 *
 *  target ,originalTarget 原始的DOM元素
 *
 *  relatedTarge 其他和事件相关的DOM元素
 *
 * **/

var Events = Backbone.Events = {

    /**
     * 绑定 callback 函数到 object 对象。 当事件触发时执行回调函数 callback 。
     * 如果一个页面中有大量不同的事件，按照惯例使用冒号指定命名空间
     * ： "poll:start", 或 "change:selection"
     * */
    on:function (events, callback, context) {
        var calls, event, list;
        if (!callback) return this;

        events = events.split(eventSplitter);

        calls = this._callbacks || (this._callbacks = {});
        //保存回调函数,与事件 到对象的_callbacks上
        while (event = events.shift()) {
            //取出每个事件名放到_callbacks作用对象的属性，然后把回调函数push到这个数组中
            list = calls[event] || (calls[event] = []);
            list.push(callback, context);
        }

        return this;
    },

    /**
     * 删除一个或许多回调。如果“上下文”是null,删除所有的回调　　
     * 与功能。如果“回调”是null,删除所有的回调　
     * 事件。如果“事件”是null,移除所有绑定回所有事件
     *
     * object.unbind("change", onChange);  只移除onChange回调函数
     *  object.unbind("change");           移除所有 "change" 回调函数
     * object.unbind();                    移除对象的所有回调函数
     *
     * **/
    off:function (events, callback, context) {
        var event, calls, list, i;

        // No events, or removing *all* events.
        if (!(calls = this._callbacks)) return this;
        if (!(events || callback || context)) {
            delete this._callbacks;
            return this;
        }

        events = events ? events.split(eventSplitter) : _.keys(calls);

        // Loop through the callback list, splicing where appropriate.
        while (event = events.shift()) {
            if (!(list = calls[event]) || !(callback || context)) {
                delete calls[event];
                continue;
            }

            for (i = list.length - 2; i >= 0; i -= 2) {
                if (!(callback && list[i] !== callback || context && list[i + 1] !== context)) {
                    list.splice(i, 2);
                }
            }
        }

        return this;
    },

    /**
     * / /触发一个或许多事件,解雇所有绑定回调。回调是　　
     * / /通过相同的参数作为“触发”是,除了事件的名字　　
     * / /(除非你监听的“所有”,这将导致你的回调　　
     * / /接收真实的事件名称作为第一个参数)。
     * **/
    trigger:function (events) {
        var event, calls, list, i, length, args, all, rest;
        if (!(calls = this._callbacks)) return this;

        rest = [];
        //事件分解
        events = events.split(eventSplitter);

        // Fill up `rest` with the callback arguments.  Since we're only copying
        // the tail of `arguments`, a loop is much faster than Array#slice.
        for (i = 1, length = arguments.length; i < length; i++) {
            rest[i - 1] = arguments[i];
        }

        // For each event, walk through the list of callbacks twice, first to
        // trigger the event, then to trigger any `"all"` callbacks.
        while (event = events.shift()) {
            //复制回调列表来防止修改
            if (all = calls.all) all = all.slice();
            if (list = calls[event]) list = list.slice();

            // 执行事件回调
            if (list) {
                for (i = 0, length = list.length; i < length; i += 2) {
                    list[i].apply(list[i + 1] || this, rest);
                }
            }

            // 执行 "all" 回调.
            if (all) {
                args = [event].concat(rest);
                for (i = 0, length = all.length; i < length; i += 2) {
                    all[i].apply(all[i + 1] || this, args);
                }
            }
        }

        return this;
    }

};