dd-plugin.js revision 9eb94626cedb24875edf2f541cdceb32c6a96046
9bff67898d55cddfcec9ce30cc2b1bb6211ec691David LawrenceYUI.add('dd-plugin', function(Y) {
9bff67898d55cddfcec9ce30cc2b1bb6211ec691David Lawrence
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence
9c3531d72aeaad6c5f01efe6a1c82023e1379e4dDavid Lawrence /**
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley * Simple Drag plugin that can be attached to a Node or Widget via the plug method.
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley * @module dd
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley * @submodule dd-plugin
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley */
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley /**
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley * Simple Drag plugin that can be attached to a Node or Widget via the plug method.
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley * @class Drag
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley * @extends DD.Drag
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley * @constructor
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley * @namespace Plugin
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley */
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley var Drag = function(config) {
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley if (Y.Widget && config.host instanceof Y.Widget) {
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley config.node = config.host.get('boundingBox');
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley config.widget = config.host;
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley }
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley else {
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence config.node = config.host;
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley config.widget = false;
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley }
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley Drag.superclass.constructor.call(this, config);
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley },
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley EV_DRAG = 'drag:drag',
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley EV_DRAG_END = 'drag:end';
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley /**
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley * @property NAME
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley * @description dd-plugin
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley * @type {String}
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley */
73f4d29ef46f9bbcb104b3dd54393c702848a0abBob Halley Drag.NAME = "dd-plugin";
/**
* @property NS
* @description The Drag instance will be placed on the Node instance under the dd namespace. It can be accessed via Node.dd;
* @type {String}
*/
Drag.NS = "dd";
Y.extend(Drag, Y.DD.Drag, {
/**
* refers to a Y.Widget if its the host, otherwise = false.
*
* @attribute _widget
* @private
*/
_widget: undefined,
/**
* refers to the [x,y] coordinate where the drag was stopped last
*
* @attribute _stoppedPosition
* @private
*/
_stoppedPosition: undefined,
/**
* Returns true if widget uses widgetPosition, otherwise returns false
*
* @method _usesWidgetPosition
* @private
*/
_usesWidgetPosition: function(widget) {
var r = false;
if (widget) {
r = (widget.hasImpl && widget.hasImpl(Y.WidgetPosition)) ? true : false;
}
return r;
},
/**
* Sets up event listeners on drag events if interacting with a widget
*
* @method initializer
* @protected
*/
initializer: function(config) {
this._widget = config.widget;
//if this thing is a widget, and it uses widgetposition...
if (this._usesWidgetPosition(this._widget)) {
//set the x,y on the widget's ATTRS
this.on(EV_DRAG, this._setWidgetCoords);
//store the new position that the widget ends up on
this.on(EV_DRAG_END, this._updateStopPosition);
}
},
/**
* Updates x,y or xy attributes on widget based on where the widget is dragged
*
* @method initializer
* @param {EventFacade} e Event Facade
* @private
*/
_setWidgetCoords: function(e) {
//get the last position where the widget was, or get the starting point
var nodeXY = this._stoppedPosition || e.target.nodeXY,
realXY = e.target.realXY,
//amount moved = [(x2 - x1) , (y2 - y1)]
movedXY = [realXY[0] - nodeXY[0], realXY[1] - nodeXY[0]];
//if both have changed..
if (movedXY[0] !== 0 && movedXY[1] !== 0) {
this._widget.set('xy', realXY);
}
//if only x is 0, set the Y
else if (movedXY[0] === 0) {
this._widget.set('y',realXY[1]);
}
//otherwise, y is 0, so set X
else if (movedXY[1] === 0){
this._widget.set('x', realXY[0]);
}
},
/**
* Updates the last position where the widget was stopped.
*
* @method updateStopPosition
* @param {EventFacade} e Event Facade
* @private
*/
updateStopPosition: function(e) {
this._stoppedPosition = e.target.realXY;
}
});
Y.namespace('Plugin');
Y.Plugin.Drag = Drag;
}, '@VERSION@' ,{skinnable:false, optional:['dd-constrain', 'dd-proxy'], requires:['dd-drag']});