dojo_src 1.4.102 → 1.5.0

data/dojo/dojox/date/timezone.js

@@ -1,31 +1,14 @@
-/*******************************************************************************
- * timezone.js
- *
+/******************************************************************************
  * Dojo port of fleegix date plugin from
  *
  *   http://js.fleegix.org/plugins/date/date
  *
- * Copyright 2009 Matthew Eernisse (mde@fleegix.org)
+ * contributed to Dojo under CLA, with thanks to Matthew Eernisse (mde@fleegix.org)
  * and Open Source Applications Foundation
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
  * Credits: Ideas included from incomplete JS implementation of Olson
- * parser, "XMLDAte" by Philippe Goetz (philippe.goetz@wanadoo.fr)
- * Additional contributions: Preston Hunt (prestonhunt@gmail.com),
- * Dov. B Katz (dov.katz@morganstanley.com), Peter Bergström
- * (pbergstr@mac.com)
- ******************************************************************************/
+ * parser, "XMLDate" by Philippe Goetz (philippe.goetz@wanadoo.fr)
+ *****************************************************************************/
 dojo.experimental("dojox.date.timezone");
 dojo.provide("dojox.date.timezone");
 
@@ -38,13 +21,13 @@ dojo.require("dojo.date.locale");
 					"southamerica" ];
 					
 	// Our mins an maxes for years that we care about
-	var _minYear = 1835;
-	var _maxYear = 2038;
+	var _minYear = 1835,
+		_maxYear = 2038;
 	
-	var _loadedZones = {};
-	var _zones = {};
-	var _loadedRanges = {};
-	var _rules = {};
+	var _loadedZones = {},
+		_zones = {},
+		_loadedRanges = {},
+		_rules = {};
 	
 	// timezoneFileBasePath: String
 	//		A different location to pull zone files from
