/** * A simple class that provides the basic implementation needed to make any element a drop target that can have * draggable items dropped onto it. The drop has no effect until an implementation of notifyDrop is provided. */Ext.define('Ext.dd.DropTarget', { extend: 'Ext.dd.DDTarget', requires: ['Ext.dd.ScrollManager'], /** * Creates new DropTarget. * @param {String/HTMLElement/Ext.dom.Element} el The container element or ID of it. * @param {Object} config */ constructor : function(el, config){ this.el = Ext.get(el); Ext.apply(this, config); if(this.containerScroll){ Ext.dd.ScrollManager.register(this.el); } this.callParent([this.el.dom, this.ddGroup || this.group, {isTarget: true}]); }, /** * @cfg {Boolean} containerScroll * True to register this container with the ScrollManager for auto scrolling during * drag operations. */ containerScroll: false, /** * @cfg {String} ddGroup * A named drag drop group to which this object belongs. If a group is specified, then this object will only * interact with other drag drop objects in the same group. */ /** * @cfg {String} [overClass=""] * The CSS class applied to the drop target element while the drag source is over it. */ /** * @cfg {String} dropAllowed * The CSS class returned to the drag source when drop is allowed. */ dropAllowed : Ext.baseCSSPrefix + 'dd-drop-ok', /** * @cfg {String} dropNotAllowed * The CSS class returned to the drag source when drop is not allowed. */ dropNotAllowed : Ext.baseCSSPrefix + 'dd-drop-nodrop', /** * @private */ isTarget : true, /** * @private */ isNotifyTarget : true, /** * The function a {@link Ext.dd.DragSource} calls once to notify this drop target that the source is now over the * target. This default implementation adds the CSS class specified by overClass (if any) to the drop element * and returns the dropAllowed config value. This method should be overridden if drop validation is required. * @param {Ext.dd.DragSource} source The drag source that was dragged over this drop target * @param {Event} e The event * @param {Object} data An object containing arbitrary data supplied by the drag source * @return {String} status The CSS class that communicates the drop status back to the source so that the * underlying {@link Ext.dd.StatusProxy} can be updated * @template */ notifyEnter : function(source, e, data){ if(this.overClass){ this.el.addCls(this.overClass); } return this.dropAllowed; }, /** * The function a {@link Ext.dd.DragSource} calls continuously while it is being dragged over the target. * This method will be called on every mouse movement while the drag source is over the drop target. * This default implementation simply returns the dropAllowed config value. * @param {Ext.dd.DragSource} source The drag source that was dragged over this drop target * @param {Event} e The event * @param {Object} data An object containing arbitrary data supplied by the drag source * @return {String} status The CSS class that communicates the drop status back to the source so that the * underlying {@link Ext.dd.StatusProxy} can be updated * @template */ notifyOver : function(source, e, data){ return this.dropAllowed; }, /** * The function a {@link Ext.dd.DragSource} calls once to notify this drop target that the source has been dragged * out of the target without dropping. This default implementation simply removes the CSS class specified by * `overClass` (if any) from the drop element. * @param {Ext.dd.DragSource} source The drag source that was dragged over this drop target * @param {Event} e The event * @param {Object} data An object containing arbitrary data supplied by the drag source * @template */ notifyOut : function(source, e, data){ if (this.overClass){ this.el.removeCls(this.overClass); } }, /** * The function a {@link Ext.dd.DragSource} calls once to notify this drop target that the dragged item has * been dropped on it. This method removes any `overClass` and returns false, so you must provide an * implementation that does something to process the drop event and returns true so that the drag source's * repair action does not run. * * You should `callParent` from an override of this method to ensure proper cleanup is * performed. * * @param {Ext.dd.DragSource} source The drag source that was dragged over this drop target * @param {Event} e The event * @param {Object} data An object containing arbitrary data supplied by the drag source * @return {Boolean} False if the drop was invalid. * @template */ notifyDrop : function(source, e, data){ if (this.overClass){ this.el.removeCls(this.overClass); } return false; }, destroy: function() { if (this.containerScroll) { Ext.dd.ScrollManager.unregister(this.el); } this.callParent(); }});