dojo_src 1.4.102 → 1.5.0

data/dojo/dojo/_base/NodeList.js

@@ -604,11 +604,11 @@ dojo.require("dojo._base.array");
 			//		if no value is passed, the result is an array of attribute values
 			//		If a value is passed, the return is this NodeList
 			//	example:
-			//		Make all nodes with a particular class focusabl:
+			//		Make all nodes with a particular class focusable:
 			//	|	dojo.query(".focusable").attr("tabIndex", -1);
 			//	example:
 			//		Disable a group of buttons:
-			//	|	dojo.query("button.group").attr("disalbed", true);
+			//	|	dojo.query("button.group").attr("disabled", true);
 			//	example:
 			//		innerHTML can be assigned or retreived as well:
 			//	|	// get the innerHTML (as an array) for each list item
@@ -932,13 +932,34 @@ dojo.require("dojo._base.array");
 			//	summary:
 			//		Returns a new NodeList comprised of items in this NodeList
 			//		at the given index or indices.
+			//
 			//	index: Integer...
 			//		One or more 0-based indices of items in the current
-			//		NodeList.
+			//		NodeList. A negative index will start at the end of the
+			//		list and go backwards. 
+			//
+			//	example:
+			//	Shorten the list to the first, second, and third elements
+			//	|	dojo.query("a").at(0, 1, 2).forEach(fn); 
+			//
+			//	example:
+			//	Retrieve the first and last elements of a unordered list:
+			//	|	dojo.query("ul > li").at(0, -1).forEach(cb);
+			//
+			//	example:
+			//	Do something for the first element only, but end() out back to
+			//	the original list and continue chaining:
+			//	|	dojo.query("a").at(0).onclick(fn).end().forEach(function(n){
+			//	|		console.log(n); // all anchors on the page. 
+			//	|	})	
+			//
 			//	returns:
 			//		dojo.NodeList
 			var t = new this._NodeListCtor();
-			d.forEach(arguments, function(i){ if(this[i]){ t.push(this[i]); }}, this);
+			d.forEach(arguments, function(i){ 
+				if(i < 0){ i = this.length + i }
+				if(this[i]){ t.push(this[i]); }
+			}, this);
 			return t._stash(this); // dojo.NodeList
 		}
 
@@ -950,10 +971,12 @@ dojo.require("dojo._base.array");
 		"keyup", "load", "mousedown", "mouseenter", "mouseleave", "mousemove",
 		"mouseout", "mouseover", "mouseup", "submit"
 	];
