add extjs 6.0.1 sources

[extjs.git] / extjs / classic / classic / src / dd / Registry.js

/**\r
 * Provides easy access to all drag drop components that are registered on a page. Items can be retrieved either\r
 * directly by DOM node id, or by passing in the drag drop event that occurred and looking up the event target.\r
 */\r
Ext.define('Ext.dd.Registry', {\r
    singleton: true,\r
    constructor: function() {\r
        this.elements = {}; \r
        this.handles = {}; \r
        this.autoIdSeed = 0;\r
    },\r
    \r
    getId: function(el, autogen){\r
        if (typeof el === "string") {\r
            return el;\r
        }\r
        var id = el.id;\r
        if (!id && autogen !== false) {\r
            id = "extdd-" + (++this.autoIdSeed);\r
            el.id = id;\r
        }\r
        return id;\r
    },\r
    \r
    /**\r
     * Registers a drag drop element.\r
     *\r
     * @param {String/HTMLElement} element The id or DOM node to register\r
     * @param {Object} data An custom data object that will be passed between the elements that are involved in drag\r
     * drop operations. You can populate this object with any arbitrary properties that your own code knows how to\r
     * interpret, plus there are some specific properties known to the Registry that should be populated in the data\r
     * object (if applicable):\r
     * @param {HTMLElement[]} data.handles Array of DOM nodes that trigger dragging for the element being registered.\r
     * @param {Boolean} data.isHandle True if the element passed in triggers dragging itself, else false.\r
     */\r
    register : function(el, data){\r
        data = data || {};\r
        if (typeof el === "string") {\r
            el = document.getElementById(el);\r
        }\r
        data.ddel = el;\r
        this.elements[this.getId(el)] = data;\r
        if (data.isHandle !== false) {\r
            this.handles[data.ddel.id] = data;\r
        }\r
        if (data.handles) {\r
            var hs = data.handles,\r
                i, len;\r
            for (i = 0, len = hs.length; i < len; i++) {\r
                this.handles[this.getId(hs[i])] = data;\r
            }\r
        }\r
    },\r
\r
    /**\r
     * Unregister a drag drop element\r
     * @param {String/HTMLElement} element The id or DOM node to unregister\r
     */\r
    unregister : function(el){\r
        var id = this.getId(el, false),\r
            data = this.elements[id],\r
            hs, i, len;\r
        if(data){\r
            delete this.elements[id];\r
            if(data.handles){\r
                hs = data.handles;\r
                for (i = 0, len = hs.length; i < len; i++) {\r
                    delete this.handles[this.getId(hs[i], false)];\r
                }\r
            }\r
        }\r
    },\r
\r
    /**\r
     * Returns the handle registered for a DOM Node by id\r
     * @param {String/HTMLElement} id The DOM node or id to look up\r
     * @return {Object} handle The custom handle data\r
     */\r
    getHandle : function(id){\r
        if(typeof id !== "string"){ // must be element?\r
            id = id.id;\r
        }\r
        return this.handles[id];\r
    },\r
\r
    /**\r
     * Returns the handle that is registered for the DOM node that is the target of the event\r
     * @param {Event} e The event\r
     * @return {Object} handle The custom handle data\r
     */\r
    getHandleFromEvent : function(e){\r
        var t = e.getTarget();\r
        return t ? this.handles[t.id] : null;\r
    },\r
\r
    /**\r
     * Returns a custom data object that is registered for a DOM node by id\r
     * @param {String/HTMLElement} id The DOM node or id to look up\r
     * @return {Object} data The custom data\r
     */\r
    getTarget : function(id){\r
        if (typeof id !== "string") { // must be element?\r
            id = id.id;\r
        }\r
        return this.elements[id];\r
    },\r
\r
    /**\r
     * Returns a custom data object that is registered for the DOM node that is the target of the event\r
     * @param {Event} e The event\r
     * @return {Object} data The custom data\r
     */\r
    getTargetFromEvent : function(e){\r
        var t = e.getTarget();\r
        return t ? this.elements[t.id] || this.handles[t.id] : null;\r
    }\r
});