add extjs 6.0.1 sources

[extjs.git] / extjs / classic / classic / overrides / event / Event.js

/**\r
 *\r
 */\r
Ext.define('Ext.overrides.event.Event', {\r
    override: 'Ext.event.Event',\r
\r
    // map of events that should fire global mousedown even if stopped\r
    mousedownEvents: {\r
        mousedown: 1,\r
        pointerdown: 1,\r
        touchstart: 1\r
    },\r
\r
    /**\r
     * @method injectEvent\r
     * @member Ext.event.Event\r
     * Injects a DOM event using the data in this object and (optionally) a new target.\r
     * This is a low-level technique and not likely to be used by application code. The\r
     * currently supported event types are:\r
     * <p><b>HTMLEvents</b></p>\r
     * <ul>\r
     * <li>load</li>\r
     * <li>unload</li>\r
     * <li>select</li>\r
     * <li>change</li>\r
     * <li>submit</li>\r
     * <li>reset</li>\r
     * <li>resize</li>\r
     * <li>scroll</li>\r
     * </ul>\r
     * <p><b>MouseEvents</b></p>\r
     * <ul>\r
     * <li>click</li>\r
     * <li>dblclick</li>\r
     * <li>mousedown</li>\r
     * <li>mouseup</li>\r
     * <li>mouseover</li>\r
     * <li>mousemove</li>\r
     * <li>mouseout</li>\r
     * </ul>\r
     * <p><b>UIEvents</b></p>\r
     * <ul>\r
     * <li>focusin</li>\r
     * <li>focusout</li>\r
     * <li>activate</li>\r
     * <li>focus</li>\r
     * <li>blur</li>\r
     * </ul>\r
     * @param {Ext.Element/HTMLElement} target (optional) If specified, the target for the event. This\r
     * is likely to be used when relaying a DOM event. If not specified, {@link #getTarget}\r
     * is used to determine the target.\r
     */\r
    injectEvent: (function () {\r
        var API,\r
            dispatchers = {}, // keyed by event type (e.g., 'mousedown')\r
            crazyIEButtons;\r
\r
        // Good reference: http://developer.yahoo.com/yui/docs/UserAction.js.html\r
\r
        // IE9 has createEvent, but this code causes major problems with htmleditor (it\r
        // blocks all mouse events and maybe more). TODO\r
\r
        if (!Ext.isIE9m && document.createEvent) { // if (DOM compliant)\r
            API = {\r
                createHtmlEvent: function (doc, type, bubbles, cancelable) {\r
                    var event = doc.createEvent('HTMLEvents');\r
\r
                    event.initEvent(type, bubbles, cancelable);\r
                    return event;\r
                },\r
\r
                createMouseEvent: function (doc, type, bubbles, cancelable, detail,\r
                                            clientX, clientY, ctrlKey, altKey, shiftKey, metaKey,\r
                                            button, relatedTarget) {\r
                    var event = doc.createEvent('MouseEvents'),\r
                        view = doc.defaultView || window;\r
\r
                    if (event.initMouseEvent) {\r
                        event.initMouseEvent(type, bubbles, cancelable, view, detail,\r
                                    clientX, clientY, clientX, clientY, ctrlKey, altKey,\r
                                    shiftKey, metaKey, button, relatedTarget);\r
                    } else { // old Safari\r
                        event = doc.createEvent('UIEvents');\r
                        event.initEvent(type, bubbles, cancelable);\r
                        event.view = view;\r
                        event.detail = detail;\r
                        event.screenX = clientX;\r
                        event.screenY = clientY;\r
                        event.clientX = clientX;\r
                        event.clientY = clientY;\r
                        event.ctrlKey = ctrlKey;\r
                        event.altKey = altKey;\r
                        event.metaKey = metaKey;\r
                        event.shiftKey = shiftKey;\r
                        event.button = button;\r
                        event.relatedTarget = relatedTarget;\r
                    }\r
\r
                    return event;\r
                },\r
\r
                createUIEvent: function (doc, type, bubbles, cancelable, detail) {\r
                    var event = doc.createEvent('UIEvents'),\r
                        view = doc.defaultView || window;\r
\r
                    event.initUIEvent(type, bubbles, cancelable, view, detail);\r
                    return event;\r
                },\r
\r
                fireEvent: function (target, type, event) {\r
                    target.dispatchEvent(event);\r
                }\r
            };\r
        } else if (document.createEventObject) { // else if (IE)\r
            crazyIEButtons = { 0: 1, 1: 4, 2: 2 };\r
\r
            API = {\r
                createHtmlEvent: function (doc, type, bubbles, cancelable) {\r
                    var event = doc.createEventObject();\r
                    event.bubbles = bubbles;\r
                    event.cancelable = cancelable;\r
                    return event;\r
                },\r
\r
                createMouseEvent: function (doc, type, bubbles, cancelable, detail,\r
                                            clientX, clientY, ctrlKey, altKey, shiftKey, metaKey,\r
                                            button, relatedTarget) {\r
                    var event = doc.createEventObject();\r
                    event.bubbles = bubbles;\r
                    event.cancelable = cancelable;\r
                    event.detail = detail;\r
                    event.screenX = clientX;\r
                    event.screenY = clientY;\r
                    event.clientX = clientX;\r
                    event.clientY = clientY;\r
                    event.ctrlKey = ctrlKey;\r
                    event.altKey = altKey;\r
                    event.shiftKey = shiftKey;\r
                    event.metaKey = metaKey;\r
                    event.button = crazyIEButtons[button] || button;\r
                    event.relatedTarget = relatedTarget; // cannot assign to/fromElement\r
                    return event;\r
                },\r
\r
                createUIEvent: function (doc, type, bubbles, cancelable, detail) {\r
                    var event = doc.createEventObject();\r
                    event.bubbles = bubbles;\r
                    event.cancelable = cancelable;\r
                    return event;\r
                },\r
\r
                fireEvent: function (target, type, event) {\r
                    target.fireEvent('on' + type, event);\r
                }\r
            };\r
        }\r
\r
        //----------------\r
        // HTMLEvents\r
\r
        Ext.Object.each({\r
                load:   [false, false],\r
                unload: [false, false],\r
                select: [true, false],\r
                change: [true, false],\r
                submit: [true, true],\r
                reset:  [true, false],\r
                resize: [true, false],\r
                scroll: [true, false]\r
            },\r
            function (name, value) {\r
                var bubbles = value[0], cancelable = value[1];\r
                dispatchers[name] = function (targetEl, srcEvent) {\r
                    var e = API.createHtmlEvent(name, bubbles, cancelable);\r
                    API.fireEvent(targetEl, name, e);\r
                };\r
            });\r
\r
        //----------------\r
        // MouseEvents\r
\r
        function createMouseEventDispatcher (type, detail) {\r
            var cancelable = (type !== 'mousemove');\r
            return function (targetEl, srcEvent) {\r
                var xy = srcEvent.getXY(),\r
                    e = API.createMouseEvent(targetEl.ownerDocument, type, true, cancelable,\r
                                detail, xy[0], xy[1], srcEvent.ctrlKey, srcEvent.altKey,\r
                                srcEvent.shiftKey, srcEvent.metaKey, srcEvent.button,\r
                                srcEvent.relatedTarget);\r
                API.fireEvent(targetEl, type, e);\r
            };\r
        }\r
\r
        Ext.each(['click', 'dblclick', 'mousedown', 'mouseup', 'mouseover', 'mousemove', 'mouseout'],\r
            function (eventName) {\r
                dispatchers[eventName] = createMouseEventDispatcher(eventName, 1);\r
            });\r
\r
        //----------------\r
        // UIEvents\r
\r
        Ext.Object.each({\r
                focusin:  [true, false],\r
                focusout: [true, false],\r
                activate: [true, true],\r
                focus:    [false, false],\r
                blur:     [false, false]\r
            },\r
            function (name, value) {\r
                var bubbles = value[0], cancelable = value[1];\r
                dispatchers[name] = function (targetEl, srcEvent) {\r
                    var e = API.createUIEvent(targetEl.ownerDocument, name, bubbles, cancelable, 1);\r
                    API.fireEvent(targetEl, name, e);\r
                };\r
            });\r
\r
        //---------\r
        if (!API) {\r
            // not even sure what ancient browsers fall into this category...\r
\r
            dispatchers = {}; // never mind all those we just built :P\r
\r
            API = {};\r
        }\r
\r
        function cannotInject (target, srcEvent) {\r
            //<debug>\r
            // TODO log something\r
            //</debug>\r
        }\r
\r
        return function (target) {\r
            var me = this,\r
                dispatcher = dispatchers[me.type] || cannotInject,\r
                t = target ? (target.dom || target) : me.getTarget();\r
\r
            dispatcher(t, me);\r
        };\r
    }()), // call to produce method\r
\r
    preventDefault: function() {\r
        var me = this,\r
            event = me.browserEvent,\r
            parentEvent = me.parentEvent,\r
            unselectable, target;\r
\r
\r
        // This check is for IE8/9. The event object may have been\r
        // invalidated, so we can't delve into the details of it. If so,\r
        // just fall out gracefully and don't attempt to do anything.\r
        if (typeof event.type !== 'unknown') {\r
            me.defaultPrevented = true;\r
\r
            // if the event was created by prototype-chaining a new object to an existing event\r
            // instance, we need to make sure the parent event is defaultPrevented as well.\r
            if (parentEvent) {\r
                parentEvent.defaultPrevented = true;\r
            }\r
\r
            if (event.preventDefault) {\r
                event.preventDefault();\r
            } else {\r
                // The purpose of the code below is for preventDefault to stop focus from\r
                // occurring like it does in other modern browsers. This only happens in\r
                // IE8/9 when using attachEvent. The use of unselectable seems the most reliable\r
                // way to prevent this from happening. We need to use a timeout to restore the\r
                // unselectable state because if we don't setting it has no effect. It's important\r
                // to set the atrribute to 'on' as opposed to just setting the property on the DOM element.\r
                // See the link below for a discussion on the issue:\r
                // http://bugs.jquery.com/ticket/10345\r
                if (event.type === 'mousedown') {\r
                    target = event.target;\r
                    unselectable = target.getAttribute('unselectable');\r
                    if (unselectable !== 'on') {\r
                        target.setAttribute('unselectable', 'on');\r
                        Ext.defer(function() {\r
                            target.setAttribute('unselectable', unselectable);\r
                        }, 1);\r
                    }\r
                }\r
                // IE9 and earlier do not support preventDefault\r
                event.returnValue = false;\r
                // Some keys events require setting the keyCode to -1 to be prevented\r
                // all ctrl + X and F1 -> F12\r
                if (event.ctrlKey || event.keyCode > 111 && event.keyCode < 124) {\r
                    event.keyCode = -1;\r
                }\r
            }\r
        }\r
\r
        return me;\r
    },\r
\r
    stopPropagation: function() {\r
        var me = this,\r
            event = me.browserEvent;\r
\r
        // This check is for IE8/9. The event object may have been\r
        // invalidated, so we can't delve into the details of it. If so,\r
        // just fall out gracefully and don't attempt to do anything.\r
        if (typeof event.type !== 'unknown') {\r
            if (me.mousedownEvents[me.type]) {\r
                // Fire the "unstoppable" global mousedown event\r
                // (used for menu hiding, etc)\r
                Ext.GlobalEvents.fireMouseDown(me);\r
            }\r
            me.callParent();\r
        }\r
        return me;\r
    },\r
\r
    deprecated: {\r
        '5.0': {\r
            methods: {\r
                /**\r
                 * @method clone\r
                 * @member Ext.event.Event\r
                 * Clones this event.\r
                 * @return {Ext.event.Event} The cloned copy\r
                 * @deprecated 5.0.0\r
                 */\r
                clone: function() {\r
                    return new this.self(this.browserEvent, this);\r
                }\r
            }\r
        }\r
    }\r
}, function() {\r
    var Event = this,\r
        btnMap,\r
        onKeyDown = function(e) {\r
            if (e.keyCode === 9) {\r
                Event.forwardTab = !e.shiftKey;\r
            }\r
        },\r
        onKeyUp = function(e) {\r
            if (e.keyCode === 9) {\r
                delete Event.forwardTab;\r
            }\r
        };\r
\r
//<feature legacyBrowser>\r
    if (Ext.isIE9m) {\r
        btnMap = {\r
            0: 0,\r
            1: 0,\r
            4: 1,\r
            2: 2\r
        };\r
\r
        Event.override({\r
            statics: {\r
                /**\r
                 * @member Ext.event.Event\r
                 * When events are attached using IE's attachEvent API instead of\r
                 * addEventListener accessing any members of an event object asynchronously\r
                 * results in "Member not found" error.  To work around this we fabricate\r
                 * our own event object by copying all of its members to a new object.\r
                 * @param {Event} browserEvent The native browser event object\r
                 * @private\r
                 * @static\r
                 */\r
                enableIEAsync: function(browserEvent) {\r
                    var name,\r
                        fakeEvent = {};\r
\r
                    for (name in browserEvent) {\r
                        fakeEvent[name] = browserEvent[name];\r
                    }\r
\r
                    return fakeEvent;\r
                }\r
            },\r
\r
            constructor: function(event, info, touchesMap, identifiers) {\r
                var me = this;\r
                me.callParent([event, info, touchesMap, identifiers]);\r
                me.button = btnMap[event.button];\r
\r
                if (event.type === 'contextmenu') {\r
                    me.button = 2; // IE8/9 reports click as 0, so we can at least attempt to infer here\r
                }   \r
\r
                // IE8 can throw an error when trying to access properties on a browserEvent\r
                // object when the event has been buffered or delayed.  Cache them here\r
                // so we can access them later.\r
                me.toElement = event.toElement;\r
                me.fromElement = event.fromElement;\r
            },\r
\r
            mouseLeaveRe: /(mouseout|mouseleave)/,\r
            mouseEnterRe: /(mouseover|mouseenter)/,\r
\r
            /**\r
             * @member Ext.event.Event\r
             * @inheritdoc Ext.event.Event#static-enableIEAsync\r
             * @private\r
             */\r
            enableIEAsync: function(browserEvent) {\r
                this.browserEvent = this.self.enableIEAsync(browserEvent);\r
            },\r
\r
            getRelatedTarget: function(selector, maxDepth, returnEl) {\r
                var me = this,\r
                    type, target;\r
\r
                if (!me.relatedTarget) {\r
                    type = me.type;\r
                    if (me.mouseLeaveRe.test(type)) {\r
                        target = me.toElement;\r
                    } else if (me.mouseEnterRe.test(type)) {\r
                        target = me.fromElement;\r
                    }\r
                    if (target) {\r
                        me.relatedTarget = me.self.resolveTextNode(target);\r
                    }\r
                }\r
\r
                return me.callParent([selector, maxDepth, returnEl]);\r
            }\r
        });\r
\r
        // We place these listeners to capture Tab and Shift-Tab key strokes\r
        // and pass this information in the focus/blur event if it happens\r
        // between keydown/keyup pair.\r
        document.attachEvent('onkeydown', onKeyDown);\r
        document.attachEvent('onkeyup',   onKeyUp);\r
        \r
        window.attachEvent('onunload', function() {\r
            document.detachEvent('onkeydown', onKeyDown);\r
            document.detachEvent('onkeyup',   onKeyUp);\r
        });\r
    }\r
    else\r
//</feature>\r
    if (document.addEventListener) {\r
        document.addEventListener('keydown', onKeyDown, true);\r
        document.addEventListener('keyup',   onKeyUp,   true);\r
    }\r
});\r