+	
+	// FIXME: pseudo-doc the above automatically generated on-event functions
 
 	// syntactic sugar for DOM events
 	d.forEach(nl.events, function(evt){
-			var _oe = "on"+evt;
+			var _oe = "on" + evt;
 			nlp[_oe] = function(a, b){
 				return this.connect(_oe, a, b);
 			}

data/dojo/dojo/_base/_loader/bootstrap.js

@@ -218,7 +218,7 @@ dojo.global = {
 =====*/
 	dojo.locale = d.config.locale;
 
-	var rev = "$Rev: 21516 $".match(/\d+/);
+	var rev = "$Rev: 22487 $".match(/\d+/);
 
 /*=====
 	dojo.version = function(){
@@ -242,7 +242,7 @@ dojo.global = {
 	}
 =====*/
 	dojo.version = {
-		major: 1, minor: 4, patch: 2, flag: "",
+		major: 1, minor: 5, patch: 0, flag: "",
 		revision: rev ? +rev[0] : NaN,
 		toString: function(){
 			with(d.version){
@@ -443,28 +443,17 @@ dojo.global = {
 		return !!d.getObject(name, false, obj); // Boolean
 	}
 
-
 	dojo["eval"] = function(/*String*/ scriptFragment){
 		//	summary:
-		//		Perform an evaluation in the global scope. Use this rather than
-		//		calling 'eval()' directly.
+		//		A legacy method created for use exclusively by internal Dojo methods. Do not use
+		//		this method directly, the behavior of this eval will differ from the normal
+		//		browser eval.
 		//	description:
 		//		Placed in a separate function to minimize size of trapped
 		//		exceptions. Calling eval() directly from some other scope may
 		//		complicate tracebacks on some platforms.
 		//	returns:
 		//		The result of the evaluation. Often `undefined`
-
-
-		// note:
-		//	 - JSC eval() takes an optional second argument which can be 'unsafe'.
-		//	 - Mozilla/SpiderMonkey eval() takes an optional second argument which is the
-		//  	 scope object for new symbols.
-
-		// FIXME: investigate Joseph Smarr's technique for IE:
-		//		http://josephsmarr.com/2007/01/31/fixing-eval-to-use-global-scope-in-ie/
-		//	see also:
-		// 		http://trac.dojotoolkit.org/ticket/744
 		return d.global.eval ? d.global.eval(scriptFragment) : eval(scriptFragment); 	// Object
 	}
 

data/dojo/dojo/_base/_loader/hostenv_browser.js

@@ -212,7 +212,8 @@ if(typeof window != 'undefined'){
 			return (stat >= 200 && stat < 300) || 	// Boolean
 				stat == 304 || 						// allow any 2XX response code
 				stat == 1223 || 						// get it out of the cache
-				(!stat && (lp == "file:" || lp == "chrome:" || lp == "app:") ); // Internet Explorer mangled the status code OR we're Titanium requesting a local file
+				// Internet Explorer mangled the status code OR we're Titanium/browser chrome/chrome extension requesting a local file
+				(!stat && (lp == "file:" || lp == "chrome:" || lp == "chrome-extension:" || lp == "app:") );
 		}
 
 		//See if base tag is in use.
@@ -300,6 +301,7 @@ if(typeof window != 'undefined'){
 			while(mll.length){
 				(mll.pop())();
 			}
+			d = null;
 		};
 
 		var _onWindowUnloadAttached = 0;
@@ -370,6 +372,11 @@ if(typeof window != 'undefined'){
 	//START DOMContentLoaded
 	dojo._initFired = false;
 	dojo._loadInit = function(e){
+		if(dojo._scrollIntervalId){
+			clearInterval(dojo._scrollIntervalId);
+			dojo._scrollIntervalId = 0;
+		}
+
 		if(!dojo._initFired){
 			dojo._initFired = true;
 
@@ -384,7 +391,7 @@ if(typeof window != 'undefined'){
 		}
 	}
 
-	if(!dojo.config.afterOnLoad){
+	if(!dojo.config.afterOnLoad){		
 		if(document.addEventListener){
 			//Standards. Hooray! Assumption here that if standards based,
 			//it knows about DOMContentLoaded. It is OK if it does not, the fall through
@@ -393,34 +400,45 @@ if(typeof window != 'undefined'){
 			window.addEventListener("load", dojo._loadInit, false);
 		}else if(window.attachEvent){
 			window.attachEvent("onload", dojo._loadInit);
+
+			//DOMContentLoaded approximation. Diego Perini found this MSDN article
+			//that indicates doScroll is available after DOM ready, so do a setTimeout
+			//to check when it is available.
+			//http://msdn.microsoft.com/en-us/library/ms531426.aspx
+			if(!dojo.config.skipIeDomLoaded && self === self.top){
+				dojo._scrollIntervalId = setInterval(function (){
+					try{
+						//When dojo is loaded into an iframe in an IE HTML Application 
+						//(HTA), such as in a selenium test, javascript in the iframe
+						//can't see anything outside of it, so self===self.top is true,
+						//but the iframe is not the top window and doScroll will be 
+						//available before document.body is set. Test document.body
+						//before trying the doScroll trick
+						if(document.body){
+							document.documentElement.doScroll("left");
+							dojo._loadInit();
+						}
+					}catch (e){}
+				}, 30);
+			}
 		}
 	}
 
 	//>>excludeStart("webkitMobile", kwArgs.webkitMobile);
 	if(dojo.isIE){
-		// 	for Internet Explorer. readyState will not be achieved on init
-		// 	call, but dojo doesn't need it however, we'll include it
-		// 	because we don't know if there are other functions added that
-		// 	might.  Note that this has changed because the build process
-		// 	strips all comments -- including conditional ones.
-		if(!dojo.config.afterOnLoad && !dojo.config.skipIeDomLoaded){
-			document.write('<scr'+'ipt defer src="//:" '
-				+ 'onreadystatechange="if(this.readyState==\'complete\'){' + dojo._scopeName + '._loadInit();}">'
-				+ '</scr'+'ipt>'
-			);
-		}
-
 		try{
-			document.namespaces.add("v","urn:schemas-microsoft-com:vml");
-			var vmlElems = ["*", "group", "roundrect", "oval", "shape", "rect", "imagedata"],
-				i = 0, l = 1, s = document.createStyleSheet();
-			if(dojo.isIE >= 8){
-				i = 1;
-				l = vmlElems.length;
-			}
-			for(; i < l; ++i){
-				s.addRule("v\\:" + vmlElems[i], "behavior:url(#default#VML); display:inline-block");
-			}
+			(function(){
+				document.namespaces.add("v", "urn:schemas-microsoft-com:vml");
+				var vmlElems = ["*", "group", "roundrect", "oval", "shape", "rect", "imagedata", "path", "textpath", "text"],
+					i = 0, l = 1, s = document.createStyleSheet();
+				if(dojo.isIE >= 8){
+					i = 1;
+					l = vmlElems.length;
+				}
+				for(; i < l; ++i){
+					s.addRule("v\\:" + vmlElems[i], "behavior:url(#default#VML); display:inline-block");
+				}
+			})();
 		}catch(e){}
 	}
 	//>>excludeEnd("webkitMobile");

data/dojo/dojo/_base/connect.js

@@ -19,7 +19,7 @@ dojo._listener = {
 			// return value comes from original target function
 			var r = t && t.apply(this, arguments);
 			// make local copy of listener array so it is immutable during processing
-			var lls;
+			var i, lls;
 			//>>includeStart("connectRhino", kwArgs.profileProperties.hostenvType == "rhino");
 			if(!dojo.isRhino){
 			//>>includeEnd("connectRhino");
@@ -33,21 +33,21 @@ dojo._listener = {
 				// results in [0, 1, 2, 3, 4], where element 1 and 3 have value 'undefined'
 				// "A.slice(0)" has the same behavior.
 				lls = [];
-				for(var i in ls){
+				for(i in ls){
 					lls[i] = ls[i];
 				}
 			}
 			//>>includeEnd("connectRhino");
 
 			// invoke listeners after target function
-			for(var i in lls){
+			for(i in lls){
 				if(!(i in ap)){
 					lls[i].apply(this, arguments);
 				}
 			}
 			// return value comes from original target function
 			return r;
-		}
+		};
 	},
 	// add a listener to an object
 	add: function(/*Object*/ source, /*String*/ method, /*Function*/ listener){
@@ -62,7 +62,7 @@ dojo._listener = {
 		// The source method is either null, a dispatcher, or some other function
 		var f = source[method];
 		// Ensure a dispatcher
-		if(!f||!f._listeners){
+		if(!f || !f._listeners){
 			var d = dojo._listener.getDispatcher();
 			// original target function is special
 			d.target = f;
@@ -79,11 +79,11 @@ dojo._listener = {
 		// in non-IE browsers.
 		//
 		// We could have separate lists of before and after listeners.
-		return f._listeners.push(listener) ; /*Handle*/
+		return f._listeners.push(listener); /*Handle*/
 	},
 	// remove a listener from an object
 	remove: function(/*Object*/ source, /*String*/ method, /*Handle*/ handle){
-		var f = (source||dojo.global)[method];
+		var f = (source || dojo.global)[method];
 		// remember that handle is the index+1 (0 is not a valid handle)
 		if(f && f._listeners && handle--){
 			delete f._listeners[handle];
@@ -111,7 +111,7 @@ dojo.connect = function(/*Object|null*/ obj,
 	//
 	// description:
 	//		Connects listeners to actions, so that after event fires, a
-	//		listener is called with the same arguments passed to the orginal
+	//		listener is called with the same arguments passed to the original
 	//		function.
 	//
 	//		Since `dojo.connect` allows the source of events to be either a
@@ -124,7 +124,7 @@ dojo.connect = function(/*Object|null*/ obj,
 	//		When setting up a connection, the `event` parameter must be a
 	//		string that is the name of the method/event to be listened for. If
 	//		`obj` is null, `dojo.global` is assumed, meaning that connections
-	//		to global methods are supported but also that you may inadvertantly
+	//		to global methods are supported but also that you may inadvertently
 	//		connect to a global by passing an incorrect object name or invalid
 	//		reference.
 	//
@@ -132,7 +132,7 @@ dojo.connect = function(/*Object|null*/ obj,
 	//		function or method that does not yet exist on `obj`, connect will
 	//		not fail, but will instead set up a stub method. Similarly, null
 	//		arguments may simply be omitted such that fewer than 4 arguments
-	//		may be required to set up a connection See the examples for deails.
+	//		may be required to set up a connection See the examples for details.
 	//
 	//		The return value is a handle that is needed to 
 	//		remove this connection with `dojo.disconnect`.
@@ -201,7 +201,7 @@ dojo.connect = function(/*Object|null*/ obj,
 
 	// normalize arguments
 	var a=arguments, args=[], i=0;
-	// if a[0] is a String, obj was ommited
+	// if a[0] is a String, obj was omitted
 	args.push(dojo.isString(a[0]) ? null : a[i++], a[i++]);
 	// if the arg-after-next is a String or Function, context was NOT omitted
 	var a1 = a[i+1];
@@ -297,7 +297,7 @@ dojo.connectPublisher = function(	/*String*/ topic,
 									/*Object|null*/ obj, 
 									/*String*/ event){
 	//	summary:
-	//	 	Ensure that everytime obj.event() is called, a message is published
+	//	 	Ensure that every time obj.event() is called, a message is published
 	//	 	on the topic. Returns a handle which can be passed to
 	//	 	dojo.disconnect() to disable subsequent automatic publication on
 	//	 	the topic.
@@ -312,5 +312,5 @@ dojo.connectPublisher = function(	/*String*/ topic,
 	//	example:
 	//	|	dojo.connectPublisher("/ajax/start", dojo, "xhrGet");
 	var pf = function(){ dojo.publish(topic, arguments); }
-	return (event) ? dojo.connect(obj, event, pf) : dojo.connect(obj, pf); //Handle
+	return event ? dojo.connect(obj, event, pf) : dojo.connect(obj, pf); //Handle
 };

data/dojo/dojo/_base/declare.js

@@ -18,7 +18,9 @@ dojo.require("dojo._base.array");
 		for(; i < l; ++i){
 			base = bases[i];
 			if(!base){
-				err("mixin #" + i + " is null");
+				err("mixin #" + i + " is unknown. Did you use dojo.require to pull it in?");
+			}else if(opts.call(base) != "[object Function]"){
+				err("mixin #" + i + " is not a callable constructor.");
 			}
 			lin = base._meta ? base._meta.bases : [base];
 			top = 0;
@@ -165,7 +167,7 @@ dojo.require("dojo._base.array");
 						if(meta && meta.ctor === caller){
 							break;
 						}
-					};
+					}
 					pos = base ? pos : -1;
 				}
 			}
@@ -209,7 +211,24 @@ dojo.require("dojo._base.array");
 		return this instanceof cls;
 	}
 
-	// imlementation of safe mixin function
+	function mixOwn(target, source){
+		var name, i = 0, l = d._extraNames.length;
+		// add props adding metadata for incoming functions skipping a constructor
+		for(name in source){
+			if(name != cname && source.hasOwnProperty(name)){
+				target[name] = source[name];
+			}
+		}
+		// process unenumerable methods on IE
+		for(; i < l; ++i){
+			name = d._extraNames[i];
+			if(name != cname && source.hasOwnProperty(name)){
+				target[name] = source[name];
+			}
+		}
+	}
+
+	// implementation of safe mixin function
 	function safeMixin(target, source){
 		var name, t, i = 0, l = d._extraNames.length;
 		// add props adding metadata for incoming functions skipping a constructor
@@ -248,6 +267,12 @@ dojo.require("dojo._base.array");
 		return function(){
 			var a = arguments, args = a, a0 = a[0], f, i, m,
 				l = bases.length, preArgs;
+
+			if(!(this instanceof a.callee)){
+				// not called via new, so force it
+				return applyNew(a);
+			}
+
 			//this._inherited = {};
 			// perform the shaman's rituals of the original dojo.declare()
 			// 1) call two types of the preamble
@@ -271,7 +296,7 @@ dojo.require("dojo._base.array");
 					if(f){
 						a = f.apply(this, a) || a;
 					}
-					// one pecularity of the preamble:
+					// one peculiarity of the preamble:
 					// it is called if it is not needed,
 					// e.g., there is no constructor to call
 					// let's watch for the last constructor
@@ -304,6 +329,12 @@ dojo.require("dojo._base.array");
 	function singleConstructor(ctor, ctorSpecial){
 		return function(){
 			var a = arguments, t = a, a0 = a[0], f;
+
+			if(!(this instanceof a.callee)){
+				// not called via new, so force it
+				return applyNew(a);
+			}
+
 			//this._inherited = {};
 			// perform the shaman's rituals of the original dojo.declare()
 			// 1) call two types of the preamble
@@ -320,7 +351,7 @@ dojo.require("dojo._base.array");
 				if(f){
 					// process the preamble of this class
 					f.apply(this, t);
-					// one pecularity of the preamble:
+					// one peculiarity of the preamble:
 					// it is called even if it is not needed,
 					// e.g., there is no constructor to call
 					// let's watch for the last constructor
@@ -342,7 +373,13 @@ dojo.require("dojo._base.array");
 	// plain vanilla constructor (can use inherited() to call its base constructor)
 	function simpleConstructor(bases){
 		return function(){
-			var a = arguments, i = 0, f;
+			var a = arguments, i = 0, f, m;
+
+			if(!(this instanceof a.callee)){
+				// not called via new, so force it
+				return applyNew(a);
+			}
+
 			//this._inherited = {};
 			// perform the shaman's rituals of the original dojo.declare()
 			// 1) do not call the preamble
@@ -380,9 +417,31 @@ dojo.require("dojo._base.array");
 		};
 	}
 
-	d.declare = function(className, superclass, props){
-		var proto, i, t, ctor, name, bases, chains, mixins = 1, parents = superclass;
+	// forceNew(ctor)
+	// return a new object that inherits from ctor.prototype but
+	// without actually running ctor on the object.
+	function forceNew(ctor){
+		// create object with correct prototype using a do-nothing
+		// constructor
+		xtor.prototype = ctor.prototype;
+		var t = new xtor;
+		xtor.prototype = null;	// clean up
+		return t;
+	}
 
+	// applyNew(args)
+	// just like 'new ctor()' except that the constructor and its arguments come
+	// from args, which must be an array or an arguments object
+	function applyNew(args){
+		// create an object with ctor's prototype but without
+		// calling ctor on it.
+		var ctor = args.callee, t = forceNew(ctor);
+		// execute the real constructor on the new object
+		ctor.apply(t, args);
+		return t;
+	}
+
+	d.declare = function(className, superclass, props){
 		// crack parameters
 		if(typeof className != "string"){
 			props = superclass;
@@ -391,6 +450,8 @@ dojo.require("dojo._base.array");
 		}
 		props = props || {};
 
+		var proto, i, t, ctor, name, bases, chains, mixins = 1, parents = superclass;
+
 		// build a prototype
 		if(opts.call(superclass) == "[object Array]"){
 			// C3 MRO
@@ -401,22 +462,26 @@ dojo.require("dojo._base.array");
 		}else{
 			bases = [0];
 			if(superclass){
-				t = superclass._meta;
-				bases = bases.concat(t ? t.bases : superclass);
+				if(opts.call(superclass) == "[object Function]"){
+					t = superclass._meta;
+					bases = bases.concat(t ? t.bases : superclass);
+				}else{
+					err("base class is not a callable constructor.");
+				}
+			}else if(superclass !== null){
+				err("unknown base class. Did you use dojo.require to pull it in?")
 			}
 		}
 		if(superclass){
 			for(i = mixins - 1;; --i){
-				// delegation
-				xtor.prototype = superclass.prototype;
-				proto = new xtor;
+				proto = forceNew(superclass);
 				if(!i){
 					// stop if nothing to add (the last base)
 					break;
 				}
 				// mix in properties
 				t = bases[i];
-				mix(proto, t._meta ? t._meta.hidden : t.prototype);
+				(t._meta ? mixOwn : mix)(proto, t.prototype);
 				// chain in new constructor
 				ctor = new Function;
 				ctor.superclass = superclass;
@@ -434,7 +499,6 @@ dojo.require("dojo._base.array");
 			t.nom = cname;
 			proto.constructor = t;
 		}
-		xtor.prototype = 0;	// cleanup
 
 		// collect chains and flags
 		for(i = mixins - 1; i; --i){ // intentional assignment
@@ -460,7 +524,7 @@ dojo.require("dojo._base.array");
 		ctor.prototype = proto;
 		proto.constructor = ctor;
 
-		// add "standard" methods to the ptototype
+		// add "standard" methods to the prototype
 		proto.getInherited = getInherited;
 		proto.inherited = inherited;
 		proto.isInstanceOf = isInstanceOf;
@@ -883,7 +947,7 @@ dojo.require("dojo._base.array");
 	/*=====
 	Object.isInstanceOf = function(cls){
 		//	summary:
-		//		Checks the inheritance cahin to see if it is inherited from this
+		//		Checks the inheritance chain to see if it is inherited from this
 		//		class.
 		//	cls: Function
 		//		Class constructor.