/* Copyright (c) 2006 Yahoo! Inc. All rights reserved. version 0.9.0 */ /** * @class Defines the interface and base operation of items that that can be * dragged or can be drop targets. It was designed to be extended, overriding * the event handlers for startDrag, onDrag, onDragOver, onDragOut. * Up to three html elements can be associated with a DragDrop instance: * * This class should not be instantiated until the onload event to ensure that * the associated elements are available. * The following would define a DragDrop obj that would interact with any * other * DragDrop obj in the "group1" group: *
 *  dd = new YAHOO.util.DragDrop("div1", "group1");
 * 
* Since none of the event handlers have been implemented, nothing would * actually happen if you were to run the code above. Normally you would * override this class or one of the default implementations, but you can * also override the methods you want on an instance of the class... *
 *  dd.onDragDrop = function(e, id) {
 *   alert("dd was dropped on " + id);
 *  }
 * 
* @constructor * @param {String} id of the element that is linked to this instance * @param {String} sGroup the group of related DragDrop objects */ YAHOO.util.DragDrop = function(id, sGroup) { if (id) { this.init(id, sGroup); } }; YAHOO.util.DragDrop.prototype = { /** * The id of the element associated with this object. This is what we * refer to as the "linked element" because the size and position of * this element is used to determine when the drag and drop objects have * interacted. * * @type String */ id: null, /** * The id of the element that will be dragged. By default this is same * as the linked element , but could be changed to another element. Ex: * YAHOO.util.DDProxy * * @type String * @private */ dragElId: null, /** * the id of the element that initiates the drag operation. By default * this is the linked element, but could be changed to be a child of this * element. This lets us do things like only starting the drag when the * header element within the linked html element is clicked. * * @type String * @private */ handleElId: null, /** * An array of HTML tags that will be ignored if clicked. */ invalidHandleTypes: null, /** * The linked element's absolute X position at the time the drag was * started * * @type int * @private */ startPageX: 0, /** * The linked element's absolute X position at the time the drag was * started * * @type int * @private */ startPageY: 0, /** * The group defines a logical collection of DragDrop objects that are * related. Instances only get events when interacting with other * DragDrop object in the same group. This lets us define multiple * groups using a single DragDrop subclass if we want. * */ groups: null, /** * Individual drag/drop instances can be locked. This will prevent * onmousedown start drag. * * @type boolean * @private */ locked: false, /** * Lock this instance */ lock: function() { this.locked = true; }, /** * Unlock this instace */ unlock: function() { this.locked = false; }, /** * By default, all insances can be a drop target. This can be disabled by * setting isTarget to false. * * @type boolean */ isTarget: true, /** * The padding configured for this drag and drop object for calculating * the drop zone intersection with this object. */ padding: null, /** * @private */ _domRef: null, /** * Internal typeof flag * @private */ __ygDragDrop: true, /** * Set to true when horizontal contraints are applied * * @type boolean * @private */ constrainX: false, /** * Set to true when vertical contraints are applied * * @type boolean * @private */ constrainY: false, /** * The left constraint * * @type int * @private */ minX: 0, /** * The right constraint * * @type int * @private */ maxX: 0, /** * The up constraint * * @type int * @private */ minY: 0, /** * The down constraint * * @type int * @private */ maxY: 0, /** * Maintain offsets when we resetconstraints. Used to maintain the * slider thumb value, and this needs to be fixed. * @type boolean */ maintainOffset: false, /** * Array of pixel locations the element will snap to if we specified a * horizontal graduation/interval. This array is generated automatically * when you define a tick interval. * @type int[] */ xTicks: null, /** * Array of pixel locations the element will snap to if we specified a * vertical graduation/interval. This array is generated automatically * when you define a tick interval. * @type int[] */ yTicks: null, /** * By default the drag and drop instance will only respond to the primary * button click (left button for a right-handed mouse). Set to true to * allow drag and drop to start with any mouse click that is propogated * by the browser * @type boolean */ primaryButtonOnly: true, /** * Code that executes immediately before the startDrag event * @private */ b4StartDrag: function(x, y) { }, /** * Abstract method called after a drag/drop object is clicked * and the drag or mousedown time thresholds have beeen met. * * @param {int} X click location * @param {int} Y click location */ startDrag: function(x, y) { /* override this */ }, /** * Code that executes immediately before the onDrag event * @private */ b4Drag: function(e) { }, /** * Abstract method called during the onMouseMove event while dragging an * object. * * @param {Event} e */ onDrag: function(e) { /* override this */ }, /** * Code that executes immediately before the onDragEnter event * @private */ // b4DragEnter: function(e) { }, /** * Abstract method called when this element fist begins hovering over * another DragDrop obj * * @param {Event} e * @param {String || YAHOO.util.DragDrop[]} id In POINT mode, the element * id this is hovering over. In INTERSECT mode, an array of one or more * dragdrop items being hovered over. */ onDragEnter: function(e, id) { /* override this */ }, /** * Code that executes immediately before the onDragOver event * @private */ b4DragOver: function(e) { }, /** * Abstract method called when this element is hovering over another * DragDrop obj * * @param {Event} e * @param {String || YAHOO.util.DragDrop[]} id In POINT mode, the element * id this is hovering over. In INTERSECT mode, an array of dd items * being hovered over. */ onDragOver: function(e, id) { /* override this */ }, /** * Code that executes immediately before the onDragOut event * @private */ b4DragOut: function(e) { }, /** * Abstract method called when we are no longer hovering over an element * * @param {Event} e * @param {String || YAHOO.util.DragDrop[]} id In POINT mode, the element * id this was hovering over. In INTERSECT mode, an array of dd items * that the mouse is no longer over. */ onDragOut: function(e, id) { /* override this */ }, /** * Code that executes immediately before the onDragDrop event * @private */ b4DragDrop: function(e) { }, /** * Abstract method called when this item is dropped on another DragDrop * obj * * @param {Event} e * @param {String || YAHOO.util.DragDrop[]} id In POINT mode, the element * id this was dropped on. In INTERSECT mode, an array of dd items this * was dropped on. */ onDragDrop: function(e, id) { /* override this */ }, /** * Code that executes immediately before the endDrag event * @private */ b4EndDrag: function(e) { }, /** * Fired when we are done dragging the object * * @param {Event} e */ endDrag: function(e) { /* override this */ }, /** * Code executed immediately before the onMouseDown event * @param {Event} e * @private */ b4MouseDown: function(e) { }, /** * Event handler that fires when a drag/drop obj gets a mousedown * @param {Event} e */ onMouseDown: function(e) { /* override this */ }, /** * Event handler that fires when a drag/drop obj gets a mouseup * @param {Event} e */ onMouseUp: function(e) { /* override this */ }, /** * Returns a reference to the linked element * * @return {Object} the html element */ getEl: function() { if (!this._domRef) { this._domRef = this.DDM.getElement(this.id); } return this._domRef; }, /** * Returns a reference to the actual element to drag. By default this is * the same as the html element, but it can be assigned to another * element. An example of this can be found in YAHOO.util.DDProxy * * @return {Object} the html element */ getDragEl: function() { return this.DDM.getElement(this.dragElId); }, /** * Sets up the DragDrop object. Must be called in the constructor of any * YAHOO.util.DragDrop subclass * * @param id the id of the linked element * @param {String} sGroup the group of related items * element is supposed to be a target only, set to false. */ init: function(id, sGroup) { this.initTarget(id, sGroup); YAHOO.util.Event.addListener(id, "mousedown", this.handleMouseDown, this, true); }, /** * Initializes Targeting functionality only... the object does not * get a mousedown handler. * * @param id the id of the linked element * @param {String} sGroup the group of related items * element is supposed to be a target only, set to false. */ initTarget: function(id, sGroup) { // create a local reference to the drag and drop manager this.DDM = YAHOO.util.DDM; // set the default padding this.padding = [0, 0, 0, 0]; // initialize the groups array this.groups = {}; // set the id this.id = id; // the element is a drag handle by default this.setDragElId(id); // by default, clicked anchors will not start drag operations this.invalidHandleTypes = {a : "a"}; // We don't want to register this as the handle with the manager // so we just set the id rather than calling the setter this.handleElId = id; // cache the position of the element if we can if (document && document.body) { this.setInitPosition(); } // add to an interaction group this.addToGroup((sGroup) ? sGroup : "default"); }, /** * Configures the padding for the target zone in px. Effectively expands * (or reduces) the virtual object size for targeting calculations. * Supports css-style shorthand; if only one parameter is passed, all sides * will have that padding, and if only two are passed, the top and bottom * will have the first param, the left and right the second. * @param {int} iTop Top pad * @param {int} iRight Right pad * @param {int} iBot Bot pad * @param {int} iLeft Left pad */ setPadding: function(iTop, iRight, iBot, iLeft) { // this.padding = [iLeft, iRight, iTop, iBot]; if (!iRight && 0 !== iRight) { this.padding = [iTop, iTop, iTop, iTop]; } else if (!iBot && 0 !== iBot) { this.padding = [iTop, iRight, iTop, iRight]; } else { this.padding = [iTop, iRight, iBot, iLeft]; } }, /** * Stores the initial placement of the dd element */ setInitPosition: function(diffX, diffY) { var el = this.getEl(); if (!this.DDM.verifyEl(el)) { return; } var dx = diffX || 0; var dy = diffY || 0; var p = YAHOO.util.Dom.getXY( el ); this.initPageX = p[0] - dx; this.initPageY = p[1] - dy; this.lastPageX = p[0]; this.lastPageY = p[1]; this.setStartPosition(p); }, /** * Sets the start position of the element. This is set when the obj * is initialized, the reset when a drag is started. * @param pos current position (from previous lookup) * @private */ setStartPosition: function(pos) { var p = pos || YAHOO.util.Dom.getXY( this.getEl() ); this.startPageX = p[0]; this.startPageY = p[1]; }, /** * Add this instance to a group of related drag/drop objects. All * instances belong to at least one group, and can belong to as many * groups as needed. * * @param sGroup {string} the name of the group */ addToGroup: function(sGroup) { this.groups[sGroup] = true; this.DDM.regDragDrop(this, sGroup); }, /** * Allows you to specify that an element other than the linked element * will be moved with the cursor during a drag * * @param id the id of the element that will be used to initiate the drag */ setDragElId: function(id) { this.dragElId = id; }, /** * Allows you to specify a child of the linked element that should be * used to initiate the drag operation. An example of this would be if * you have a content div with text and links. Clicking anywhere in the * content area would normally start the drag operation. Use this method * to specify that an element inside of the content div is the element * that starts the drag operation. * * @param id the id of the element that will be used to initiate the drag */ setHandleElId: function(id) { this.handleElId = id; this.DDM.regHandle(this.id, id); }, /** * Allows you to set an element outside of the linked element as a drag * handle */ setOuterHandleElId: function(id) { YAHOO.util.Event.addListener(id, "mousedown", this.handleMouseDown, this, true); this.setHandleElId(id); }, /** * Remove all drag and drop hooks for this element */ unreg: function() { YAHOO.util.Event.removeListener(this.id, "mousedown", this.handleMouseDown); this._domRef = null; this.DDM._remove(this); }, /** * Returns true if this instance is locked, or the drag drop mgr is locked * (meaning that all drag/drop is disabled on the page.) * * @return {boolean} true if this obj or all drag/drop is locked, else * false */ isLocked: function() { return (this.DDM.isLocked() || this.locked); }, /** * Fired when this object is clicked * * @param {Event} e * @param {YAHOO.util.DragDrop} oDD the clicked dd object (this dd obj) * @private */ handleMouseDown: function(e, oDD) { var EU = YAHOO.util.Event; var button = e.which || e.button; if (this.primaryButtonOnly && button > 1) { return; } if (this.isLocked()) { return; } this.DDM.refreshCache(this.groups); // Only process the event if we really clicked within the linked // element. The reason we make this check is that in the case that // another element was moved between the clicked element and the // cursor in the time between the mousedown and mouseup events. When // this happens, the element gets the next mousedown event // regardless of where on the screen it happened. var pt = new YAHOO.util.Point(EU.getPageX(e), EU.getPageY(e)); if ( this.DDM.isOverTarget(pt, this) ) { // check to see if the handle was clicked var srcEl = EU.getTarget(e); if (this.isValidHandleChild(srcEl) && (this.id == this.handleElId || this.DDM.handleWasClicked(srcEl, this.id)) ) { // set the initial element position this.setStartPosition(); this.b4MouseDown(e); this.onMouseDown(e); this.DDM.handleMouseDown(e, this); this.DDM.stopEvent(e); } } }, /** * Allows you to specify a tag name that should not start a drag operation * when clicked. This is designed to facilitate embedding links within a * drag handle that do something other than start the drag. * * @param {string} tagName the type of element to exclude */ addInvalidHandleType: function(tagName) { var type = tagName.toUpperCase(); this.invalidHandleTypes[type] = type; }, /** * Unsets an excluded tag name set by addInvalidHandleType * * @param {string} tagName the type of element to unexclude */ removeInvalidHandleType: function(tagName) { var type = tagName.toUpperCase(); this.invalidHandleTypes[type] = null; }, /** * Checks the tag exclusion list to see if this click should be ignored * * @param {ygNode} node * @return {boolean} true if this is a valid tag type, false if not */ isValidHandleChild: function(node) { var type = node.nodeName; if (type == "#text") { type = node.parentNode.nodeName; } return (!this.invalidHandleTypes[type]); }, /** * Create the array of horizontal tick marks if an interval was specified * in setXConstraint(). * * @private */ setXTicks: function(iStartX, iTickSize) { this.xTicks = []; this.xTickSize = iTickSize; var tickMap = {}; for (var i = this.initPageX; i >= this.minX; i = i - iTickSize) { if (!tickMap[i]) { this.xTicks[this.xTicks.length] = i; tickMap[i] = true; } } for (i = this.initPageX; i <= this.maxX; i = i + iTickSize) { if (!tickMap[i]) { this.xTicks[this.xTicks.length] = i; tickMap[i] = true; } } this.xTicks.sort(this.DDM.numericSort) ; }, /** * Create the array of vertical tick marks if an interval was specified in * setYConstraint(). * * @private */ setYTicks: function(iStartY, iTickSize) { this.yTicks = []; this.yTickSize = iTickSize; var tickMap = {}; for (var i = this.initPageY; i >= this.minY; i = i - iTickSize) { if (!tickMap[i]) { this.yTicks[this.yTicks.length] = i; tickMap[i] = true; } } for (i = this.initPageY; i <= this.maxY; i = i + iTickSize) { if (!tickMap[i]) { this.yTicks[this.yTicks.length] = i; tickMap[i] = true; } } this.yTicks.sort(this.DDM.numericSort) ; }, /** * By default, the element can be dragged any place on the screen. Use * this method to limit the horizontal travel of the element. Pass in * 0,0 for the parameters if you want to lock the drag to the y axis. * * @param {int} iLeft the number of pixels the element can move to the left * @param {int} iRight the number of pixels the element can move to the * right * @param {int} iTickSize optional parameter for specifying that the * element * should move iTickSize pixels at a time. */ setXConstraint: function(iLeft, iRight, iTickSize) { this.leftConstraint = iLeft; this.rightConstraint = iRight; this.minX = this.initPageX - iLeft; this.maxX = this.initPageX + iRight; if (iTickSize) { this.setXTicks(this.initPageX, iTickSize); } this.constrainX = true; }, /** * By default, the element can be dragged any place on the screen. Set * this to limit the vertical travel of the element. Pass in 0,0 for the * parameters if you want to lock the drag to the x axis. * * @param {int} iUp the number of pixels the element can move up * @param {int} iDown the number of pixels the element can move down * @param {int} iTickSize optional parameter for specifying that the * element should move iTickSize pixels at a time. */ setYConstraint: function(iUp, iDown, iTickSize) { this.topConstraint = iUp; this.bottomConstraint = iDown; this.minY = this.initPageY - iUp; this.maxY = this.initPageY + iDown; if (iTickSize) { this.setYTicks(this.initPageY, iTickSize); } this.constrainY = true; }, /** * resetConstraints must be called if you manually reposition a dd element. * @param {boolean} maintainOffset */ resetConstraints: function() { // figure out how much this thing has moved var dx = (this.maintainOffset) ? this.lastPageX - this.initPageX : 0; var dy = (this.maintainOffset) ? this.lastPageY - this.initPageY : 0; // reset the initial location this.setInitPosition(dx, dy); if (this.constrainX) { this.setXConstraint( this.leftConstraint, this.rightConstraint, this.xTickSize ); } if (this.constrainY) { this.setYConstraint( this.topConstraint, this.bottomConstraint, this.yTickSize ); } }, /** * Normally the drag element is moved pixel by pixel, but we can specify * that it move a number of pixels at a time. This method resolves the * location when we have it set up like this. * * @param {int} val where we want to place the object * @param {int[]} tickArray sorted array of valid points * @return {int} the closest tick * @private */ getTick: function(val, tickArray) { if (!tickArray) { // If tick interval is not defined, it is effectively 1 pixel, // so we return the value passed to us. return val; } else if (tickArray[0] >= val) { // The value is lower than the first tick, so we return the first // tick. return tickArray[0]; } else { for (var i = 0; i < tickArray.length; ++i) { var next = i + 1; if (tickArray[next] && tickArray[next] >= val) { var diff1 = val - tickArray[i]; var diff2 = tickArray[next] - val; return (diff2 > diff1) ? tickArray[i] : tickArray[next]; } } // The value is larger than the last tick, so we return the last // tick. return tickArray[tickArray.length - 1]; } }, /** * toString method * @return {string} string representation of the dd obj */ toString: function(val, tickArray) { return ("YAHOO.util.DragDrop {" + this.id + "}"); } }; /* Copyright (c) 2006 Yahoo! Inc. All rights reserved. */ // Only load the library once. Rewriting the manager class would orphan // existing drag and drop instances. if (!YAHOO.util.DragDropMgr) { /** * @class Handles the element interaction for all DragDrop items in the * window. Generally, you will not call this class directly, but it does * have helper methods that could be useful in your DragDrop * implementations. This class should not be instantiated; all methods * are are static. * * @constructor */ YAHOO.util.DragDropMgr = new function() { /** * utility package shorthand * @private */ var UTIL = YAHOO.util; /** * Two dimensional Array of registered DragDrop objects. The first * dimension is the DragDrop item group, the second the DragDrop * object. * * @private */ this.ids = {}; /** * Array of element ids defined as drag handles. Used to determine * if the element that generated the mousedown event is actually the * handle and not the html element itself. * * @private */ this.handleIds = {}; /** * the DragDrop object that is currently being dragged * * @type DragDrop * @private **/ this.dragCurrent = null; /** * the DragDrop object(s) that are being hovered over * * @type Array * @private */ this.dragOvers = {}; /** * @private */ /** * the X distance between the cursor and the object being dragged * * @type int * @private */ this.deltaX = 0; /** * the Y distance between the cursor and the object being dragged * * @type int * @private */ this.deltaY = 0; /** * Flag to determine if we should prevent the default behavior of the * events we define. By default this is true, but this can be set to * false if you need the default behavior (not recommended) * * @type boolean */ this.preventDefault = true; /** * Flag to determine if we should stop the propagation of the events * we generate. This is true by default but you may want to set it to * false if the html element contains other features that require the * mouse click. * * @type boolean */ this.stopPropagation = true; /** * @private */ this.initalized = false; /** * All drag and drop can be disabled. * * @private */ this.locked = false; /** * Called the first time an element is registered. * * @private */ this.init = function() { }; /** * In point mode, drag and drop interaction is defined by the * location of the cursor during the drag/drop * @type int */ this.POINT = 0; /** * In intersect mode, drag and drop interactio nis defined by the * overlap of two or more drag and drop objects. * @type int */ this.INTERSECT = 1; /** * The current drag and drop mode. Default it point mode * @type int */ this.mode = this.POINT; /** * Runs method on all drag and drop objects * @private */ this._execOnAll = function(sMethod, args) { for (var i in this.ids) { for (var j in this.ids[i]) { var oDD = this.ids[i][j]; if (! this.isTypeOfDD(oDD)) { continue; } oDD[sMethod].apply(oDD, args); } } }; /** * Drag and drop initialization. Sets up the global event handlers * @private */ this._onLoad = function() { this._execOnAll("setInitPosition", []); var EU = UTIL.Event; EU.addListener(document, "mouseup", this.handleMouseUp, this, true); EU.addListener(document, "mousemove", this.handleMouseMove, this, true); EU.addListener(window, "unload", this._onUnload, this, true); EU.addListener(window, "resize", this._onResize, this, true); // EU.addListener(window, "mouseout", this._test); this.initalized = true; }; /** * Reset constraints on all drag and drop objs * @private */ this._onResize = function(e) { this._execOnAll("resetConstraints", []); }; /** * Lock all drag and drop functionality */ this.lock = function() { this.locked = true; }; /** * Unlock all drag and drop functionality */ this.unlock = function() { this.locked = false; }; /** * Is drag and drop locked? * * @return {boolean} True if drag and drop is locked, false otherwise. */ this.isLocked = function() { return this.locked; }; /** * Location cache that is set for all drag drop objects when a drag is * initiated, cleared when the drag is finished. * * @private */ this.locationCache = {}; /** * Set useCache to false if you want to force object the lookup of each * drag and drop linked element constantly during a drag. * @type boolean */ this.useCache = true; /** * The number of pixels that the mouse needs to move after the * mousedown before the drag is initiated. Default=3; * @type int */ this.clickPixelThresh = 3; /** * The number of milliseconds after the mousedown event to initiate the * drag if we don't get a mouseup event. Default=1000 * @type int */ this.clickTimeThresh = 1000; /** * Flag that indicates that either the drag pixel threshold or the * mousdown time threshold has been met * @type boolean * @private */ this.dragThreshMet = false; /** * Timeout used for the click time threshold * @type Object * @private */ this.clickTimeout = null; /** * The X position of the mousedown event stored for later use when a * drag threshold is met. * @type int * @private */ this.startX = 0; /** * The Y position of the mousedown event stored for later use when a * drag threshold is met. * @type int * @private */ this.startY = 0; /** * Each DragDrop instance must be registered with the DragDropMgr. * This is executed in ygDragDrop.init() * * @param {DragDrop} oDD the DragDrop object to register * @param {String} sGroup the name of the group this element belongs to */ this.regDragDrop = function(oDD, sGroup) { if (!this.initialized) { this.init(); } if (!this.ids[sGroup]) { this.ids[sGroup] = {}; } this.ids[sGroup][oDD.id] = oDD; }; /** * Unregisters a drag and drop item. This is executed in * ygDragDrop.unreg, use that method instead of calling this directly. * @private */ this._remove = function(oDD) { for (var g in oDD.groups) { if (g && this.ids[g][oDD.id]) { delete this.ids[g][oDD.id]; } } delete this.handleIds[oDD.id]; }; /** * Each DragDrop handle element must be registered. This is done * automatically when executing ygDragDrop.setHandleElId() * * @param {String} sDDId the DragDrop id this element is a handle for * @param {String} sHandleId the id of the element that is the drag * handle */ this.regHandle = function(sDDId, sHandleId) { if (!this.handleIds[sDDId]) { this.handleIds[sDDId] = {}; } this.handleIds[sDDId][sHandleId] = sHandleId; }; /** * Utility function to determine if a given element has been * registered as a drag drop item. * * @param {String} id the element id to check * @return {boolean} true if this element is a DragDrop item, * false otherwise */ this.isDragDrop = function(id) { return ( this.getDDById(id) ) ? true : false; }; /** * Returns the drag and drop instances that are in all groups the * passed in instance belongs to. * * @param {ygDragDrop} p_oDD the obj to get related data for * @param {boolean} bTargetsOnly if true, only return targetable objs * @return {ygDragDrop[]} the related instances */ this.getRelated = function(p_oDD, bTargetsOnly) { var oDDs = []; for (var i in p_oDD.groups) { for (j in this.ids[i]) { var dd = this.ids[i][j]; if (! this.isTypeOfDD(dd)) { continue; } if (!bTargetsOnly || dd.isTarget) { oDDs[oDDs.length] = dd; } } } return oDDs; }; /** * Returns true if the specified dd target is a legal target for * the specifice drag obj * * @param {ygDragDrop} the drag obj * @param {ygDragDrop) the target * @return {boolean} true if the target is a legal target for the * dd obj */ this.isLegalTarget = function (oDD, oTargetDD) { var targets = this.getRelated(oDD); for (var i =0;i this.clickPixelThresh || diffY > this.clickPixelThresh) { this.startDrag(this.startX, this.startY); } } if (this.dragThreshMet) { this.dragCurrent.b4Drag(e); this.dragCurrent.onDrag(e); this.fireEvents(e, false); } this.stopEvent(e); }; /** * Iterates over all of the DragDrop elements to find ones we are * hovering over or dropping on * * @param {Event} e the event * @param {boolean} isDrop is this a drop op or a mouseover op? * @private */ this.fireEvents = function(e, isDrop) { var dc = this.dragCurrent; // If the user did the mouse up outside of the window, we could // get here even though we have ended the drag. if (!dc || dc.isLocked()) { return; } var x = UTIL.Event.getPageX(e); var y = UTIL.Event.getPageY(e); var pt = new YAHOO.util.Point(x,y); // cache the previous dragOver array var oldOvers = []; var outEvts = []; var overEvts = []; var dropEvts = []; var enterEvts = []; // Check to see if the object we were hovering over is no longer // being hovered over so we can fire the onDragOut event for (var i in this.dragOvers) { var ddo = this.dragOvers[i]; if (! this.isTypeOfDD(ddo)) { continue; } if (! this.isOverTarget(pt, ddo, this.mode)) { outEvts.push( ddo ); } oldOvers[i] = true; delete this.dragOvers[i]; } for (var sGroup in dc.groups) { if ("string" != typeof sGroup) { continue; } for (i in this.ids[sGroup]) { var oDD = this.ids[sGroup][i]; if (! this.isTypeOfDD(oDD)) { continue; } if (oDD.isTarget && !oDD.isLocked() && oDD != dc) { if (this.isOverTarget(pt, oDD, this.mode)) { // look for drop interactions if (isDrop) { dropEvts.push( oDD ); // look for drag enter and drag over interactions } else { // initial drag over: dragEnter fires if (!oldOvers[oDD.id]) { enterEvts.push( oDD ); // subsequent drag overs: dragOver fires } else { overEvts.push( oDD ); } this.dragOvers[oDD.id] = oDD; } } } } } if (this.mode) { if (outEvts.length > 0) { dc.b4DragOut(e, outEvts); dc.onDragOut(e, outEvts); } if (enterEvts.length > 0) { dc.onDragEnter(e, enterEvts); } if (overEvts.length > 0) { dc.b4DragOver(e, overEvts); dc.onDragOver(e, overEvts); } if (dropEvts.length > 0) { dc.b4DragDrop(e, dropEvts); dc.onDragDrop(e, dropEvts); } } else { // fire dragout events for (i=0; i < outEvts.length; ++i) { dc.b4DragOut(e, outEvts[i].id); dc.onDragOut(e, outEvts[i].id); } // fire enter events for (i=0; i < enterEvts.length; ++i) { // dc.b4DragEnter(e, oDD.id); dc.onDragEnter(e, enterEvts[i].id); } // fire over events for (i=0; i < overEvts.length; ++i) { dc.b4DragOver(e, overEvts[i].id); dc.onDragOver(e, overEvts[i].id); } // fire drop events for (i=0; i < dropEvts.length; ++i) { dc.b4DragDrop(e, dropEvts[i].id); dc.onDragDrop(e, dropEvts[i].id); } } }; /** * Helper function for getting the best match from the list of drag * and drop objects returned by the drag and drop events when we are * in INTERSECT mode. It returns either the first object that the * cursor is over, or the object that has the greatest overlap with * the dragged element. * * @param {ygDragDrop[]} dds The array of drag and drop objects * targeted * @return {ygDragDrop} The best single match */ this.getBestMatch = function(dds) { var winner = null; // Return null if the input is not what we expect //if (!dds || !dds.length || dds.length == 0) { // winner = null; // If there is only one item, it wins //} else if (dds.length == 1) { if (dds.length == 1) { winner = dds[0]; } else { // Loop through the targeted items for (var i=0; i= loc[3] && x <= loc[1] && y >= loc[0] && y <= loc[2]); //oDDTarget.cursorIsOver = loc.contains( new YAHOO.util.Point(x, y) ); oDDTarget.cursorIsOver = loc.contains( pt ); oDDTarget.overlap = null; // if (this.INTERSECT == this.mode) { if (intersect) { var curRegion = YAHOO.util.Region.getRegion(this.dragCurrent.getDragEl()); var overlap = curRegion.intersect(loc); if (overlap) { oDDTarget.overlap = overlap; return true; } else { return false; } } else { return oDDTarget.cursorIsOver; } }; /** * @private */ this._onUnload = function(e, me) { this.unregAll(); }; /** * Cleans up the drag and drop events and objects. * * @private */ this.unregAll = function() { if (this.dragCurrent) { this.stopDrag(); this.dragCurrent = null; } this._execOnAll("unreg", []); for (i in this.elementCache) { delete this.elementCache[i]; } this.elementCache = {}; this.ids = {}; }; /** * A cache of DOM elements * * @private */ this.elementCache = {}; /** * Get the wrapper for the DOM element specified * * @param {String} id the id of the elment to get * @return {YAHOO.util.DDM.ElementWrapper} the wrapped element * @private */ this.getElWrapper = function(id) { var oWrapper = this.elementCache[id]; if (!oWrapper || !oWrapper.el) { oWrapper = this.elementCache[id] = new this.ElementWrapper(document.getElementById(id)); } return oWrapper; }; /** * Returns the actual DOM element * * @param {String} id the id of the elment to get * @return {Object} The element */ this.getElement = function(id) { // return this.getElWrapper(id).el; return document.getElementById(id); }; /** * Returns the style property for the DOM element (i.e., * document.getElById(id).style) * * @param {String} id the id of the elment to get * @return {Object} The style property of the element */ this.getCss = function(id) { // return this.getElWrapper(id).css; var css = null; var el = document.getElementById(id); if (el) { css = el.style; } return css; }; /** * Inner class for cached elements */ this.ElementWrapper = function(el) { /** * @private */ this.el = el || null; /** * @private */ this.id = this.el && el.id; /** * @private */ this.css = this.el && el.style; }; /** * Returns the X position of an html element * @param el the element for which to get the position * @return {int} the X coordinate */ this.getPosX = function(el) { return YAHOO.util.Dom.getX(el); }; /** * Returns the Y position of an html element * @param el the element for which to get the position * @return {int} the Y coordinate */ this.getPosY = function(el) { return YAHOO.util.Dom.getY(el); }; /** * Swap two nodes. In IE, we use the native method, for others we * emulate the IE behavior * * @param n1 the first node to swap * @param n2 the other node to swap */ this.swapNode = function(n1, n2) { if (n1.swapNode) { n1.swapNode(n2); } else { // the node reference order for the swap is a little tricky. var p = n2.parentNode; var s = n2.nextSibling; n1.parentNode.replaceChild(n2,n1); p.insertBefore(n1,s); } }; /** * @private */ this.getScroll = function () { var t, l; if (document.documentElement && document.documentElement.scrollTop) { t = document.documentElement.scrollTop; l = document.documentElement.scrollLeft; } else if (document.body) { t = document.body.scrollTop; l = document.body.scrollLeft; } return { top: t, left: l }; }; /** * Returns the specified element style property * @param {HTMLElement} el the element * @param {string} styleProp the style property * @return {string} The value of the style property */ this.getStyle = function(el, styleProp) { if (el.style.styleProp) { return el.style.styleProp; } else if (el.currentStyle) { return el.currentStyle[styleProp]; } else if (document.defaultView) { return document.defaultView.getComputedStyle(el, null). getPropertyValue(styleProp); } }; /** * Gets the scrollTop * * @return {int} the document's scrollTop */ this.getScrollTop = function () { return this.getScroll().top; }; /** * Gets the scrollLeft * * @return {int} the document's scrollTop */ this.getScrollLeft = function () { return this.getScroll().left; }; this.moveToEl = function (moveEl, targetEl) { var aCoord = YAHOO.util.Dom.getXY(targetEl); YAHOO.util.Dom.setXY(moveEl, aCoord); }; /** * Gets the client height * * @return {int} client height in px */ this.getClientHeight = function() { return (window.innerHeight) ? window.innerHeight : (document.documentElement && document.documentElement.clientHeight) ? document.documentElement.clientHeight : document.body.offsetHeight; }; /** * Gets the client width * * @return {int} client width in px */ this.getClientWidth = function() { return (window.innerWidth) ? window.innerWidth : (document.documentElement && document.documentElement.clientWidth) ? document.documentElement.clientWidth : document.body.offsetWidth; }; /** * numeric array sort function */ this.numericSort = function(a, b) { return (a - b); }; /** * @private */ this._timeoutCount = 0; /** * @private * Trying to make the load order less important. Without this we get * an error if this file is loaded before the Event Utility. */ this._addListeners = function() { if ( UTIL.Event && document && document.body ) { this._onLoad(); } else { if (this._timeoutCount > 500) { } else { setTimeout("YAHOO.util.DDM._addListeners()", 10); this._timeoutCount += 1; } } }; /** * Recursively searches the immediate parent and all child nodes for * the handle element in order to determine wheter or not it was * clicked. * * @param node the html element to inspect */ this.handleWasClicked = function(node, id) { if (this.isHandle(id, node.id)) { return true; } else { // check to see if this is a text node child of the one we want var p = node.parentNode; while (p) { if (this.isHandle(id, p.id)) { return true; } else { p = p.parentNode; } } } return false; }; }; // shorter alias, save a few bytes YAHOO.util.DDM = YAHOO.util.DragDropMgr; YAHOO.util.DDM._addListeners(); } /* Copyright (c) 2006 Yahoo! Inc. All rights reserved. */ /** * @class a DragDrop implementation where the linked element follows the * mouse cursor. * * @extends DragDrop * @constructor * @param {String} id the id of the linked element * @param {String} sGroup the group of related DragDrop items */ YAHOO.util.DD = function(id, sGroup) { if (id) { this.init(id, sGroup); } }; YAHOO.util.DD.prototype = new YAHOO.util.DragDrop(); /** * Should we auto-scroll? Defaults to true * * @type boolean */ YAHOO.util.DD.prototype.scroll = true; /** * Sets the pointer offset to the distance between the linked element's top * left corner and the location the element was clicked * * @param {int} iPageX the X coordinate of the click * @param {int} iPageY the Y coordinate of the click */ YAHOO.util.DD.prototype.autoOffset = function(iPageX, iPageY) { var el = this.getEl(); var aCoord = YAHOO.util.Dom.getXY(el); var x = iPageX - aCoord[0]; var y = iPageY - aCoord[1]; this.setDelta(x, y); }; /** * Sets the pointer offset. You can call this directly to force the offset to * be in a particular location (e.g., pass in 0,0 to set it to the center of the * object, as done in ygDDSliderBG) * * @param {int} iDeltaX the distance from the left * @param {int} iDeltaY the distance from the top */ YAHOO.util.DD.prototype.setDelta = function(iDeltaX, iDeltaY) { this.deltaX = iDeltaX; this.deltaY = iDeltaY; }; /** * Sets the drag element to the location of the mousedown or click event, * maintaining the cursor location relative to the location on the element * that was clicked. Override this if you want to place the element in a * location other than where the cursor is. * * @param {int} iPageX the X coordinate of the mousedown or drag event * @param {int} iPageY the Y coordinate of the mousedown or drag event */ YAHOO.util.DD.prototype.setDragElPos = function(iPageX, iPageY) { this.alignElWithMouse(this.getDragEl(), iPageX, iPageY); }; /** * Sets the element to the location of the mousedown or click event, * maintaining the cursor location relative to the location on the element * that was clicked. Override this if you want to place the element in a * location other than where the cursor is. * * @param {HTMLElement} el the element to move * @param {int} iPageX the X coordinate of the mousedown or drag event * @param {int} iPageY the Y coordinate of the mousedown or drag event */ YAHOO.util.DD.prototype.alignElWithMouse = function(el, iPageX, iPageY) { var oCoord = this.getTargetCoord(iPageX, iPageY); var aCoord = [oCoord.x, oCoord.y]; YAHOO.util.Dom.setXY(el, aCoord); this.cachePosition(oCoord.x, oCoord.y); this.autoScroll(oCoord.x, oCoord.y, el.offsetHeight, el.offsetWidth); }; /** * Saves the most recent position so that we can reset the constraints and * tick marks on-demand. We need to know this so that we can calculate the * number of pixels the element is offset from its original position. */ YAHOO.util.DD.prototype.cachePosition = function(iPageX, iPageY) { if (iPageX) { this.lastPageX = iPageX; this.lastPageY = iPageY; } else { var aCoord = YAHOO.util.Dom.getXY(this.getEl()); this.lastPageX = aCoord[0]; this.lastPageY = aCoord[1]; } }; /** * Auto-scroll the window if the dragged object has been moved beyond the * visible window boundary. * * @param {int} x the drag element's x position * @param {int} y the drag element's y position * @param {int} h the height of the drag element * @param {int} w the width of the drag element * @private */ YAHOO.util.DD.prototype.autoScroll = function(x, y, h, w) { if (this.scroll) { // The client height var clientH = this.DDM.getClientHeight(); // The client width var clientW = this.DDM.getClientWidth(); // The amt scrolled down var st = this.DDM.getScrollTop(); // The amt scrolled right var sl = this.DDM.getScrollLeft(); // Location of the bottom of the element var bot = h + y; // Location of the right of the element var right = w + x; // The distance from the cursor to the bottom of the visible area, // adjusted so that we don't scroll if the cursor is beyond the // element drag constraints var toBot = (clientH + st - y - this.deltaY); // The distance from the cursor to the right of the visible area var toRight = (clientW + sl - x - this.deltaX); // How close to the edge the cursor must be before we scroll // var thresh = (document.all) ? 100 : 40; var thresh = 40; // How many pixels to scroll per autoscroll op. This helps to reduce // clunky scrolling. IE is more sensitive about this ... it needs this // value to be higher. var scrAmt = (document.all) ? 80 : 30; // Scroll down if we are near the bottom of the visible page and the // obj extends below the crease if ( bot > clientH && toBot < thresh ) { window.scrollTo(sl, st + scrAmt); } // Scroll up if the window is scrolled down and the top of the object // goes above the top border if ( y < st && st > 0 && y - st < thresh ) { window.scrollTo(sl, st - scrAmt); } // Scroll right if the obj is beyond the right border and the cursor is // near the border. if ( right > clientW && toRight < thresh ) { window.scrollTo(sl + scrAmt, st); } // Scroll left if the window has been scrolled to the right and the obj // extends past the left border if ( x < sl && sl > 0 && x - sl < thresh ) { window.scrollTo(sl - scrAmt, st); } } }; /** * Finds the location the element should be placed if we want to move * it to where the mouse location less the click offset would place us. * * @param {int} iPageX the X coordinate of the click * @param {int} iPageY the Y coordinate of the click * @return an object that contains the coordinates (Object.x and Object.y) * @private */ YAHOO.util.DD.prototype.getTargetCoord = function(iPageX, iPageY) { var x = iPageX - this.deltaX; var y = iPageY - this.deltaY; if (this.constrainX) { if (x < this.minX) { x = this.minX; } if (x > this.maxX) { x = this.maxX; } } if (this.constrainY) { if (y < this.minY) { y = this.minY; } if (y > this.maxY) { y = this.maxY; } } x = this.getTick(x, this.xTicks); y = this.getTick(y, this.yTicks); return {x:x, y:y}; }; // overrides YAHOO.util.DragDrop YAHOO.util.DD.prototype.b4MouseDown = function(e) { // this.resetConstraints(); this.autoOffset(YAHOO.util.Event.getPageX(e), YAHOO.util.Event.getPageY(e)); }; // overrides YAHOO.util.DragDrop YAHOO.util.DD.prototype.b4Drag = function(e) { this.setDragElPos(YAHOO.util.Event.getPageX(e), YAHOO.util.Event.getPageY(e)); }; /////////////////////////////////////////////////////////////////////////////// // Debugging ygDragDrop events that can be overridden /////////////////////////////////////////////////////////////////////////////// /* YAHOO.util.DD.prototype.startDrag = function(x, y) { }; YAHOO.util.DD.prototype.onDrag = function(e) { }; YAHOO.util.DD.prototype.onDragEnter = function(e, id) { }; YAHOO.util.DD.prototype.onDragOver = function(e, id) { }; YAHOO.util.DD.prototype.onDragOut = function(e, id) { }; YAHOO.util.DD.prototype.onDragDrop = function(e, id) { }; YAHOO.util.DD.prototype.endDrag = function(e) { }; */ /* Copyright (c) 2006 Yahoo! Inc. All rights reserved. */ /** * @class a DragDrop implementation that inserts an empty, bordered div into * the document that follows the cursor during drag operations. At the time of * the click, the frame div is resized to the dimensions of the linked html * element, and moved to the exact location of the linked element. * * @extends YAHOO.util.DD * @constructor * @param {String} id the id of the linked html element * @param {String} sGroup the group of related DragDrop objects */ YAHOO.util.DDProxy = function(id, sGroup) { if (id) { this.init(id, sGroup); this.initFrame(); } }; YAHOO.util.DDProxy.prototype = new YAHOO.util.DD(); /** * A reference to the one div element we create for all instances of this class * * @type Object */ YAHOO.util.DDProxy.frameDiv = null; /** * the drag frame div id * * @type String */ YAHOO.util.DDProxy.dragElId = "ygddfdiv"; /** * The border width of the frame. This is used when we resize the frame to * the size of the linked element. We substract the border width to make * the div the correct size. * * @TODO find a better way to handle this * * @type int */ YAHOO.util.DDProxy.prototype.borderWidth = 2; /** * By default we resize the drag frame to be the same size as the element * we want to drag (this is to get the frame effect). We can turn it off * if we want a different behavior (ex: ygDDMy2) * * @type boolean */ YAHOO.util.DDProxy.prototype.resizeFrame = true; /** * By default the frame is positioned exactly where the drag element is, so * we use the cursor offset provided by YAHOO.util.DD. Another option that works only if * you do not have constraints on the obj is to have the drag frame centered * around the cursor. Set centerFrame to true for this effect. Ex: * ygDDMy2 * * @type boolean */ YAHOO.util.DDProxy.prototype.centerFrame = false; /** * Create the drag frame if needed */ YAHOO.util.DDProxy.createFrame = function() { var THIS = YAHOO.util.DDProxy; if (!document || !document.body) { setTimeout(THIS.createFrame, 50); return; } if (!THIS.frameDiv) { THIS.frameDiv = document.createElement("div"); THIS.frameDiv.id = THIS.dragElId; var s = THIS.frameDiv.style; s.position = "absolute"; s.visibility = "hidden"; s.cursor = "move"; s.border = "2px solid #aaa"; s.zIndex = 999; document.body.appendChild(THIS.frameDiv); } }; /** * Initialization for the drag frame element. Must be called in the * constructor of all subclasses */ YAHOO.util.DDProxy.prototype.initFrame = function() { YAHOO.util.DDProxy.createFrame(); this.setDragElId(YAHOO.util.DDProxy.dragElId); this.useAbsMath = true; }; /** * Resizes the drag frame to the dimensions of the clicked object, positions * it over the object, and finally displays it * * @param {int} iPageX X click position * @param {int} iPageY Y click position * @private */ YAHOO.util.DDProxy.prototype.showFrame = function(iPageX, iPageY) { var el = this.getEl(); var s = this.getDragEl().style; if (this.resizeFrame) { s.width = (parseInt(el.offsetWidth) - (2*this.borderWidth)) + "px"; s.height = (parseInt(el.offsetHeight) - (2*this.borderWidth)) + "px"; } if (this.centerFrame) { this.setDelta(Math.round(parseInt(s.width)/2), Math.round(parseInt(s.width)/2)); } this.setDragElPos(iPageX, iPageY); s.visibility = ""; }; // overrides YAHOO.util.DragDrop YAHOO.util.DDProxy.prototype.b4MouseDown = function(e) { var x = YAHOO.util.Event.getPageX(e); var y = YAHOO.util.Event.getPageY(e); this.autoOffset(x, y); this.setDragElPos(x, y); }; // overrides YAHOO.util.DragDrop YAHOO.util.DDProxy.prototype.b4StartDrag = function(x, y) { // show the drag frame this.showFrame(x, y); }; // overrides YAHOO.util.DragDrop YAHOO.util.DDProxy.prototype.b4EndDrag = function(e) { // hide the drag frame var s = this.getDragEl().style; s.visibility = "hidden"; }; // overrides YAHOO.util.DragDrop // By default we try to move the element to the last location of the frame. // This is so that the default behavior mirrors that of YAHOO.util.DD. YAHOO.util.DDProxy.prototype.endDrag = function(e) { var lel = this.getEl(); var del = this.getDragEl(); // Show the drag frame briefly so we can get its position del.style.visibility = ""; // Hide the linked element before the move to get around a Safari // rendering bug. lel.style.visibility = "hidden"; YAHOO.util.DDM.moveToEl(lel, del); del.style.visibility = "hidden"; lel.style.visibility = ""; }; /* Copyright (c) 2006 Yahoo! Inc. All rights reserved. */ /** * @class a DragDrop implementation that does not move, but can be a drop * target. You would get the same result by simply omitting implementation * for the event callbacks, but this way we reduce the processing cost of the * event listener and the callbacks. * * @extends YAHOO.util.DragDrop * @constructor * @param {String} id the id of the element that is a drop target * @param {String} sGroup the group of related DragDrop objects */ YAHOO.util.DDTarget = function(id, sGroup) { if (id) { this.initTarget(id, sGroup); } }; YAHOO.util.DDTarget.prototype = new YAHOO.util.DragDrop();