@@ -115,7 +98,7 @@ dojo.require("dojo.date.locale");
 	
 	function loadZoneObj(/* Object */ data){
 		// summary:
-		//		Loads the given data obejct into the zone database
+		//		Loads the given data object into the zone database
 		//
 		// data: Object
 		//		The data to load - contains "zones" and "rules" parameters
@@ -131,7 +114,7 @@ dojo.require("dojo.date.locale");
 	
 	function loadZoneFile(/* String */ fileName){
 		// summary:
-		//		Loads the given URL of the olson zone information into the
+		//		Loads the given URL of the Olson zone information into the
 		//		zone database
 		//
 		// fileName: String
@@ -142,7 +125,7 @@ dojo.require("dojo.date.locale");
 		_loadedZones[fileName] = true;
 		_d.xhrGet({
 			url: timezoneFileBasePath + "/" + fileName,
-			sync: true, // Needs to be syncronous so we can return values
+			sync: true, // Needs to be synchronous so we can return values
 			handleAs: "olson-zoneinfo",
 			load: loadZoneObj,
 			error: errorLoadingZoneFile
@@ -150,10 +133,10 @@ dojo.require("dojo.date.locale");
 	}
 	
 	var monthMap = { 'jan': 0, 'feb': 1, 'mar': 2, 'apr': 3,'may': 4, 'jun': 5,
-				'jul': 6, 'aug': 7, 'sep': 8, 'oct': 9, 'nov': 10, 'dec': 11 };
-	var dayMap = {'sun': 0, 'mon': 1, 'tue': 2, 'wed': 3, 'thu': 4, 
-				'fri': 5, 'sat': 6 };
-	var regionMap = {'EST': "northamerica", 'MST': "northamerica",
+				'jul': 6, 'aug': 7, 'sep': 8, 'oct': 9, 'nov': 10, 'dec': 11 },
+		dayMap = {'sun': 0, 'mon': 1, 'tue': 2, 'wed': 3, 'thu': 4, 
+				'fri': 5, 'sat': 6 },
+		regionMap = {'EST': "northamerica", 'MST': "northamerica",
 					'HST': "northamerica", 'EST5EDT': "northamerica",
 					'CST6CDT': "northamerica", 'MST7MDT': "northamerica",
 					'PST8PDT': "northamerica", 'America': "northamerica",
@@ -162,8 +145,8 @@ dojo.require("dojo.date.locale");
 					'Antarctica': "antarctica", 'Asia': "asia", 
 					'Australia': "australasia", 'Europe': "europe",
 					'WET': "europe", 'CET': "europe", 'MET': "europe",
-					'EET': "europe"};
-	var regionExceptions = {'Pacific/Honolulu':"northamerica",
+					'EET': "europe"},
+		regionExceptions = {'Pacific/Honolulu':"northamerica",
 							'Atlantic/Bermuda':"northamerica",
 							'Atlantic/Cape_Verde':"africa",
 							'Atlantic/St_Helena':"africa",
@@ -230,8 +213,8 @@ dojo.require("dojo.date.locale");
 							'America/Paramaribo':"southamerica",
 							'America/Port_of_Spain':"southamerica",
 							'America/Montevideo':"southamerica",
-							'America/Caracas':"southamerica"};
-	var abbrExceptions = { 'US': "S", 'Chatham': "S", 'NZ': "S", 'NT_YK': "S", 
+							'America/Caracas':"southamerica"},
+		abbrExceptions = { 'US': "S", 'Chatham': "S", 'NZ': "S", 'NT_YK': "S", 
 							'Edm': "S", 'Salv': "S", 'Canada': "S", 'StJohns': "S",
 							'TC': "S", 'Guat': "S", 'Mexico': "S", 'Haiti': "S",
 							'Barb': "S", 'Belize': "S", 'CR': "S", 'Moncton': "S",
@@ -254,7 +237,7 @@ dojo.require("dojo.date.locale");
 	
 	function getRegionForTimezone(/* String */ tz) {
 		// summary:
-		//		Returns the olson region for the given timzeone
+		//		Returns the Olson region for the given timezone
 		var ret = regionExceptions[tz];
 		if(!ret){
 			var reg = tz.split('/')[0];
@@ -518,7 +501,7 @@ dojo.require("dojo.date.locale");
 		var t = tz;
 		var zoneList = _zones[t];
 
-		// Follow links to get to an acutal zone
+		// Follow links to get to an actual zone
 		while(typeof zoneList == "string"){
 			t = zoneList;
 			zoneList = _zones[t];
@@ -616,19 +599,41 @@ dojo.require("dojo.date.locale");
 		return res; // String
 	}
 	
+/*=====
+dojox.date.timezone = function(){
+	// summary:
+	//	mix-in to dojo.date to provide timezones based on
+	//	the Olson timezone data
+	//
+	// description:
+	//	mix-in to dojo.date to provide timezones based on
+	//	the Olson timezone data.
+	//	If you pass "timezone" as a parameter to your format options,
+	//	then you get the date formatted (and offset) for that timezone
+
+//TODOC
+};
+
+dojox.date.timezone.getTzInfo = function(dt, tz){
+	// summary:
+	//	Returns the timezone information for the given date and
+	//	timezone string
+	//
+	// dt: Date
+	//	The Date - a "proxyDate"
+	//
+	// tz: String
+	//	String representation of the timezone you want to get info
+	//	for date
+};
+
+dojox.date.timezone.getAllZones = function(){
+	// summary:
+	//	Returns an array of zones that have been loaded
+};
+=====*/
 	_d.setObject("dojox.date.timezone", {
 		getTzInfo: function(/* Date */ dt, /* String */ tz){
-			// summary:
-			//		Returns the timezone information for the given date and
-			//		timezone string
-			//
-			// dt: Date
-			//		The Date - a "proxyDate"
-			//
-			// tz: String
-			//		String representation of the timezone you want to get info
-			//		for date
-
 			// Lazy-load any zones not yet loaded
 			if(loadingScheme == "lazyLoad"){
 				// Get the correct region for the zone
@@ -660,8 +665,6 @@ dojo.require("dojo.date.locale");
 			return { tzOffset: off, tzAbbr: abbr }; // Object
 		},
 		getAllZones: function(){
-			// summary:
-			//		Returns an array of zones that have been loaded
 			var arr = [];
 			for(var z in _zones){ arr.push(z); }
 			arr.sort();
@@ -682,8 +685,8 @@ dojo.require("dojo.date.locale");
 	// And enhance the default formatting functions
 	// If you pass "timezone" as a parameter to your format options,
 	// then you get the date formatted (and offset) for that timezone
-	var oLocaleFmt = _d.date.locale.format;
-	var oGetZone = _d.date.locale._getZone;
+	var oLocaleFmt = _d.date.locale.format,
+		oGetZone = _d.date.locale._getZone;
 	_d.date.locale.format = function(dateObject, options){
 		options = options||{};
 		if(options.timezone && !options._tzInfo){
@@ -700,14 +703,8 @@ dojo.require("dojo.date.locale");
 	};
 	_d.date.locale._getZone = function(dateObject, getName, options){
 		if(options._tzInfo){
-			if(getName){
-				return options._tzInfo.tzAbbr;
-			}else{
-				return options._tzInfo.tzOffset;
-			}
+			return getName ? options._tzInfo.tzAbbr : options._tzInfo.tzOffset;
 		}
 		return oGetZone.call(this, dateObject, getName, options);
 	};
-	
-	
 })(dojo);

data/dojo/dojox/dnd/BoundingBoxController.js

@@ -0,0 +1,130 @@
+dojo.provide("dojox.dnd.BoundingBoxController");
+
+dojo.declare(
+	"dojox.dnd.BoundingBoxController",
+	null,
+	{
+		// summary: Allows the user draw bounding boxes around nodes on the page.
+		// Publishes to the "/dojox/dnd/bounding" topic to tell the selector to check
+		// to see whether any dnd items fall within the coordinates of the bounding box 
+		
+		// x,y start and end coordinates for the bounding box
+		_startX: null,
+		_startY: null,
+		_endX: null,
+		_endY: null,
+
+		constructor: function(sources, domNode){
+			//	summary:
+			//		Sets mouse handlers for the document to capture when a user
+			//		is trying to draw a bounding box.
+			//	sources: Array:
+			//		an array of dojox.dnd.Selectors which need to be aware of
+			//		the positioning of the bounding box.
+			//	domNode: String|DomNode:
+			//		the DOM node or id which represents the bounding box on the page.
+			this.events = [
+				dojo.connect(dojo.doc, "onmousedown", this, "_onMouseDown"),
+				dojo.connect(dojo.doc, "onmouseup",   this, "_onMouseUp"),
+				// cancel text selection and text dragging
+				//dojo.connect(dojo.doc, "ondragstart",   dojo.stopEvent),
+				//dojo.connect(dojo.doc, "onselectstart", dojo.stopEvent),
+				// when a user is scrolling using a scrollbar, don't draw the bounding box.
+				dojo.connect(dojo.doc, "onscroll", this, "_finishSelecting")
+			];
+			// set up a subscription so the client can easily cancel a user drawing a bounding box.
+			this.subscriptions = [
+				dojo.subscribe("/dojox/bounding/cancel", this, "_finishSelecting")
+			];
+			dojo.forEach(sources, function(item){
+				// listen for "/dojox/dnd/bounding" events eminating from the bounding box.
+				// for each of the dojox.dnd.selectors passed in args.
+				if(item.selectByBBox){
+					this.subscriptions.push(dojo.subscribe("/dojox/dnd/bounding", item, "selectByBBox"));
+				}
+			}, this)
+			this.domNode = dojo.byId(domNode);
+			dojo.style(this.domNode, {
+				position: "absolute",
+				display:  "none"
+			});
+		},
+		
+		destroy: function(){
+			// summary:
+			//		prepares this object to be garbage-collected
+			dojo.forEach(this.events, dojo.disconnect);
+			dojo.forEach(this.subscriptions, dojo.unsubscribe);
+			this.domNode = null;
+		},
+		
+		boundingBoxIsViable: function(){
+			// summary: Override-able by the client as an extra check to ensure that a bounding
+			// box is viable. In some instances, it might not make sense that
+			// a mouse down -> mouse move -> mouse up interaction represents a bounding box.
+			// For example, if a dialog is open the client might want to suppress a bounding
+			// box. This function could be used by the client to ensure that a bounding box is only
+			// drawn on the document when certain conditions are met.
+			return true;
+		},
+		
+		_onMouseDown: function(evt){
+			// summary: Executed when the user mouses down on the document. Resets the
+			// this._startX and this._startY member variables.
+			// evt: Object: the mouse event which caused this callback to fire.
+			if(dojo.mouseButtons.isLeft(evt)){
+				if(this._startX === null){
+					this._startX = evt.clientX;
+					this._startY = evt.clientY;
+				}
+				this.events.push(
+					dojo.connect(dojo.doc, "onmousemove", this, "_onMouseMove")
+				);
+			}
+		},
+		
+		_onMouseMove: function(evt){
+			// summary: Executed when the user moves the mouse over the document. Delegates to
+			// this._drawBoundingBox if the user is trying to draw a bounding box.
+		 	// whether the user was drawing a bounding box and publishes to the
+		 	// "/dojox/dnd/bounding" topic if the user is finished drawing their bounding box.
+			// evt: Object: the mouse event which caused this callback to fire.
+			this._endX = evt.clientX;
+			this._endY = evt.clientY;
+			this._drawBoundingBox();
+		},
+
+		_onMouseUp: function(evt){
+			// summary: Executed when the users mouses up on the document. Checks to see
+		 	// whether the user was drawing a bounding box and publishes to the
+		 	// "/dojox/dnd/bounding" topic if the user is finished drawing their bounding box.
+			// evt: Object: the mouse event which caused this callback to fire.
+			if(this._endX !== null && this.boundingBoxIsViable()){
+				// the user has moused up ... tell the selector to check to see whether
+				// any nodes within the bounding box need to be selected.
+				dojo.publish("/dojox/dnd/bounding", [this._startX, this._startY, this._endX, this._endY]);
+			}
+			this._finishSelecting();
+		},
+		
+		_finishSelecting: function(){
+			// summary: hide the bounding box and reset for the next time around
+			if(this._startX !== null){
+				dojo.disconnect(this.events.pop());
+				dojo.style(this.domNode, "display", "none");
+				this._startX = this._endX = null;
+			}
+		},
+		
+		_drawBoundingBox: function(){
+			// summary: draws the bounding box over the document.
+			dojo.style(this.domNode, {
+				left:     Math.min(this._startX, this._endX) + "px",
+				top:      Math.min(this._startY, this._endY) + "px",
+				width:    Math.abs(this._startX - this._endX) + "px",
+				height:   Math.abs(this._startY - this._endY) + "px",
+				display:  ""
+			});
+		}
+	}
+);

data/dojo/dojox/dnd/README

@@ -0,0 +1,22 @@
+-------------------------------------------------------------------------------
+dojox.dnd Simple extensions to dojo.dnd.
+-------------------------------------------------------------------------------
+Version 1.0
+Release date: 2/1/2010
+-------------------------------------------------------------------------------
+Project state: beta
+-------------------------------------------------------------------------------
+Credits
+
+Sean O' Shea
+Arech
+Eugene Lazutkin
+-------------------------------------------------------------------------------
+Project description
+
+Extending and augmenting dojo.dnd, a clearing house for future dojo.dnd
+additions.
+-------------------------------------------------------------------------------
+Dependencies
+
+	require Dojo Core

data/dojo/dojox/dnd/Selector.js

@@ -0,0 +1,159 @@
+dojo.provide("dojox.dnd.Selector");
+
+dojo.require("dojo.dnd.Selector");
+
+dojo.declare(
+	"dojox.dnd.Selector",
+	dojo.dnd.Selector,
+	{
+		isSelected: function(node){
+			//	summary:
+			//		checks if node is selected
+			//	node: String|DomNode:
+			//		Node to check (id or DOM Node)
+			var id = dojo.isString(node) ? node : node.id,
+				item = this.getItem(id);
+			return item && this.selected[id];	// Boolean
+		},
+		
+		selectNode: function(node, add){
+			//	summary:
+			//		selects a node
+			//	node: String|DomNode:
+			//		Node to select (id or DOM Node)
+			//	add: Boolean?:
+			//		If true, node is added to selection, otherwise current
+			//		selection is removed, and node will be the only selection.
+			if(!add){
+				this.selectNone();
+			}
+			var id = dojo.isString(node) ? node : node.id,
+				item = this.getItem(id);
+			if(item){
+				this._removeAnchor();
+				this.anchor = dojo.byId(node);
+				this._addItemClass(this.anchor, "Anchor");
+				this.selection[id] = 1;
+				this._addItemClass(this.anchor, "Selected");
+			}
+			return this;	// self
+		},
+		
+		deselectNode: function(node){
+			//	summary:
+			//		deselects a node
+			//	node: String|DomNode:
+			//		Node to deselect (id or DOM Node)
+			var id = dojo.isString(node) ? node : node.id,
+				item = this.getItem(id);
+			if(item && this.selection[id]){
+				if(this.anchor === dojo.byId(node)){
+					this._removeAnchor();
+				}
+				delete this.selection[id];
+				this._removeItemClass(this.anchor, "Selected");
+			}
+			return this;	// self
+		},
+		
+		selectByBBox: function(left, top, right, bottom, add) {
+			//	summary:
+			//		selects nodes by bounding box
+			//	left: Number:
+			//		Left coordinate of the bounding box
+			//	top: Number:
+			//		Top coordinate of the bounding box
+			//	right: Number:
+			//		Right coordinate of the bounding box
+			//	bottom: Number:
+			//		Bottom coordinate of the bounding box
+			//	add: Boolean?:
+			//		If true, node is added to selection, otherwise current
+			//		selection is removed, and node will be the only selection.
+
+			// user has drawn a bounding box ... time to see whether any dom nodes
+			// in this container satisfy the bounding box range.
+			if(!add){
+				this.selectNone();
+			}
+			this.forInItems(function(data, id){
+				var node = dojo.byId(id);
+				if(node && this._isBoundedByBox(node, left, top, right, bottom)){
+					this.selectNode(id, true);
+				}
+			}, this);
+			return this;	// self
+		},
+		
+		_isBoundedByBox: function(node, left, top, right, bottom) {
+			//	summary:
+			//		figures out whether certain coodinates bound a particular
+			//		dom node.
+			//	node: String|DomNode:
+			//		Node to check (id or DOM Node)
+			//	left: Number:
+			//		Left coordinate of the bounding box
+			//	top: Number:
+			//		Top coordinate of the bounding box
+			//	right: Number:
+			//		Right coordinate of the bounding box
+			//	bottom: Number:
+			//		Bottom coordinate of the bounding box
+			var c = dojo.coords(node), t;
+			// normalize input
+			if(left > right){
+				t = left;
+				left = right;
+				right = t;
+			}
+			if(top > bottom){
+				t = top;
+				top = bottom;
+				bottom = t;
+			}
+			return c.x >= left && c.x + c.w <= right && c.y >= top && c.y + c.h <= bottom;	// Boolean
+		},
+		
+		shift: function(toNext, add) {
+			//	summary:
+			//		shifts the currently selected dnd item forwards and backwards.
+			//		One possible use would be to allow a user select different
+			//		dnd items using the right and left keys.
+			//	toNext: Boolean:
+			//		If true, we select the next node, otherwise the previous one.
+			//	add: Boolean?:
+			//		If true, add to selection, otherwise current selection is
+			//		removed before adding any nodes.
+			var selectedNodes = this.getSelectedNodes();
+			if(selectedNodes && selectedNodes.length) {
+				// only delegate to selectNode if at least one node is selected.
+				// If multiple nodes are selected assume that we go with
+				// the last selected node.
+				this.selectNode(this._getNodeId(selectedNodes[selectedNodes.length - 1].id, toNext), add);
+			}
+		},
+
+		_getNodeId: function(nodeId, toNext) {
+			//	summary:
+			//		finds a next/previous node in relation to nodeId
+			//	nodeId: String:
+			//		the id of the node to use as the base node
+			//	toNext: Boolean:
+			//		If true, we select the next node, otherwise the previous one.
+			var allNodes = this.getAllNodes(), newId = nodeId;
+			for(var i = 0, l = allNodes.length; i < l; ++i) {
+				if(allNodes[i].id == nodeId) {
+					// have a match ... make sure we don't go outside
+					var j = Math.min(l - 1, Math.max(0, i + (toNext ? 1 : -1)));
+					if(i != j){
+						// we should be fine to go with the id the user has requested.
+						newId = allNodes[j].id;
+					}
+					break;
+				}
+			}
+			// if we don't get a match, the newId defaults to the currently selected node
+			return newId;
+		}
+	}
+);