3 * Copyright(c) 2006-2009 Ext JS, LLC
5 * http://www.extjs.com/license
8 * @class Ext.dd.Registry
\r
9 * Provides easy access to all drag drop components that are registered on a page. Items can be retrieved either
\r
10 * directly by DOM node id, or by passing in the drag drop event that occurred and looking up the event target.
\r
13 Ext.dd.Registry = function(){
\r
18 var getId = function(el, autogen){
\r
19 if(typeof el == "string"){
\r
23 if(!id && autogen !== false){
\r
24 id = "extdd-" + (++autoIdSeed);
\r
32 * Resgister a drag drop element
\r
33 * @param {String/HTMLElement) element The id or DOM node to register
\r
34 * @param {Object} data (optional) An custom data object that will be passed between the elements that are involved
\r
35 * in drag drop operations. You can populate this object with any arbitrary properties that your own code
\r
36 * knows how to interpret, plus there are some specific properties known to the Registry that should be
\r
37 * populated in the data object (if applicable):
\r
39 Value Description<br />
\r
40 --------- ------------------------------------------<br />
\r
41 handles Array of DOM nodes that trigger dragging<br />
\r
42 for the element being registered<br />
\r
43 isHandle True if the element passed in triggers<br />
\r
44 dragging itself, else false
\r
47 register : function(el, data){
\r
49 if(typeof el == "string"){
\r
50 el = document.getElementById(el);
\r
53 elements[getId(el)] = data;
\r
54 if(data.isHandle !== false){
\r
55 handles[data.ddel.id] = data;
\r
58 var hs = data.handles;
\r
59 for(var i = 0, len = hs.length; i < len; i++){
\r
60 handles[getId(hs[i])] = data;
\r
66 * Unregister a drag drop element
\r
67 * @param {String/HTMLElement) element The id or DOM node to unregister
\r
69 unregister : function(el){
\r
70 var id = getId(el, false);
\r
71 var data = elements[id];
\r
73 delete elements[id];
\r
75 var hs = data.handles;
\r
76 for(var i = 0, len = hs.length; i < len; i++){
\r
77 delete handles[getId(hs[i], false)];
\r
84 * Returns the handle registered for a DOM Node by id
\r
85 * @param {String/HTMLElement} id The DOM node or id to look up
\r
86 * @return {Object} handle The custom handle data
\r
88 getHandle : function(id){
\r
89 if(typeof id != "string"){ // must be element?
\r
96 * Returns the handle that is registered for the DOM node that is the target of the event
\r
97 * @param {Event} e The event
\r
98 * @return {Object} handle The custom handle data
\r
100 getHandleFromEvent : function(e){
\r
101 var t = Ext.lib.Event.getTarget(e);
\r
102 return t ? handles[t.id] : null;
\r
106 * Returns a custom data object that is registered for a DOM node by id
\r
107 * @param {String/HTMLElement} id The DOM node or id to look up
\r
108 * @return {Object} data The custom data
\r
110 getTarget : function(id){
\r
111 if(typeof id != "string"){ // must be element?
\r
114 return elements[id];
\r
118 * Returns a custom data object that is registered for the DOM node that is the target of the event
\r
119 * @param {Event} e The event
\r
120 * @return {Object} data The custom data
\r
122 getTargetFromEvent : function(e){
\r
123 var t = Ext.lib.Event.getTarget(e);
\r
124 return t ? elements[t.id] || handles[t.id] : null;
\r