You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
9828 lines
318 KiB
9828 lines
318 KiB
/* |
|
Copyright (c) 2004-2006, The Dojo Foundation |
|
All Rights Reserved. |
|
|
|
Licensed under the Academic Free License version 2.1 or above OR the |
|
modified BSD license. For more information on Dojo licensing, see: |
|
|
|
http://dojotoolkit.org/community/licensing.shtml |
|
*/ |
|
|
|
if(typeof dojo == "undefined"){ |
|
|
|
// TODOC: HOW TO DOC THE BELOW? |
|
// @global: djConfig |
|
// summary: |
|
// Application code can set the global 'djConfig' prior to loading |
|
// the library to override certain global settings for how dojo works. |
|
// description: The variables that can be set are as follows: |
|
// - isDebug: false |
|
// - allowQueryConfig: false |
|
// - baseScriptUri: "" |
|
// - baseRelativePath: "" |
|
// - libraryScriptUri: "" |
|
// - iePreventClobber: false |
|
// - ieClobberMinimal: true |
|
// - locale: undefined |
|
// - extraLocale: undefined |
|
// - preventBackButtonFix: true |
|
// - searchIds: [] |
|
// - parseWidgets: true |
|
// TODOC: HOW TO DOC THESE VARIABLES? |
|
// TODOC: IS THIS A COMPLETE LIST? |
|
// note: |
|
// 'djConfig' does not exist under 'dojo.*' so that it can be set before the |
|
// 'dojo' variable exists. |
|
// note: |
|
// Setting any of these variables *after* the library has loaded does nothing at all. |
|
// TODOC: is this still true? Release notes for 0.3 indicated they could be set after load. |
|
// |
|
|
|
|
|
//TODOC: HOW TO DOC THIS? |
|
// @global: dj_global |
|
// summary: |
|
// an alias for the top-level global object in the host environment |
|
// (e.g., the window object in a browser). |
|
// description: |
|
// Refer to 'dj_global' rather than referring to window to ensure your |
|
// code runs correctly in contexts other than web browsers (eg: Rhino on a server). |
|
var dj_global = this; |
|
|
|
//TODOC: HOW TO DOC THIS? |
|
// @global: dj_currentContext |
|
// summary: |
|
// Private global context object. Where 'dj_global' always refers to the boot-time |
|
// global context, 'dj_currentContext' can be modified for temporary context shifting. |
|
// dojo.global() returns dj_currentContext. |
|
// description: |
|
// Refer to dojo.global() rather than referring to dj_global to ensure your |
|
// code runs correctly in managed contexts. |
|
var dj_currentContext = this; |
|
|
|
|
|
// **************************************************************** |
|
// global public utils |
|
// TODOC: DO WE WANT TO NOTE THAT THESE ARE GLOBAL PUBLIC UTILS? |
|
// **************************************************************** |
|
|
|
function dj_undef(/*String*/ name, /*Object?*/ object){ |
|
//summary: Returns true if 'name' is defined on 'object' (or globally if 'object' is null). |
|
//description: Note that 'defined' and 'exists' are not the same concept. |
|
return (typeof (object || dj_currentContext)[name] == "undefined"); // Boolean |
|
} |
|
|
|
// make sure djConfig is defined |
|
if(dj_undef("djConfig", this)){ |
|
var djConfig = {}; |
|
} |
|
|
|
//TODOC: HOW TO DOC THIS? |
|
// dojo is the root variable of (almost all) our public symbols -- make sure it is defined. |
|
if(dj_undef("dojo", this)){ |
|
var dojo = {}; |
|
} |
|
|
|
dojo.global = function(){ |
|
// summary: |
|
// return the current global context object |
|
// (e.g., the window object in a browser). |
|
// description: |
|
// Refer to 'dojo.global()' rather than referring to window to ensure your |
|
// code runs correctly in contexts other than web browsers (eg: Rhino on a server). |
|
return dj_currentContext; |
|
} |
|
|
|
// Override locale setting, if specified |
|
dojo.locale = djConfig.locale; |
|
|
|
//TODOC: HOW TO DOC THIS? |
|
dojo.version = { |
|
// summary: version number of this instance of dojo. |
|
major: 0, minor: 4, patch: 2, flag: "", |
|
revision: Number("$Rev: 7616 $".match(/[0-9]+/)[0]), |
|
toString: function(){ |
|
with(dojo.version){ |
|
return major + "." + minor + "." + patch + flag + " (" + revision + ")"; // String |
|
} |
|
} |
|
} |
|
|
|
dojo.evalProp = function(/*String*/ name, /*Object*/ object, /*Boolean?*/ create){ |
|
// summary: Returns 'object[name]'. If not defined and 'create' is true, will return a new Object. |
|
// description: |
|
// Returns null if 'object[name]' is not defined and 'create' is not true. |
|
// Note: 'defined' and 'exists' are not the same concept. |
|
if((!object)||(!name)) return undefined; // undefined |
|
if(!dj_undef(name, object)) return object[name]; // mixed |
|
return (create ? (object[name]={}) : undefined); // mixed |
|
} |
|
|
|
dojo.parseObjPath = function(/*String*/ path, /*Object?*/ context, /*Boolean?*/ create){ |
|
// summary: Parse string path to an object, and return corresponding object reference and property name. |
|
// description: |
|
// Returns an object with two properties, 'obj' and 'prop'. |
|
// 'obj[prop]' is the reference indicated by 'path'. |
|
// path: Path to an object, in the form "A.B.C". |
|
// context: Object to use as root of path. Defaults to 'dojo.global()'. |
|
// create: If true, Objects will be created at any point along the 'path' that is undefined. |
|
var object = (context || dojo.global()); |
|
var names = path.split('.'); |
|
var prop = names.pop(); |
|
for (var i=0,l=names.length;i<l && object;i++){ |
|
object = dojo.evalProp(names[i], object, create); |
|
} |
|
return {obj: object, prop: prop}; // Object: {obj: Object, prop: String} |
|
} |
|
|
|
dojo.evalObjPath = function(/*String*/ path, /*Boolean?*/ create){ |
|
// summary: Return the value of object at 'path' in the global scope, without using 'eval()'. |
|
// path: Path to an object, in the form "A.B.C". |
|
// create: If true, Objects will be created at any point along the 'path' that is undefined. |
|
if(typeof path != "string"){ |
|
return dojo.global(); |
|
} |
|
// fast path for no periods |
|
if(path.indexOf('.') == -1){ |
|
return dojo.evalProp(path, dojo.global(), create); // mixed |
|
} |
|
|
|
//MOW: old 'with' syntax was confusing and would throw an error if parseObjPath returned null. |
|
var ref = dojo.parseObjPath(path, dojo.global(), create); |
|
if(ref){ |
|
return dojo.evalProp(ref.prop, ref.obj, create); // mixed |
|
} |
|
return null; |
|
} |
|
|
|
dojo.errorToString = function(/*Error*/ exception){ |
|
// summary: Return an exception's 'message', 'description' or text. |
|
|
|
// TODO: overriding Error.prototype.toString won't accomplish this? |
|
// ... since natively generated Error objects do not always reflect such things? |
|
if(!dj_undef("message", exception)){ |
|
return exception.message; // String |
|
}else if(!dj_undef("description", exception)){ |
|
return exception.description; // String |
|
}else{ |
|
return exception; // Error |
|
} |
|
} |
|
|
|
dojo.raise = function(/*String*/ message, /*Error?*/ exception){ |
|
// summary: Common point for raising exceptions in Dojo to enable logging. |
|
// Throws an error message with text of 'exception' if provided, or |
|
// rethrows exception object. |
|
|
|
if(exception){ |
|
message = message + ": "+dojo.errorToString(exception); |
|
}else{ |
|
message = dojo.errorToString(message); |
|
} |
|
|
|
// print the message to the user if hostenv.println is defined |
|
try { if(djConfig.isDebug){ dojo.hostenv.println("FATAL exception raised: "+message); } } catch (e) {} |
|
|
|
throw exception || Error(message); |
|
} |
|
|
|
//Stub functions so things don't break. |
|
//TODOC: HOW TO DOC THESE? |
|
dojo.debug = function(){}; |
|
dojo.debugShallow = function(obj){}; |
|
dojo.profile = { start: function(){}, end: function(){}, stop: function(){}, dump: function(){} }; |
|
|
|
function dj_eval(/*String*/ scriptFragment){ |
|
// summary: Perform an evaluation in the global scope. Use this rather than calling 'eval()' directly. |
|
// description: Placed in a separate function to minimize size of trapped evaluation context. |
|
// 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. |
|
return dj_global.eval ? dj_global.eval(scriptFragment) : eval(scriptFragment); // mixed |
|
} |
|
|
|
dojo.unimplemented = function(/*String*/ funcname, /*String?*/ extra){ |
|
// summary: Throw an exception because some function is not implemented. |
|
// extra: Text to append to the exception message. |
|
var message = "'" + funcname + "' not implemented"; |
|
if (extra != null) { message += " " + extra; } |
|
dojo.raise(message); |
|
} |
|
|
|
dojo.deprecated = function(/*String*/ behaviour, /*String?*/ extra, /*String?*/ removal){ |
|
// summary: Log a debug message to indicate that a behavior has been deprecated. |
|
// extra: Text to append to the message. |
|
// removal: Text to indicate when in the future the behavior will be removed. |
|
var message = "DEPRECATED: " + behaviour; |
|
if(extra){ message += " " + extra; } |
|
if(removal){ message += " -- will be removed in version: " + removal; } |
|
dojo.debug(message); |
|
} |
|
|
|
dojo.render = (function(){ |
|
//TODOC: HOW TO DOC THIS? |
|
// summary: Details rendering support, OS and browser of the current environment. |
|
// TODOC: is this something many folks will interact with? If so, we should doc the structure created... |
|
function vscaffold(prefs, names){ |
|
var tmp = { |
|
capable: false, |
|
support: { |
|
builtin: false, |
|
plugin: false |
|
}, |
|
prefixes: prefs |
|
}; |
|
for(var i=0; i<names.length; i++){ |
|
tmp[names[i]] = false; |
|
} |
|
return tmp; |
|
} |
|
|
|
return { |
|
name: "", |
|
ver: dojo.version, |
|
os: { win: false, linux: false, osx: false }, |
|
html: vscaffold(["html"], ["ie", "opera", "khtml", "safari", "moz"]), |
|
svg: vscaffold(["svg"], ["corel", "adobe", "batik"]), |
|
vml: vscaffold(["vml"], ["ie"]), |
|
swf: vscaffold(["Swf", "Flash", "Mm"], ["mm"]), |
|
swt: vscaffold(["Swt"], ["ibm"]) |
|
}; |
|
})(); |
|
|
|
// **************************************************************** |
|
// dojo.hostenv methods that must be defined in hostenv_*.js |
|
// **************************************************************** |
|
|
|
/** |
|
* The interface definining the interaction with the EcmaScript host environment. |
|
*/ |
|
|
|
/* |
|
* None of these methods should ever be called directly by library users. |
|
* Instead public methods such as loadModule should be called instead. |
|
*/ |
|
dojo.hostenv = (function(){ |
|
// TODOC: HOW TO DOC THIS? |
|
// summary: Provides encapsulation of behavior that changes across different 'host environments' |
|
// (different browsers, server via Rhino, etc). |
|
// description: None of these methods should ever be called directly by library users. |
|
// Use public methods such as 'loadModule' instead. |
|
|
|
// default configuration options |
|
var config = { |
|
isDebug: false, |
|
allowQueryConfig: false, |
|
baseScriptUri: "", |
|
baseRelativePath: "", |
|
libraryScriptUri: "", |
|
iePreventClobber: false, |
|
ieClobberMinimal: true, |
|
preventBackButtonFix: true, |
|
delayMozLoadingFix: false, |
|
searchIds: [], |
|
parseWidgets: true |
|
}; |
|
|
|
if (typeof djConfig == "undefined") { djConfig = config; } |
|
else { |
|
for (var option in config) { |
|
if (typeof djConfig[option] == "undefined") { |
|
djConfig[option] = config[option]; |
|
} |
|
} |
|
} |
|
|
|
return { |
|
name_: '(unset)', |
|
version_: '(unset)', |
|
|
|
|
|
getName: function(){ |
|
// sumary: Return the name of the host environment. |
|
return this.name_; // String |
|
}, |
|
|
|
|
|
getVersion: function(){ |
|
// summary: Return the version of the hostenv. |
|
return this.version_; // String |
|
}, |
|
|
|
getText: function(/*String*/ uri){ |
|
// summary: Read the plain/text contents at the specified 'uri'. |
|
// description: |
|
// If 'getText()' is not implemented, then it is necessary to override |
|
// 'loadUri()' with an implementation that doesn't rely on it. |
|
|
|
dojo.unimplemented('getText', "uri=" + uri); |
|
} |
|
}; |
|
})(); |
|
|
|
|
|
dojo.hostenv.getBaseScriptUri = function(){ |
|
// summary: Return the base script uri that other scripts are found relative to. |
|
// TODOC: HUH? This comment means nothing to me. What other scripts? Is this the path to other dojo libraries? |
|
// MAYBE: Return the base uri to scripts in the dojo library. ??? |
|
// return: Empty string or a path ending in '/'. |
|
if(djConfig.baseScriptUri.length){ |
|
return djConfig.baseScriptUri; |
|
} |
|
|
|
// MOW: Why not: |
|
// uri = djConfig.libraryScriptUri || djConfig.baseRelativePath |
|
// ??? Why 'new String(...)' |
|
var uri = new String(djConfig.libraryScriptUri||djConfig.baseRelativePath); |
|
if (!uri) { dojo.raise("Nothing returned by getLibraryScriptUri(): " + uri); } |
|
|
|
// MOW: uri seems to not be actually used. Seems to be hard-coding to djConfig.baseRelativePath... ??? |
|
var lastslash = uri.lastIndexOf('/'); // MOW ??? |
|
djConfig.baseScriptUri = djConfig.baseRelativePath; |
|
return djConfig.baseScriptUri; // String |
|
} |
|
|
|
/* |
|
* loader.js - A bootstrap module. Runs before the hostenv_*.js file. Contains all of the package loading methods. |
|
*/ |
|
|
|
//A semi-colon is at the start of the line because after doing a build, this function definition |
|
//get compressed onto the same line as the last line in bootstrap1.js. That list line is just a |
|
//curly bracket, and the browser complains about that syntax. The semicolon fixes it. Putting it |
|
//here instead of at the end of bootstrap1.js, since it is more of an issue for this file, (using |
|
//the closure), and bootstrap1.js could change in the future. |
|
;(function(){ |
|
//Additional properties for dojo.hostenv |
|
var _addHostEnv = { |
|
pkgFileName: "__package__", |
|
|
|
// for recursion protection |
|
loading_modules_: {}, |
|
loaded_modules_: {}, |
|
addedToLoadingCount: [], |
|
removedFromLoadingCount: [], |
|
|
|
inFlightCount: 0, |
|
|
|
// FIXME: it should be possible to pull module prefixes in from djConfig |
|
modulePrefixes_: { |
|
dojo: {name: "dojo", value: "src"} |
|
}, |
|
|
|
setModulePrefix: function(/*String*/module, /*String*/prefix){ |
|
// summary: establishes module/prefix pair |
|
this.modulePrefixes_[module] = {name: module, value: prefix}; |
|
}, |
|
|
|
moduleHasPrefix: function(/*String*/module){ |
|
// summary: checks to see if module has been established |
|
var mp = this.modulePrefixes_; |
|
return Boolean(mp[module] && mp[module].value); // Boolean |
|
}, |
|
|
|
getModulePrefix: function(/*String*/module){ |
|
// summary: gets the prefix associated with module |
|
if(this.moduleHasPrefix(module)){ |
|
return this.modulePrefixes_[module].value; // String |
|
} |
|
return module; // String |
|
}, |
|
|
|
getTextStack: [], |
|
loadUriStack: [], |
|
loadedUris: [], |
|
|
|
//WARNING: This variable is referenced by packages outside of bootstrap: FloatingPane.js and undo/browser.js |
|
post_load_: false, |
|
|
|
//Egad! Lots of test files push on this directly instead of using dojo.addOnLoad. |
|
modulesLoadedListeners: [], |
|
unloadListeners: [], |
|
loadNotifying: false |
|
}; |
|
|
|
//Add all of these properties to dojo.hostenv |
|
for(var param in _addHostEnv){ |
|
dojo.hostenv[param] = _addHostEnv[param]; |
|
} |
|
})(); |
|
|
|
dojo.hostenv.loadPath = function(/*String*/relpath, /*String?*/module, /*Function?*/cb){ |
|
// summary: |
|
// Load a Javascript module given a relative path |
|
// |
|
// description: |
|
// Loads and interprets the script located at relpath, which is relative to the |
|
// script root directory. If the script is found but its interpretation causes |
|
// a runtime exception, that exception is not caught by us, so the caller will |
|
// see it. We return a true value if and only if the script is found. |
|
// |
|
// For now, we do not have an implementation of a true search path. We |
|
// consider only the single base script uri, as returned by getBaseScriptUri(). |
|
// |
|
// relpath: A relative path to a script (no leading '/', and typically |
|
// ending in '.js'). |
|
// module: A module whose existance to check for after loading a path. |
|
// Can be used to determine success or failure of the load. |
|
// cb: a callback function to pass the result of evaluating the script |
|
|
|
var uri; |
|
if(relpath.charAt(0) == '/' || relpath.match(/^\w+:/)){ |
|
// dojo.raise("relpath '" + relpath + "'; must be relative"); |
|
uri = relpath; |
|
}else{ |
|
uri = this.getBaseScriptUri() + relpath; |
|
} |
|
if(djConfig.cacheBust && dojo.render.html.capable){ |
|
uri += "?" + String(djConfig.cacheBust).replace(/\W+/g,""); |
|
} |
|
try{ |
|
return !module ? this.loadUri(uri, cb) : this.loadUriAndCheck(uri, module, cb); // Boolean |
|
}catch(e){ |
|
dojo.debug(e); |
|
return false; // Boolean |
|
} |
|
} |
|
|
|
dojo.hostenv.loadUri = function(/*String (URL)*/uri, /*Function?*/cb){ |
|
// summary: |
|
// Loads JavaScript from a URI |
|
// |
|
// description: |
|
// Reads the contents of the URI, and evaluates the contents. This is used to load modules as well |
|
// as resource bundles. Returns true if it succeeded. Returns false if the URI reading failed. |
|
// Throws if the evaluation throws. |
|
// |
|
// uri: a uri which points at the script to be loaded |
|
// cb: a callback function to process the result of evaluating the script as an expression, typically |
|
// used by the resource bundle loader to load JSON-style resources |
|
|
|
if(this.loadedUris[uri]){ |
|
return true; // Boolean |
|
} |
|
var contents = this.getText(uri, null, true); |
|
if(!contents){ return false; } // Boolean |
|
this.loadedUris[uri] = true; |
|
if(cb){ contents = '('+contents+')'; } |
|
var value = dj_eval(contents); |
|
if(cb){ cb(value); } |
|
return true; // Boolean |
|
} |
|
|
|
// FIXME: probably need to add logging to this method |
|
dojo.hostenv.loadUriAndCheck = function(/*String (URL)*/uri, /*String*/moduleName, /*Function?*/cb){ |
|
// summary: calls loadUri then findModule and returns true if both succeed |
|
var ok = true; |
|
try{ |
|
ok = this.loadUri(uri, cb); |
|
}catch(e){ |
|
dojo.debug("failed loading ", uri, " with error: ", e); |
|
} |
|
return Boolean(ok && this.findModule(moduleName, false)); // Boolean |
|
} |
|
|
|
dojo.loaded = function(){ } |
|
dojo.unloaded = function(){ } |
|
|
|
dojo.hostenv.loaded = function(){ |
|
this.loadNotifying = true; |
|
this.post_load_ = true; |
|
var mll = this.modulesLoadedListeners; |
|
for(var x=0; x<mll.length; x++){ |
|
mll[x](); |
|
} |
|
|
|
//Clear listeners so new ones can be added |
|
//For other xdomain package loads after the initial load. |
|
this.modulesLoadedListeners = []; |
|
this.loadNotifying = false; |
|
|
|
dojo.loaded(); |
|
} |
|
|
|
dojo.hostenv.unloaded = function(){ |
|
var mll = this.unloadListeners; |
|
while(mll.length){ |
|
(mll.pop())(); |
|
} |
|
dojo.unloaded(); |
|
} |
|
|
|
dojo.addOnLoad = function(/*Object?*/obj, /*String|Function*/functionName) { |
|
// summary: |
|
// Registers a function to be triggered after the DOM has finished loading |
|
// and widgets declared in markup have been instantiated. Images and CSS files |
|
// may or may not have finished downloading when the specified function is called. |
|
// (Note that widgets' CSS and HTML code is guaranteed to be downloaded before said |
|
// widgets are instantiated.) |
|
// |
|
// usage: |
|
// dojo.addOnLoad(functionPointer) |
|
// dojo.addOnLoad(object, "functionName") |
|
|
|
var dh = dojo.hostenv; |
|
if(arguments.length == 1) { |
|
dh.modulesLoadedListeners.push(obj); |
|
} else if(arguments.length > 1) { |
|
dh.modulesLoadedListeners.push(function() { |
|
obj[functionName](); |
|
}); |
|
} |
|
|
|
//Added for xdomain loading. dojo.addOnLoad is used to |
|
//indicate callbacks after doing some dojo.require() statements. |
|
//In the xdomain case, if all the requires are loaded (after initial |
|
//page load), then immediately call any listeners. |
|
if(dh.post_load_ && dh.inFlightCount == 0 && !dh.loadNotifying){ |
|
dh.callLoaded(); |
|
} |
|
} |
|
|
|
dojo.addOnUnload = function(/*Object?*/obj, /*String|Function?*/functionName){ |
|
// summary: registers a function to be triggered when the page unloads |
|
// |
|
// usage: |
|
// dojo.addOnLoad(functionPointer) |
|
// dojo.addOnLoad(object, "functionName") |
|
var dh = dojo.hostenv; |
|
if(arguments.length == 1){ |
|
dh.unloadListeners.push(obj); |
|
} else if(arguments.length > 1) { |
|
dh.unloadListeners.push(function() { |
|
obj[functionName](); |
|
}); |
|
} |
|
} |
|
|
|
dojo.hostenv.modulesLoaded = function(){ |
|
if(this.post_load_){ return; } |
|
if(this.loadUriStack.length==0 && this.getTextStack.length==0){ |
|
if(this.inFlightCount > 0){ |
|
dojo.debug("files still in flight!"); |
|
return; |
|
} |
|
dojo.hostenv.callLoaded(); |
|
} |
|
} |
|
|
|
dojo.hostenv.callLoaded = function(){ |
|
//The "object" check is for IE, and the other opera check fixes an issue |
|
//in Opera where it could not find the body element in some widget test cases. |
|
//For 0.9, maybe route all browsers through the setTimeout (need protection |
|
//still for non-browser environments though). This might also help the issue with |
|
//FF 2.0 and freezing issues where we try to do sync xhr while background css images |
|
//are being loaded (trac #2572)? Consider for 0.9. |
|
if(typeof setTimeout == "object" || (djConfig["useXDomain"] && dojo.render.html.opera)){ |
|
setTimeout("dojo.hostenv.loaded();", 0); |
|
}else{ |
|
dojo.hostenv.loaded(); |
|
} |
|
} |
|
|
|
dojo.hostenv.getModuleSymbols = function(/*String*/modulename){ |
|
// summary: |
|
// Converts a module name in dotted JS notation to an array representing the path in the source tree |
|
var syms = modulename.split("."); |
|
for(var i = syms.length; i>0; i--){ |
|
var parentModule = syms.slice(0, i).join("."); |
|
if((i==1) && !this.moduleHasPrefix(parentModule)){ |
|
// Support default module directory (sibling of dojo) for top-level modules |
|
syms[0] = "../" + syms[0]; |
|
}else{ |
|
var parentModulePath = this.getModulePrefix(parentModule); |
|
if(parentModulePath != parentModule){ |
|
syms.splice(0, i, parentModulePath); |
|
break; |
|
} |
|
} |
|
} |
|
return syms; // Array |
|
} |
|
|
|
dojo.hostenv._global_omit_module_check = false; |
|
dojo.hostenv.loadModule = function(/*String*/moduleName, /*Boolean?*/exactOnly, /*Boolean?*/omitModuleCheck){ |
|
// summary: |
|
// loads a Javascript module from the appropriate URI |
|
// |
|
// description: |
|
// loadModule("A.B") first checks to see if symbol A.B is defined. |
|
// If it is, it is simply returned (nothing to do). |
|
// |
|
// If it is not defined, it will look for "A/B.js" in the script root directory, |
|
// followed by "A.js". |
|
// |
|
// It throws if it cannot find a file to load, or if the symbol A.B is not |
|
// defined after loading. |
|
// |
|
// It returns the object A.B. |
|
// |
|
// This does nothing about importing symbols into the current package. |
|
// It is presumed that the caller will take care of that. For example, to import |
|
// all symbols: |
|
// |
|
// with (dojo.hostenv.loadModule("A.B")) { |
|
// ... |
|
// } |
|
// |
|
// And to import just the leaf symbol: |
|
// |
|
// var B = dojo.hostenv.loadModule("A.B"); |
|
// ... |
|
// |
|
// dj_load is an alias for dojo.hostenv.loadModule |
|
|
|
if(!moduleName){ return; } |
|
omitModuleCheck = this._global_omit_module_check || omitModuleCheck; |
|
var module = this.findModule(moduleName, false); |
|
if(module){ |
|
return module; |
|
} |
|
|
|
// protect against infinite recursion from mutual dependencies |
|
if(dj_undef(moduleName, this.loading_modules_)){ |
|
this.addedToLoadingCount.push(moduleName); |
|
} |
|
this.loading_modules_[moduleName] = 1; |
|
|
|
// convert periods to slashes |
|
var relpath = moduleName.replace(/\./g, '/') + '.js'; |
|
|
|
var nsyms = moduleName.split("."); |
|
|
|
// this line allowed loading of a module manifest as if it were a namespace |
|
// it's an interesting idea, but shouldn't be combined with 'namespaces' proper |
|
// and leads to unwanted dependencies |
|
// the effect can be achieved in other (albeit less-flexible) ways now, so I am |
|
// removing this pending further design work |
|
// perhaps we can explicitly define this idea of a 'module manifest', and subclass |
|
// 'namespace manifest' from that |
|
//dojo.getNamespace(nsyms[0]); |
|
|
|
var syms = this.getModuleSymbols(moduleName); |
|
var startedRelative = ((syms[0].charAt(0) != '/') && !syms[0].match(/^\w+:/)); |
|
var last = syms[syms.length - 1]; |
|
var ok; |
|
// figure out if we're looking for a full package, if so, we want to do |
|
// things slightly diffrently |
|
if(last=="*"){ |
|
moduleName = nsyms.slice(0, -1).join('.'); |
|
while(syms.length){ |
|
syms.pop(); |
|
syms.push(this.pkgFileName); |
|
relpath = syms.join("/") + '.js'; |
|
if(startedRelative && relpath.charAt(0)=="/"){ |
|
relpath = relpath.slice(1); |
|
} |
|
ok = this.loadPath(relpath, !omitModuleCheck ? moduleName : null); |
|
if(ok){ break; } |
|
syms.pop(); |
|
} |
|
}else{ |
|
relpath = syms.join("/") + '.js'; |
|
moduleName = nsyms.join('.'); |
|
var modArg = !omitModuleCheck ? moduleName : null; |
|
ok = this.loadPath(relpath, modArg); |
|
if(!ok && !exactOnly){ |
|
syms.pop(); |
|
while(syms.length){ |
|
relpath = syms.join('/') + '.js'; |
|
ok = this.loadPath(relpath, modArg); |
|
if(ok){ break; } |
|
syms.pop(); |
|
relpath = syms.join('/') + '/'+this.pkgFileName+'.js'; |
|
if(startedRelative && relpath.charAt(0)=="/"){ |
|
relpath = relpath.slice(1); |
|
} |
|
ok = this.loadPath(relpath, modArg); |
|
if(ok){ break; } |
|
} |
|
} |
|
|
|
if(!ok && !omitModuleCheck){ |
|
dojo.raise("Could not load '" + moduleName + "'; last tried '" + relpath + "'"); |
|
} |
|
} |
|
|
|
// check that the symbol was defined |
|
//Don't bother if we're doing xdomain (asynchronous) loading. |
|
if(!omitModuleCheck && !this["isXDomain"]){ |
|
// pass in false so we can give better error |
|
module = this.findModule(moduleName, false); |
|
if(!module){ |
|
dojo.raise("symbol '" + moduleName + "' is not defined after loading '" + relpath + "'"); |
|
} |
|
} |
|
|
|
return module; |
|
} |
|
|
|
dojo.hostenv.startPackage = function(/*String*/packageName){ |
|
// summary: |
|
// Creates a JavaScript package |
|
// |
|
// description: |
|
// startPackage("A.B") follows the path, and at each level creates a new empty |
|
// object or uses what already exists. It returns the result. |
|
// |
|
// packageName: the package to be created as a String in dot notation |
|
|
|
//Make sure we have a string. |
|
var fullPkgName = String(packageName); |
|
var strippedPkgName = fullPkgName; |
|
|
|
var syms = packageName.split(/\./); |
|
if(syms[syms.length-1]=="*"){ |
|
syms.pop(); |
|
strippedPkgName = syms.join("."); |
|
} |
|
var evaledPkg = dojo.evalObjPath(strippedPkgName, true); |
|
this.loaded_modules_[fullPkgName] = evaledPkg; |
|
this.loaded_modules_[strippedPkgName] = evaledPkg; |
|
|
|
return evaledPkg; // Object |
|
} |
|
|
|
dojo.hostenv.findModule = function(/*String*/moduleName, /*Boolean?*/mustExist){ |
|
// summary: |
|
// Returns the Object representing the module, if it exists, otherwise null. |
|
// |
|
// moduleName A fully qualified module including package name, like 'A.B'. |
|
// mustExist Optional, default false. throw instead of returning null |
|
// if the module does not currently exist. |
|
|
|
var lmn = String(moduleName); |
|
|
|
if(this.loaded_modules_[lmn]){ |
|
return this.loaded_modules_[lmn]; // Object |
|
} |
|
|
|
if(mustExist){ |
|
dojo.raise("no loaded module named '" + moduleName + "'"); |
|
} |
|
return null; // null |
|
} |
|
|
|
//Start of old bootstrap2: |
|
|
|
dojo.kwCompoundRequire = function(/*Object containing Arrays*/modMap){ |
|
// description: |
|
// This method taks a "map" of arrays which one can use to optionally load dojo |
|
// modules. The map is indexed by the possible dojo.hostenv.name_ values, with |
|
// two additional values: "default" and "common". The items in the "default" |
|
// array will be loaded if none of the other items have been choosen based on |
|
// the hostenv.name_ item. The items in the "common" array will _always_ be |
|
// loaded, regardless of which list is chosen. Here's how it's normally |
|
// called: |
|
// |
|
// dojo.kwCompoundRequire({ |
|
// browser: [ |
|
// ["foo.bar.baz", true, true], // an example that passes multiple args to loadModule() |
|
// "foo.sample.*", |
|
// "foo.test, |
|
// ], |
|
// default: [ "foo.sample.*" ], |
|
// common: [ "really.important.module.*" ] |
|
// }); |
|
|
|
var common = modMap["common"]||[]; |
|
var result = modMap[dojo.hostenv.name_] ? common.concat(modMap[dojo.hostenv.name_]||[]) : common.concat(modMap["default"]||[]); |
|
|
|
for(var x=0; x<result.length; x++){ |
|
var curr = result[x]; |
|
if(curr.constructor == Array){ |
|
dojo.hostenv.loadModule.apply(dojo.hostenv, curr); |
|
}else{ |
|
dojo.hostenv.loadModule(curr); |
|
} |
|
} |
|
} |
|
|
|
dojo.require = function(/*String*/ resourceName){ |
|
// summary |
|
// Ensure that the given resource (ie, javascript |
|
// source file) has been loaded. |
|
// description |
|
// dojo.require() is similar to C's #include command or java's "import" command. |
|
// You call dojo.require() to pull in the resources (ie, javascript source files) |
|
// that define the functions you are using. |
|
// |
|
// Note that in the case of a build, many resources have already been included |
|
// into dojo.js (ie, many of the javascript source files have been compressed and |
|
// concatened into dojo.js), so many dojo.require() calls will simply return |
|
// without downloading anything. |
|
dojo.hostenv.loadModule.apply(dojo.hostenv, arguments); |
|
} |
|
|
|
dojo.requireIf = function(/*Boolean*/ condition, /*String*/ resourceName){ |
|
// summary |
|
// If the condition is true then call dojo.require() for the specified resource |
|
var arg0 = arguments[0]; |
|
if((arg0 === true)||(arg0=="common")||(arg0 && dojo.render[arg0].capable)){ |
|
var args = []; |
|
for (var i = 1; i < arguments.length; i++) { args.push(arguments[i]); } |
|
dojo.require.apply(dojo, args); |
|
} |
|
} |
|
|
|
dojo.requireAfterIf = dojo.requireIf; |
|
|
|
dojo.provide = function(/*String*/ resourceName){ |
|
// summary |
|
// Each javascript source file must have (exactly) one dojo.provide() |
|
// call at the top of the file, corresponding to the file name. |
|
// For example, dojo/src/foo.js must have dojo.provide("dojo.foo"); at the top of the file. |
|
// |
|
// description |
|
// Each javascript source file is called a resource. When a resource |
|
// is loaded by the browser, dojo.provide() registers that it has |
|
// been loaded. |
|
// |
|
// For backwards compatibility reasons, in addition to registering the resource, |
|
// dojo.provide() also ensures that the javascript object for the module exists. For |
|
// example, dojo.provide("dojo.html.common"), in addition to registering that common.js |
|
// is a resource for the dojo.html module, will ensure that the dojo.html javascript object |
|
// exists, so that calls like dojo.html.foo = function(){ ... } don't fail. |
|
// |
|
// In the case of a build (or in the future, a rollup), where multiple javascript source |
|
// files are combined into one bigger file (similar to a .lib or .jar file), that file |
|
// will contain multiple dojo.provide() calls, to note that it includes |
|
// multiple resources. |
|
return dojo.hostenv.startPackage.apply(dojo.hostenv, arguments); |
|
} |
|
|
|
dojo.registerModulePath = function(/*String*/module, /*String*/prefix){ |
|
// summary: maps a module name to a path |
|
// description: An unregistered module is given the default path of ../<module>, |
|
// relative to Dojo root. For example, module acme is mapped to ../acme. |
|
// If you want to use a different module name, use dojo.registerModulePath. |
|
return dojo.hostenv.setModulePrefix(module, prefix); |
|
} |
|
|
|
if(djConfig["modulePaths"]){ |
|
for(var param in djConfig["modulePaths"]){ |
|
dojo.registerModulePath(param, djConfig["modulePaths"][param]); |
|
} |
|
} |
|
|
|
dojo.setModulePrefix = function(/*String*/module, /*String*/prefix){ |
|
// summary: maps a module name to a path |
|
dojo.deprecated('dojo.setModulePrefix("' + module + '", "' + prefix + '")', "replaced by dojo.registerModulePath", "0.5"); |
|
return dojo.registerModulePath(module, prefix); |
|
} |
|
|
|
dojo.exists = function(/*Object*/obj, /*String*/name){ |
|
// summary: determine if an object supports a given method |
|
// description: useful for longer api chains where you have to test each object in the chain |
|
var p = name.split("."); |
|
for(var i = 0; i < p.length; i++){ |
|
if(!obj[p[i]]){ return false; } // Boolean |
|
obj = obj[p[i]]; |
|
} |
|
return true; // Boolean |
|
} |
|
|
|
// Localization routines |
|
|
|
dojo.hostenv.normalizeLocale = function(/*String?*/locale){ |
|
// summary: |
|
// Returns canonical form of locale, as used by Dojo. All variants are case-insensitive and are separated by '-' |
|
// as specified in RFC 3066. If no locale is specified, the user agent's default is returned. |
|
|
|
var result = locale ? locale.toLowerCase() : dojo.locale; |
|
if(result == "root"){ |
|
result = "ROOT"; |
|
} |
|
return result;// String |
|
}; |
|
|
|
dojo.hostenv.searchLocalePath = function(/*String*/locale, /*Boolean*/down, /*Function*/searchFunc){ |
|
// summary: |
|
// A helper method to assist in searching for locale-based resources. Will iterate through |
|
// the variants of a particular locale, either up or down, executing a callback function. |
|
// For example, "en-us" and true will try "en-us" followed by "en" and finally "ROOT". |
|
|
|
locale = dojo.hostenv.normalizeLocale(locale); |
|
|
|
var elements = locale.split('-'); |
|
var searchlist = []; |
|
for(var i = elements.length; i > 0; i--){ |
|
searchlist.push(elements.slice(0, i).join('-')); |
|
} |
|
searchlist.push(false); |
|
if(down){searchlist.reverse();} |
|
|
|
for(var j = searchlist.length - 1; j >= 0; j--){ |
|
var loc = searchlist[j] || "ROOT"; |
|
var stop = searchFunc(loc); |
|
if(stop){ break; } |
|
} |
|
} |
|
|
|
//These two functions are placed outside of preloadLocalizations |
|
//So that the xd loading can use/override them. |
|
dojo.hostenv.localesGenerated /***BUILD:localesGenerated***/; // value will be inserted here at build time, if necessary |
|
|
|
dojo.hostenv.registerNlsPrefix = function(){ |
|
// summary: |
|
// Register module "nls" to point where Dojo can find pre-built localization files |
|
dojo.registerModulePath("nls","nls"); |
|
} |
|
|
|
dojo.hostenv.preloadLocalizations = function(){ |
|
// summary: |
|
// Load built, flattened resource bundles, if available for all locales used in the page. |
|
// Execute only once. Note that this is a no-op unless there is a build. |
|
|
|
if(dojo.hostenv.localesGenerated){ |
|
dojo.hostenv.registerNlsPrefix(); |
|
|
|
function preload(locale){ |
|
locale = dojo.hostenv.normalizeLocale(locale); |
|
dojo.hostenv.searchLocalePath(locale, true, function(loc){ |
|
for(var i=0; i<dojo.hostenv.localesGenerated.length;i++){ |
|
if(dojo.hostenv.localesGenerated[i] == loc){ |
|
dojo["require"]("nls.dojo_"+loc); |
|
return true; // Boolean |
|
} |
|
} |
|
return false; // Boolean |
|
}); |
|
} |
|
preload(); |
|
var extra = djConfig.extraLocale||[]; |
|
for(var i=0; i<extra.length; i++){ |
|
preload(extra[i]); |
|
} |
|
} |
|
dojo.hostenv.preloadLocalizations = function(){}; |
|
} |
|
|
|
dojo.requireLocalization = function(/*String*/moduleName, /*String*/bundleName, /*String?*/locale, /*String?*/availableFlatLocales){ |
|
// summary: |
|
// Declares translated resources and loads them if necessary, in the same style as dojo.require. |
|
// Contents of the resource bundle are typically strings, but may be any name/value pair, |
|
// represented in JSON format. See also dojo.i18n.getLocalization. |
|
// |
|
// moduleName: name of the package containing the "nls" directory in which the bundle is found |
|
// bundleName: bundle name, i.e. the filename without the '.js' suffix |
|
// locale: the locale to load (optional) By default, the browser's user locale as defined by dojo.locale |
|
// availableFlatLocales: A comma-separated list of the available, flattened locales for this bundle. |
|
// This argument should only be set by the build process. |
|
// |
|
// description: |
|
// Load translated resource bundles provided underneath the "nls" directory within a package. |
|
// Translated resources may be located in different packages throughout the source tree. For example, |
|
// a particular widget may define one or more resource bundles, structured in a program as follows, |
|
// where moduleName is mycode.mywidget and bundleNames available include bundleone and bundletwo: |
|
// ... |
|
// mycode/ |
|
// mywidget/ |
|
// nls/ |
|
// bundleone.js (the fallback translation, English in this example) |
|
// bundletwo.js (also a fallback translation) |
|
// de/ |
|
// bundleone.js |
|
// bundletwo.js |
|
// de-at/ |
|
// bundleone.js |
|
// en/ |
|
// (empty; use the fallback translation) |
|
// en-us/ |
|
// bundleone.js |
|
// en-gb/ |
|
// bundleone.js |
|
// es/ |
|
// bundleone.js |
|
// bundletwo.js |
|
// ...etc |
|
// ... |
|
// Each directory is named for a locale as specified by RFC 3066, (http://www.ietf.org/rfc/rfc3066.txt), |
|
// normalized in lowercase. Note that the two bundles in the example do not define all the same variants. |
|
// For a given locale, bundles will be loaded for that locale and all more general locales above it, including |
|
// a fallback at the root directory. For example, a declaration for the "de-at" locale will first |
|
// load nls/de-at/bundleone.js, then nls/de/bundleone.js and finally nls/bundleone.js. The data will |
|
// be flattened into a single Object so that lookups will follow this cascading pattern. An optional build |
|
// step can preload the bundles to avoid data redundancy and the multiple network hits normally required to |
|
// load these resources. |
|
|
|
dojo.hostenv.preloadLocalizations(); |
|
var targetLocale = dojo.hostenv.normalizeLocale(locale); |
|
var bundlePackage = [moduleName, "nls", bundleName].join("."); |
|
//NOTE: When loading these resources, the packaging does not match what is on disk. This is an |
|
// implementation detail, as this is just a private data structure to hold the loaded resources. |
|
// e.g. tests/hello/nls/en-us/salutations.js is loaded as the object tests.hello.nls.salutations.en_us={...} |
|
// The structure on disk is intended to be most convenient for developers and translators, but in memory |
|
// it is more logical and efficient to store in a different order. Locales cannot use dashes, since the |
|
// resulting path will not evaluate as valid JS, so we translate them to underscores. |
|
|
|
//Find the best-match locale to load if we have available flat locales. |
|
var bestLocale = ""; |
|
if(availableFlatLocales){ |
|
var flatLocales = availableFlatLocales.split(","); |
|
for(var i = 0; i < flatLocales.length; i++){ |
|
//Locale must match from start of string. |
|
if(targetLocale.indexOf(flatLocales[i]) == 0){ |
|
if(flatLocales[i].length > bestLocale.length){ |
|
bestLocale = flatLocales[i]; |
|
} |
|
} |
|
} |
|
if(!bestLocale){ |
|
bestLocale = "ROOT"; |
|
} |
|
} |
|
|
|
//See if the desired locale is already loaded. |
|
var tempLocale = availableFlatLocales ? bestLocale : targetLocale; |
|
var bundle = dojo.hostenv.findModule(bundlePackage); |
|
var localizedBundle = null; |
|
if(bundle){ |
|
if(djConfig.localizationComplete && bundle._built){return;} |
|
var jsLoc = tempLocale.replace('-', '_'); |
|
var translationPackage = bundlePackage+"."+jsLoc; |
|
localizedBundle = dojo.hostenv.findModule(translationPackage); |
|
} |
|
|
|
if(!localizedBundle){ |
|
bundle = dojo.hostenv.startPackage(bundlePackage); |
|
var syms = dojo.hostenv.getModuleSymbols(moduleName); |
|
var modpath = syms.concat("nls").join("/"); |
|
var parent; |
|
|
|
dojo.hostenv.searchLocalePath(tempLocale, availableFlatLocales, function(loc){ |
|
var jsLoc = loc.replace('-', '_'); |
|
var translationPackage = bundlePackage + "." + jsLoc; |
|
var loaded = false; |
|
if(!dojo.hostenv.findModule(translationPackage)){ |
|
// Mark loaded whether it's found or not, so that further load attempts will not be made |
|
dojo.hostenv.startPackage(translationPackage); |
|
var module = [modpath]; |
|
if(loc != "ROOT"){module.push(loc);} |
|
module.push(bundleName); |
|
var filespec = module.join("/") + '.js'; |
|
loaded = dojo.hostenv.loadPath(filespec, null, function(hash){ |
|
// Use singleton with prototype to point to parent bundle, then mix-in result from loadPath |
|
var clazz = function(){}; |
|
clazz.prototype = parent; |
|
bundle[jsLoc] = new clazz(); |
|
for(var j in hash){ bundle[jsLoc][j] = hash[j]; } |
|
}); |
|
}else{ |
|
loaded = true; |
|
} |
|
if(loaded && bundle[jsLoc]){ |
|
parent = bundle[jsLoc]; |
|
}else{ |
|
bundle[jsLoc] = parent; |
|
} |
|
|
|
if(availableFlatLocales){ |
|
//Stop the locale path searching if we know the availableFlatLocales, since |
|
//the first call to this function will load the only bundle that is needed. |
|
return true; |
|
} |
|
}); |
|
} |
|
|
|
//Save the best locale bundle as the target locale bundle when we know the |
|
//the available bundles. |
|
if(availableFlatLocales && targetLocale != bestLocale){ |
|
bundle[targetLocale.replace('-', '_')] = bundle[bestLocale.replace('-', '_')]; |
|
} |
|
}; |
|
|
|
(function(){ |
|
// If other locales are used, dojo.requireLocalization should load them as well, by default. |
|
// Override dojo.requireLocalization to do load the default bundle, then iterate through the |
|
// extraLocale list and load those translations as well, unless a particular locale was requested. |
|
|
|
var extra = djConfig.extraLocale; |
|
if(extra){ |
|
if(!extra instanceof Array){ |
|
extra = [extra]; |
|
} |
|
|
|
var req = dojo.requireLocalization; |
|
dojo.requireLocalization = function(m, b, locale, availableFlatLocales){ |
|
req(m,b,locale, availableFlatLocales); |
|
if(locale){return;} |
|
for(var i=0; i<extra.length; i++){ |
|
req(m,b,extra[i], availableFlatLocales); |
|
} |
|
}; |
|
} |
|
})(); |
|
|
|
}; |
|
|
|
if(typeof window != 'undefined'){ |
|
|
|
// attempt to figure out the path to dojo if it isn't set in the config |
|
(function(){ |
|
// before we get any further with the config options, try to pick them out |
|
// of the URL. Most of this code is from NW |
|
if(djConfig.allowQueryConfig){ |
|
var baseUrl = document.location.toString(); // FIXME: use location.query instead? |
|
var params = baseUrl.split("?", 2); |
|
if(params.length > 1){ |
|
var paramStr = params[1]; |
|
var pairs = paramStr.split("&"); |
|
for(var x in pairs){ |
|
var sp = pairs[x].split("="); |
|
// FIXME: is this eval dangerous? |
|
if((sp[0].length > 9)&&(sp[0].substr(0, 9) == "djConfig.")){ |
|
var opt = sp[0].substr(9); |
|
try{ |
|
djConfig[opt]=eval(sp[1]); |
|
}catch(e){ |
|
djConfig[opt]=sp[1]; |
|
} |
|
} |
|
} |
|
} |
|
} |
|
|
|
if( |
|
((djConfig["baseScriptUri"] == "")||(djConfig["baseRelativePath"] == "")) && |
|
(document && document.getElementsByTagName) |
|
){ |
|
var scripts = document.getElementsByTagName("script"); |
|
var rePkg = /(__package__|dojo|bootstrap1)\.js([\?\.]|$)/i; |
|
for(var i = 0; i < scripts.length; i++) { |
|
var src = scripts[i].getAttribute("src"); |
|
if(!src) { continue; } |
|
var m = src.match(rePkg); |
|
if(m) { |
|
var root = src.substring(0, m.index); |
|
if(src.indexOf("bootstrap1") > -1) { root += "../"; } |
|
if(!this["djConfig"]) { djConfig = {}; } |
|
if(djConfig["baseScriptUri"] == "") { djConfig["baseScriptUri"] = root; } |
|
if(djConfig["baseRelativePath"] == "") { djConfig["baseRelativePath"] = root; } |
|
break; |
|
} |
|
} |
|
} |
|
|
|
// fill in the rendering support information in dojo.render.* |
|
var dr = dojo.render; |
|
var drh = dojo.render.html; |
|
var drs = dojo.render.svg; |
|
var dua = (drh.UA = navigator.userAgent); |
|
var dav = (drh.AV = navigator.appVersion); |
|
var t = true; |
|
var f = false; |
|
drh.capable = t; |
|
drh.support.builtin = t; |
|
|
|
dr.ver = parseFloat(drh.AV); |
|
dr.os.mac = dav.indexOf("Macintosh") >= 0; |
|
dr.os.win = dav.indexOf("Windows") >= 0; |
|
// could also be Solaris or something, but it's the same browser |
|
dr.os.linux = dav.indexOf("X11") >= 0; |
|
|
|
drh.opera = dua.indexOf("Opera") >= 0; |
|
drh.khtml = (dav.indexOf("Konqueror") >= 0)||(dav.indexOf("Safari") >= 0); |
|
drh.safari = dav.indexOf("Safari") >= 0; |
|
var geckoPos = dua.indexOf("Gecko"); |
|
drh.mozilla = drh.moz = (geckoPos >= 0)&&(!drh.khtml); |
|
if (drh.mozilla) { |
|
// gecko version is YYYYMMDD |
|
drh.geckoVersion = dua.substring(geckoPos + 6, geckoPos + 14); |
|
} |
|
drh.ie = (document.all)&&(!drh.opera); |
|
drh.ie50 = drh.ie && dav.indexOf("MSIE 5.0")>=0; |
|
drh.ie55 = drh.ie && dav.indexOf("MSIE 5.5")>=0; |
|
drh.ie60 = drh.ie && dav.indexOf("MSIE 6.0")>=0; |
|
drh.ie70 = drh.ie && dav.indexOf("MSIE 7.0")>=0; |
|
|
|
var cm = document["compatMode"]; |
|
drh.quirks = (cm == "BackCompat")||(cm == "QuirksMode")||drh.ie55||drh.ie50; |
|
|
|
// TODO: is the HTML LANG attribute relevant? |
|
dojo.locale = dojo.locale || (drh.ie ? navigator.userLanguage : navigator.language).toLowerCase(); |
|
|
|
dr.vml.capable=drh.ie; |
|
drs.capable = f; |
|
drs.support.plugin = f; |
|
drs.support.builtin = f; |
|
var tdoc = window["document"]; |
|
var tdi = tdoc["implementation"]; |
|
|
|
if((tdi)&&(tdi["hasFeature"])&&(tdi.hasFeature("org.w3c.dom.svg", "1.0"))){ |
|
drs.capable = t; |
|
drs.support.builtin = t; |
|
drs.support.plugin = f; |
|
} |
|
// webkits after 420 support SVG natively. The test string is "AppleWebKit/420+" |
|
if(drh.safari){ |
|
var tmp = dua.split("AppleWebKit/")[1]; |
|
var ver = parseFloat(tmp.split(" ")[0]); |
|
if(ver >= 420){ |
|
drs.capable = t; |
|
drs.support.builtin = t; |
|
drs.support.plugin = f; |
|
} |
|
}else{ |
|
} |
|
})(); |
|
|
|
dojo.hostenv.startPackage("dojo.hostenv"); |
|
|
|
dojo.render.name = dojo.hostenv.name_ = 'browser'; |
|
dojo.hostenv.searchIds = []; |
|
|
|
// These are in order of decreasing likelihood; this will change in time. |
|
dojo.hostenv._XMLHTTP_PROGIDS = ['Msxml2.XMLHTTP', 'Microsoft.XMLHTTP', 'Msxml2.XMLHTTP.4.0']; |
|
|
|
dojo.hostenv.getXmlhttpObject = function(){ |
|
// summary: does the work of portably generating a new XMLHTTPRequest object. |
|
var http = null; |
|
var last_e = null; |
|
try{ http = new XMLHttpRequest(); }catch(e){} |
|
if(!http){ |
|
for(var i=0; i<3; ++i){ |
|
var progid = dojo.hostenv._XMLHTTP_PROGIDS[i]; |
|
try{ |
|
http = new ActiveXObject(progid); |
|
}catch(e){ |
|
last_e = e; |
|
} |
|
|
|
if(http){ |
|
dojo.hostenv._XMLHTTP_PROGIDS = [progid]; // so faster next time |
|
break; |
|
} |
|
} |
|
|
|
/*if(http && !http.toString) { |
|
http.toString = function() { "[object XMLHttpRequest]"; } |
|
}*/ |
|
} |
|
|
|
if(!http){ |
|
return dojo.raise("XMLHTTP not available", last_e); |
|
} |
|
|
|
return http; // XMLHTTPRequest instance |
|
} |
|
|
|
dojo.hostenv._blockAsync = false; |
|
dojo.hostenv.getText = function(uri, async_cb, fail_ok){ |
|
// summary: Read the contents of the specified uri and return those contents. |
|
// uri: |
|
// A relative or absolute uri. If absolute, it still must be in |
|
// the same "domain" as we are. |
|
// async_cb: |
|
// If not specified, load synchronously. If specified, load |
|
// asynchronously, and use async_cb as the progress handler which |
|
// takes the xmlhttp object as its argument. If async_cb, this |
|
// function returns null. |
|
// fail_ok: |
|
// Default false. If fail_ok and !async_cb and loading fails, |
|
// return null instead of throwing. |
|
|
|
// need to block async callbacks from snatching this thread as the result |
|
// of an async callback might call another sync XHR, this hangs khtml forever |
|
// hostenv._blockAsync must also be checked in BrowserIO's watchInFlight() |
|
// NOTE: must be declared before scope switches ie. this.getXmlhttpObject() |
|
if(!async_cb){ this._blockAsync = true; } |
|
|
|
var http = this.getXmlhttpObject(); |
|
|
|
function isDocumentOk(http){ |
|
var stat = http["status"]; |
|
// allow a 304 use cache, needed in konq (is this compliant with the http spec?) |
|
return Boolean((!stat)||((200 <= stat)&&(300 > stat))||(stat==304)); |
|
} |
|
|
|
if(async_cb){ |
|
var _this = this, timer = null, gbl = dojo.global(); |
|
var xhr = dojo.evalObjPath("dojo.io.XMLHTTPTransport"); |
|
http.onreadystatechange = function(){ |
|
if(timer){ gbl.clearTimeout(timer); timer = null; } |
|
if(_this._blockAsync || (xhr && xhr._blockAsync)){ |
|
timer = gbl.setTimeout(function () { http.onreadystatechange.apply(this); }, 10); |
|
}else{ |
|
if(4==http.readyState){ |
|
if(isDocumentOk(http)){ |
|
// dojo.debug("LOADED URI: "+uri); |
|
async_cb(http.responseText); |
|
} |
|
} |
|
} |
|
} |
|
} |
|
|
|
http.open('GET', uri, async_cb ? true : false); |
|
try{ |
|
http.send(null); |
|
if(async_cb){ |
|
return null; |
|
} |
|
if(!isDocumentOk(http)){ |
|
var err = Error("Unable to load "+uri+" status:"+ http.status); |
|
err.status = http.status; |
|
err.responseText = http.responseText; |
|
throw err; |
|
} |
|
}catch(e){ |
|
this._blockAsync = false; |
|
if((fail_ok)&&(!async_cb)){ |
|
return null; |
|
}else{ |
|
throw e; |
|
} |
|
} |
|
|
|
this._blockAsync = false; |
|
return http.responseText; // String |
|
} |
|
|
|
dojo.hostenv.defaultDebugContainerId = 'dojoDebug'; |
|
dojo.hostenv._println_buffer = []; |
|
dojo.hostenv._println_safe = false; |
|
dojo.hostenv.println = function(/*String*/line){ |
|
// summary: |
|
// prints the provided line to whatever logging container is |
|
// available. If the page isn't loaded yet, the line may be added |
|
// to a buffer for printing later. |
|
if(!dojo.hostenv._println_safe){ |
|
dojo.hostenv._println_buffer.push(line); |
|
}else{ |
|
try { |
|
var console = document.getElementById(djConfig.debugContainerId ? |
|
djConfig.debugContainerId : dojo.hostenv.defaultDebugContainerId); |
|
if(!console) { console = dojo.body(); } |
|
|
|
var div = document.createElement("div"); |
|
div.appendChild(document.createTextNode(line)); |
|
console.appendChild(div); |
|
} catch (e) { |
|
try{ |
|
// safari needs the output wrapped in an element for some reason |
|
document.write("<div>" + line + "</div>"); |
|
}catch(e2){ |
|
window.status = line; |
|
} |
|
} |
|
} |
|
} |
|
|
|
dojo.addOnLoad(function(){ |
|
dojo.hostenv._println_safe = true; |
|
while(dojo.hostenv._println_buffer.length > 0){ |
|
dojo.hostenv.println(dojo.hostenv._println_buffer.shift()); |
|
} |
|
}); |
|
|
|
function dj_addNodeEvtHdlr(/*DomNode*/node, /*String*/evtName, /*Function*/fp){ |
|
// summary: |
|
// non-destructively adds the specified function to the node's |
|
// evtName handler. |
|
// node: the DomNode to add the handler to |
|
// evtName: should be in the form "click" for "onclick" handlers |
|
var oldHandler = node["on"+evtName] || function(){}; |
|
node["on"+evtName] = function(){ |
|
fp.apply(node, arguments); |
|
oldHandler.apply(node, arguments); |
|
} |
|
return true; |
|
} |
|
|
|
// BEGIN DOMContentLoaded, from Dean Edwards (http://dean.edwards.name/weblog/2006/06/again/) |
|
function dj_load_init(e){ |
|
// allow multiple calls, only first one will take effect |
|
// A bug in khtml calls events callbacks for document for event which isnt supported |
|
// for example a created contextmenu event calls DOMContentLoaded, workaround |
|
var type = (e && e.type) ? e.type.toLowerCase() : "load"; |
|
if(arguments.callee.initialized || (type!="domcontentloaded" && type!="load")){ return; } |
|
arguments.callee.initialized = true; |
|
if(typeof(_timer) != 'undefined'){ |
|
clearInterval(_timer); |
|
delete _timer; |
|
} |
|
|
|
var initFunc = function(){ |
|
//perform initialization |
|
if(dojo.render.html.ie){ |
|
dojo.hostenv.makeWidgets(); |
|
} |
|
}; |
|
|
|
if(dojo.hostenv.inFlightCount == 0){ |
|
initFunc(); |
|
dojo.hostenv.modulesLoaded(); |
|
}else{ |
|
//This else case should be xdomain loading. |
|
//Make sure this is the first thing in the load listener array. |
|
//Part of the dojo.addOnLoad guarantee is that when the listeners are notified, |
|
//It means the DOM (or page) has loaded and that widgets have been parsed. |
|
dojo.hostenv.modulesLoadedListeners.unshift(initFunc); |
|
} |
|
} |
|
|
|
// START DOMContentLoaded |
|
// Mozilla and Opera 9 expose the event we could use |
|
if(document.addEventListener){ |
|
// NOTE: |
|
// due to a threading issue in Firefox 2.0, we can't enable |
|
// DOMContentLoaded on that platform. For more information, see: |
|
// http://trac.dojotoolkit.org/ticket/1704 |
|
if(dojo.render.html.opera || (dojo.render.html.moz && (djConfig["enableMozDomContentLoaded"] === true))){ |
|
document.addEventListener("DOMContentLoaded", dj_load_init, null); |
|
} |
|
|
|
// mainly for Opera 8.5, won't be fired if DOMContentLoaded fired already. |
|
// also used for Mozilla because of trac #1640 |
|
window.addEventListener("load", dj_load_init, null); |
|
} |
|
|
|
// 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.render.html.ie && dojo.render.os.win){ |
|
document.attachEvent("onreadystatechange", function(e){ |
|
if(document.readyState == "complete"){ |
|
dj_load_init(); |
|
} |
|
}); |
|
} |
|
|
|
if (/(WebKit|khtml)/i.test(navigator.userAgent)) { // sniff |
|
var _timer = setInterval(function() { |
|
if (/loaded|complete/.test(document.readyState)) { |
|
dj_load_init(); // call the onload handler |
|
} |
|
}, 10); |
|
} |
|
// END DOMContentLoaded |
|
|
|
// IE WebControl hosted in an application can fire "beforeunload" and "unload" |
|
// events when control visibility changes, causing Dojo to unload too soon. The |
|
// following code fixes the problem |
|
// Reference: http://support.microsoft.com/default.aspx?scid=kb;en-us;199155 |
|
if(dojo.render.html.ie){ |
|
dj_addNodeEvtHdlr(window, "beforeunload", function(){ |
|
dojo.hostenv._unloading = true; |
|
window.setTimeout(function() { |
|
dojo.hostenv._unloading = false; |
|
}, 0); |
|
}); |
|
} |
|
|
|
dj_addNodeEvtHdlr(window, "unload", function(){ |
|
dojo.hostenv.unloaded(); |
|
if((!dojo.render.html.ie)||(dojo.render.html.ie && dojo.hostenv._unloading)){ |
|
dojo.hostenv.unloaded(); |
|
} |
|
}); |
|
|
|
dojo.hostenv.makeWidgets = function(){ |
|
// you can put searchIds in djConfig and dojo.hostenv at the moment |
|
// we should probably eventually move to one or the other |
|
var sids = []; |
|
if(djConfig.searchIds && djConfig.searchIds.length > 0) { |
|
sids = sids.concat(djConfig.searchIds); |
|
} |
|
if(dojo.hostenv.searchIds && dojo.hostenv.searchIds.length > 0) { |
|
sids = sids.concat(dojo.hostenv.searchIds); |
|
} |
|
|
|
if((djConfig.parseWidgets)||(sids.length > 0)){ |
|
if(dojo.evalObjPath("dojo.widget.Parse")){ |
|
// we must do this on a delay to avoid: |
|
// http://www.shaftek.org/blog/archives/000212.html |
|
// (IE bug) |
|
var parser = new dojo.xml.Parse(); |
|
if(sids.length > 0){ |
|
for(var x=0; x<sids.length; x++){ |
|
var tmpNode = document.getElementById(sids[x]); |
|
if(!tmpNode){ continue; } |
|
var frag = parser.parseElement(tmpNode, null, true); |
|
dojo.widget.getParser().createComponents(frag); |
|
} |
|
}else if(djConfig.parseWidgets){ |
|
var frag = parser.parseElement(dojo.body(), null, true); |
|
dojo.widget.getParser().createComponents(frag); |
|
} |
|
} |
|
} |
|
} |
|
|
|
dojo.addOnLoad(function(){ |
|
if(!dojo.render.html.ie) { |
|
dojo.hostenv.makeWidgets(); |
|
} |
|
}); |
|
|
|
try{ |
|
if(dojo.render.html.ie){ |
|
document.namespaces.add("v","urn:schemas-microsoft-com:vml"); |
|
document.createStyleSheet().addRule("v\\:*", "behavior:url(#default#VML)"); |
|
} |
|
}catch(e){ } |
|
|
|
// stub, over-ridden by debugging code. This will at least keep us from |
|
// breaking when it's not included |
|
dojo.hostenv.writeIncludes = function(){} |
|
|
|
//TODOC: HOW TO DOC THIS? |
|
// @global: dj_currentDocument |
|
// summary: |
|
// Current document object. 'dj_currentDocument' can be modified for temporary context shifting. |
|
// description: |
|
// dojo.doc() returns dojo.currentDocument. |
|
// Refer to dojo.doc() rather than referring to 'window.document' to ensure your |
|
// code runs correctly in managed contexts. |
|
if(!dj_undef("document", this)){ |
|
dj_currentDocument = this.document; |
|
} |
|
|
|
dojo.doc = function(){ |
|
// summary: |
|
// return the document object associated with the dojo.global() |
|
return dj_currentDocument; |
|
} |
|
|
|
dojo.body = function(){ |
|
// summary: |
|
// return the body object associated with dojo.doc() |
|
// Note: document.body is not defined for a strict xhtml document |
|
return dojo.doc().body || dojo.doc().getElementsByTagName("body")[0]; |
|
} |
|
|
|
dojo.byId = function(/*String*/id, /*DocumentElement*/doc){ |
|
// summary: |
|
// similar to other library's "$" function, takes a string |
|
// representing a DOM id or a DomNode and returns the |
|
// corresponding DomNode. If a Node is passed, this function is a |
|
// no-op. Returns a single DOM node or null, working around |
|
// several browser-specific bugs to do so. |
|
// id: DOM id or DOM Node |
|
// doc: |
|
// optional, defaults to the current value of dj_currentDocument. |
|
// Can be used to retreive node references from other documents. |
|
if((id)&&((typeof id == "string")||(id instanceof String))){ |
|
if(!doc){ doc = dj_currentDocument; } |
|
var ele = doc.getElementById(id); |
|
// workaround bug in IE and Opera 8.2 where getElementById returns wrong element |
|
if(ele && (ele.id != id) && doc.all){ |
|
ele = null; |
|
// get all matching elements with this id |
|
eles = doc.all[id]; |
|
if(eles){ |
|
// if more than 1, choose first with the correct id |
|
if(eles.length){ |
|
for(var i=0; i<eles.length; i++){ |
|
if(eles[i].id == id){ |
|
ele = eles[i]; |
|
break; |
|
} |
|
} |
|
// return 1 and only element |
|
}else{ |
|
ele = eles; |
|
} |
|
} |
|
} |
|
return ele; // DomNode |
|
} |
|
return id; // DomNode |
|
} |
|
|
|
dojo.setContext = function(/*Object*/globalObject, /*DocumentElement*/globalDocument){ |
|
// summary: |
|
// changes the behavior of many core Dojo functions that deal with |
|
// namespace and DOM lookup, changing them to work in a new global |
|
// context. The varibles dj_currentContext and dj_currentDocument |
|
// are modified as a result of calling this function. |
|
dj_currentContext = globalObject; |
|
dj_currentDocument = globalDocument; |
|
}; |
|
|
|
dojo._fireCallback = function(callback, context, cbArguments){ |
|
if((context)&&((typeof callback == "string")||(callback instanceof String))){ |
|
callback=context[callback]; |
|
} |
|
return (context ? callback.apply(context, cbArguments || [ ]) : callback()); |
|
} |
|
|
|
dojo.withGlobal = function(/*Object*/globalObject, /*Function*/callback, /*Object?*/thisObject, /*Array?*/cbArguments){ |
|
// summary: |
|
// Call callback with globalObject as dojo.global() and globalObject.document |
|
// as dojo.doc(). If provided, globalObject will be executed in the context of |
|
// object thisObject |
|
// description: |
|
// When callback() returns or throws an error, the dojo.global() and dojo.doc() will |
|
// be restored to its previous state. |
|
var rval; |
|
var oldGlob = dj_currentContext; |
|
var oldDoc = dj_currentDocument; |
|
try{ |
|
dojo.setContext(globalObject, globalObject.document); |
|
rval = dojo._fireCallback(callback, thisObject, cbArguments); |
|
}finally{ |
|
dojo.setContext(oldGlob, oldDoc); |
|
} |
|
return rval; |
|
} |
|
|
|
dojo.withDoc = function (/*Object*/documentObject, /*Function*/callback, /*Object?*/thisObject, /*Array?*/cbArguments) { |
|
// summary: |
|
// Call callback with documentObject as dojo.doc(). If provided, callback will be executed |
|
// in the context of object thisObject |
|
// description: |
|
// When callback() returns or throws an error, the dojo.doc() will |
|
// be restored to its previous state. |
|
var rval; |
|
var oldDoc = dj_currentDocument; |
|
try{ |
|
dj_currentDocument = documentObject; |
|
rval = dojo._fireCallback(callback, thisObject, cbArguments); |
|
}finally{ |
|
dj_currentDocument = oldDoc; |
|
} |
|
return rval; |
|
} |
|
|
|
} //if (typeof window != 'undefined') |
|
|
|
//Load debug code if necessary. |
|
dojo.requireIf((djConfig["isDebug"] || djConfig["debugAtAllCosts"]), "dojo.debug"); |
|
|
|
//window.widget is for Dashboard detection |
|
//The full conditionals are spelled out to avoid issues during builds. |
|
//Builds may be looking for require/requireIf statements and processing them. |
|
dojo.requireIf(djConfig["debugAtAllCosts"] && !window.widget && !djConfig["useXDomain"], "dojo.browser_debug"); |
|
dojo.requireIf(djConfig["debugAtAllCosts"] && !window.widget && djConfig["useXDomain"], "dojo.browser_debug_xd"); |
|
|
|
dojo.provide("dojo.string.common"); |
|
|
|
dojo.string.trim = function(/* string */str, /* integer? */wh){ |
|
// summary |
|
// Trim whitespace from str. If wh > 0, trim from start, if wh < 0, trim from end, else both |
|
if(!str.replace){ return str; } |
|
if(!str.length){ return str; } |
|
var re = (wh > 0) ? (/^\s+/) : (wh < 0) ? (/\s+$/) : (/^\s+|\s+$/g); |
|
return str.replace(re, ""); // string |
|
} |
|
|
|
dojo.string.trimStart = function(/* string */str) { |
|
// summary |
|
// Trim whitespace at the beginning of 'str' |
|
return dojo.string.trim(str, 1); // string |
|
} |
|
|
|
dojo.string.trimEnd = function(/* string */str) { |
|
// summary |
|
// Trim whitespace at the end of 'str' |
|
return dojo.string.trim(str, -1); |
|
} |
|
|
|
dojo.string.repeat = function(/* string */str, /* integer */count, /* string? */separator) { |
|
// summary |
|
// Return 'str' repeated 'count' times, optionally placing 'separator' between each rep |
|
var out = ""; |
|
for(var i = 0; i < count; i++) { |
|
out += str; |
|
if(separator && i < count - 1) { |
|
out += separator; |
|
} |
|
} |
|
return out; // string |
|
} |
|
|
|
dojo.string.pad = function(/* string */str, /* integer */len/*=2*/, /* string */ c/*='0'*/, /* integer */dir/*=1*/) { |
|
// summary |
|
// Pad 'str' to guarantee that it is at least 'len' length with the character 'c' at either the |
|
// start (dir=1) or end (dir=-1) of the string |
|
var out = String(str); |
|
if(!c) { |
|
c = '0'; |
|
} |
|
if(!dir) { |
|
dir = 1; |
|
} |
|
while(out.length < len) { |
|
if(dir > 0) { |
|
out = c + out; |
|
} else { |
|
out += c; |
|
} |
|
} |
|
return out; // string |
|
} |
|
|
|
dojo.string.padLeft = function(/* string */str, /* integer */len, /* string */c) { |
|
// summary |
|
// same as dojo.string.pad(str, len, c, 1) |
|
return dojo.string.pad(str, len, c, 1); // string |
|
} |
|
|
|
dojo.string.padRight = function(/* string */str, /* integer */len, /* string */c) { |
|
// summary |
|
// same as dojo.string.pad(str, len, c, -1) |
|
return dojo.string.pad(str, len, c, -1); // string |
|
} |
|
|
|
dojo.provide("dojo.string"); |
|
|
|
|
|
dojo.provide("dojo.lang.common"); |
|
|
|
dojo.lang.inherits = function(/*Function*/subclass, /*Function*/superclass){ |
|
// summary: Set up inheritance between two classes. |
|
if(!dojo.lang.isFunction(superclass)){ |
|
dojo.raise("dojo.inherits: superclass argument ["+superclass+"] must be a function (subclass: ["+subclass+"']"); |
|
} |
|
subclass.prototype = new superclass(); |
|
subclass.prototype.constructor = subclass; |
|
subclass.superclass = superclass.prototype; |
|
// DEPRECATED: super is a reserved word, use 'superclass' |
|
subclass['super'] = superclass.prototype; |
|
} |
|
|
|
dojo.lang._mixin = function(/*Object*/ obj, /*Object*/ props){ |
|
// summary: |
|
// Adds all properties and methods of props to obj. This addition is |
|
// "prototype extension safe", so that instances of objects will not |
|
// pass along prototype defaults. |
|
var tobj = {}; |
|
for(var x in props){ |
|
// the "tobj" condition avoid copying properties in "props" |
|
// inherited from Object.prototype. For example, if obj has a custom |
|
// toString() method, don't overwrite it with the toString() method |
|
// that props inherited from Object.protoype |
|
if((typeof tobj[x] == "undefined") || (tobj[x] != props[x])){ |
|
obj[x] = props[x]; |
|
} |
|
} |
|
// IE doesn't recognize custom toStrings in for..in |
|
if(dojo.render.html.ie |
|
&& (typeof(props["toString"]) == "function") |
|
&& (props["toString"] != obj["toString"]) |
|
&& (props["toString"] != tobj["toString"])) |
|
{ |
|
obj.toString = props.toString; |
|
} |
|
return obj; // Object |
|
} |
|
|
|
dojo.lang.mixin = function(/*Object*/obj, /*Object...*/props){ |
|
// summary: Adds all properties and methods of props to obj. |
|
for(var i=1, l=arguments.length; i<l; i++){ |
|
dojo.lang._mixin(obj, arguments[i]); |
|
} |
|
return obj; // Object |
|
} |
|
|
|
dojo.lang.extend = function(/*Object*/ constructor, /*Object...*/ props){ |
|
// summary: |
|
// Adds all properties and methods of props to constructor's |
|
// prototype, making them available to all instances created with |
|
// constructor. |
|
for(var i=1, l=arguments.length; i<l; i++){ |
|
dojo.lang._mixin(constructor.prototype, arguments[i]); |
|
} |
|
return constructor; // Object |
|
} |
|
|
|
// Promote to dojo module |
|
dojo.inherits = dojo.lang.inherits; |
|
//dojo.lang._mixin = dojo.lang._mixin; |
|
dojo.mixin = dojo.lang.mixin; |
|
dojo.extend = dojo.lang.extend; |
|
|
|
dojo.lang.find = function( /*Array*/ array, |
|
/*Object*/ value, |
|
/*Boolean?*/ identity, |
|
/*Boolean?*/ findLast){ |
|
// summary: |
|
// Return the index of value in array, returning -1 if not found. |
|
// array: just what you think |
|
// value: the value to locate |
|
// identity: |
|
// If true, matches with identity comparison (===). If false, uses |
|
// normal comparison (==). |
|
// findLast: |
|
// If true, returns index of last instance of value. |
|
// examples: |
|
// find(array, value[, identity [findLast]]) // recommended |
|
// find(value, array[, identity [findLast]]) // deprecated |
|
|
|
// support both (array, value) and (value, array) |
|
if(!dojo.lang.isArrayLike(array) && dojo.lang.isArrayLike(value)) { |
|
dojo.deprecated('dojo.lang.find(value, array)', 'use dojo.lang.find(array, value) instead', "0.5"); |
|
var temp = array; |
|
array = value; |
|
value = temp; |
|
} |
|
var isString = dojo.lang.isString(array); |
|
if(isString) { array = array.split(""); } |
|
|
|
if(findLast) { |
|
var step = -1; |
|
var i = array.length - 1; |
|
var end = -1; |
|
} else { |
|
var step = 1; |
|
var i = 0; |
|
var end = array.length; |
|
} |
|
if(identity){ |
|
while(i != end) { |
|
if(array[i] === value){ return i; } |
|
i += step; |
|
} |
|
}else{ |
|
while(i != end) { |
|
if(array[i] == value){ return i; } |
|
i += step; |
|
} |
|
} |
|
return -1; // number |
|
} |
|
|
|
dojo.lang.indexOf = dojo.lang.find; |
|
|
|
dojo.lang.findLast = function(/*Array*/array, /*Object*/value, /*boolean?*/identity){ |
|
// summary: |
|
// Return index of last occurance of value in array, returning -1 if |
|
// not found. This is a shortcut for dojo.lang.find() with a true |
|
// value for its "findLast" parameter. |
|
// identity: |
|
// If true, matches with identity comparison (===). If false, uses |
|
// normal comparison (==). |
|
return dojo.lang.find(array, value, identity, true); // number |
|
} |
|
|
|
dojo.lang.lastIndexOf = dojo.lang.findLast; |
|
|
|
dojo.lang.inArray = function(array /*Array*/, value /*Object*/){ |
|
// summary: Return true if value is present in array. |
|
return dojo.lang.find(array, value) > -1; // boolean |
|
} |
|
|
|
/** |
|
* Partial implmentation of is* functions from |
|
* http://www.crockford.com/javascript/recommend.html |
|
* NOTE: some of these may not be the best thing to use in all situations |
|
* as they aren't part of core JS and therefore can't work in every case. |
|
* See WARNING messages inline for tips. |
|
* |
|
* The following is* functions are fairly "safe" |
|
*/ |
|
|
|
dojo.lang.isObject = function(/*anything*/ it){ |
|
// summary: Return true if it is an Object, Array or Function. |
|
if(typeof it == "undefined"){ return false; } |
|
return (typeof it == "object" || it === null || dojo.lang.isArray(it) || dojo.lang.isFunction(it)); // Boolean |
|
} |
|
|
|
dojo.lang.isArray = function(/*anything*/ it){ |
|
// summary: Return true if it is an Array. |
|
return (it && it instanceof Array || typeof it == "array"); // Boolean |
|
} |
|
|
|
dojo.lang.isArrayLike = function(/*anything*/ it){ |
|
// summary: |
|
// Return true if it can be used as an array (i.e. is an object with |
|
// an integer length property). |
|
if((!it)||(dojo.lang.isUndefined(it))){ return false; } |
|
if(dojo.lang.isString(it)){ return false; } |
|
if(dojo.lang.isFunction(it)){ return false; } // keeps out built-in constructors (Number, String, ...) which have length properties |
|
if(dojo.lang.isArray(it)){ return true; } |
|
// form node itself is ArrayLike, but not always iterable. Use form.elements instead. |
|
if((it.tagName)&&(it.tagName.toLowerCase()=='form')){ return false; } |
|
if(dojo.lang.isNumber(it.length) && isFinite(it.length)){ return true; } |
|
return false; // Boolean |
|
} |
|
|
|
dojo.lang.isFunction = function(/*anything*/ it){ |
|
// summary: Return true if it is a Function. |
|
return (it instanceof Function || typeof it == "function"); // Boolean |
|
}; |
|
|
|
(function(){ |
|
// webkit treats NodeList as a function, which is bad |
|
if((dojo.render.html.capable)&&(dojo.render.html["safari"])){ |
|
dojo.lang.isFunction = function(/*anything*/ it){ |
|
if((typeof(it) == "function") && (it == "[object NodeList]")) { return false; } |
|
return (it instanceof Function || typeof it == "function"); // Boolean |
|
} |
|
} |
|
})(); |
|
|
|
dojo.lang.isString = function(/*anything*/ it){ |
|
// summary: Return true if it is a String. |
|
return (typeof it == "string" || it instanceof String); |
|
} |
|
|
|
dojo.lang.isAlien = function(/*anything*/ it){ |
|
// summary: Return true if it is not a built-in function. False if not. |
|
if(!it){ return false; } |
|
return !dojo.lang.isFunction(it) && /\{\s*\[native code\]\s*\}/.test(String(it)); // Boolean |
|
} |
|
|
|
dojo.lang.isBoolean = function(/*anything*/ it){ |
|
// summary: Return true if it is a Boolean. |
|
return (it instanceof Boolean || typeof it == "boolean"); // Boolean |
|
} |
|
|
|
/** |
|
* The following is***() functions are somewhat "unsafe". Fortunately, |
|
* there are workarounds the the language provides and are mentioned |
|
* in the WARNING messages. |
|
* |
|
*/ |
|
dojo.lang.isNumber = function(/*anything*/ it){ |
|
// summary: Return true if it is a number. |
|
// description: |
|
// WARNING - In most cases, isNaN(it) is sufficient to determine whether or not |
|
// something is a number or can be used as such. For example, a number or string |
|
// can be used interchangably when accessing array items (array["1"] is the same as |
|
// array[1]) and isNaN will return false for both values ("1" and 1). However, |
|
// isNumber("1") will return false, which is generally not too useful. |
|
// Also, isNumber(NaN) returns true, again, this isn't generally useful, but there |
|
// are corner cases (like when you want to make sure that two things are really |
|
// the same type of thing). That is really where isNumber "shines". |
|
// |
|
// Recommendation - Use isNaN(it) when possible |
|
|
|
return (it instanceof Number || typeof it == "number"); // Boolean |
|
} |
|
|
|
/* |
|
* FIXME: Should isUndefined go away since it is error prone? |
|
*/ |
|
dojo.lang.isUndefined = function(/*anything*/ it){ |
|
// summary: Return true if it is not defined. |
|
// description: |
|
// WARNING - In some cases, isUndefined will not behave as you |
|
// might expect. If you do isUndefined(foo) and there is no earlier |
|
// reference to foo, an error will be thrown before isUndefined is |
|
// called. It behaves correctly if you scope yor object first, i.e. |
|
// isUndefined(foo.bar) where foo is an object and bar isn't a |
|
// property of the object. |
|
// |
|
// Recommendation - Use typeof foo == "undefined" when possible |
|
|
|
return ((typeof(it) == "undefined")&&(it == undefined)); // Boolean |
|
} |
|
|
|
// end Crockford functions |
|
|
|
dojo.provide("dojo.lang.extras"); |
|
|
|
|
|
|
|
dojo.lang.setTimeout = function(/*Function*/func, /*int*/delay /*, ...*/){ |
|
// summary: |
|
// Sets a timeout in milliseconds to execute a function in a given |
|
// context with optional arguments. |
|
// usage: |
|
// dojo.lang.setTimeout(Object context, function func, number delay[, arg1[, ...]]); |
|
// dojo.lang.setTimeout(function func, number delay[, arg1[, ...]]); |
|
|
|
var context = window, argsStart = 2; |
|
if(!dojo.lang.isFunction(func)){ |
|
context = func; |
|
func = delay; |
|
delay = arguments[2]; |
|
argsStart++; |
|
} |
|
|
|
if(dojo.lang.isString(func)){ |
|
func = context[func]; |
|
} |
|
|
|
var args = []; |
|
for (var i = argsStart; i < arguments.length; i++){ |
|
args.push(arguments[i]); |
|
} |
|
return dojo.global().setTimeout(function(){ func.apply(context, args); }, delay); // int |
|
} |
|
|
|
dojo.lang.clearTimeout = function(/*int*/timer){ |
|
// summary: clears timer by number from the execution queue |
|
|
|
// FIXME: |
|
// why do we have this function? It's not portable outside of browser |
|
// environments and it's a stupid wrapper on something that browsers |
|
// provide anyway. |
|
dojo.global().clearTimeout(timer); |
|
} |
|
|
|
dojo.lang.getNameInObj = function(/*Object*/ns, /*unknown*/item){ |
|
// summary: |
|
// looks for a value in the object ns with a value matching item and |
|
// returns the property name |
|
// ns: if null, dj_global is used |
|
// item: value to return a name for |
|
if(!ns){ ns = dj_global; } |
|
|
|
for(var x in ns){ |
|
if(ns[x] === item){ |
|
return new String(x); // String |
|
} |
|
} |
|
return null; // null |
|
} |
|
|
|
dojo.lang.shallowCopy = function(/*Object*/obj, /*Boolean?*/deep){ |
|
// summary: |
|
// copies object obj one level deep, or full depth if deep is true |
|
var i, ret; |
|
|
|
if(obj === null){ /*obj: null*/ return null; } // null |
|
|
|
if(dojo.lang.isObject(obj)){ |
|
// obj: Object |
|
ret = new obj.constructor(); |
|
for(i in obj){ |
|
if(dojo.lang.isUndefined(ret[i])){ |
|
ret[i] = deep ? dojo.lang.shallowCopy(obj[i], deep) : obj[i]; |
|
} |
|
} |
|
}else if(dojo.lang.isArray(obj)){ |
|
// obj: Array |
|
ret = []; |
|
for(i=0; i<obj.length; i++){ |
|
ret[i] = deep ? dojo.lang.shallowCopy(obj[i], deep) : obj[i]; |
|
} |
|
}else{ |
|
// obj: Object |
|
ret = obj; |
|
} |
|
|
|
return ret; // Object |
|
} |
|
|
|
dojo.lang.firstValued = function(/* ... */){ |
|
// summary: Return the first argument that isn't undefined |
|
|
|
for(var i = 0; i < arguments.length; i++){ |
|
if(typeof arguments[i] != "undefined"){ |
|
return arguments[i]; // Object |
|
} |
|
} |
|
return undefined; // undefined |
|
} |
|
|
|
dojo.lang.getObjPathValue = function(/*String*/objpath, /*Object?*/context, /*Boolean?*/create){ |
|
// summary: |
|
// Gets a value from a reference specified as a string descriptor, |
|
// (e.g. "A.B") in the given context. |
|
// context: if not specified, dj_global is used |
|
// create: if true, undefined objects in the path are created. |
|
with(dojo.parseObjPath(objpath, context, create)){ |
|
return dojo.evalProp(prop, obj, create); // Object |
|
} |
|
} |
|
|
|
dojo.lang.setObjPathValue = function(/*String*/objpath, /*anything*/value, /*Object?*/context, /*Boolean?*/create){ |
|
// summary: |
|
// Sets a value on a reference specified as a string descriptor. |
|
// (e.g. "A.B") in the given context. This is similar to straight |
|
// assignment, except that the object structure in question can |
|
// optionally be created if it does not exist. |
|
// context: if not specified, dj_global is used |
|
// create: if true, undefined objects in the path are created. |
|
|
|
// FIXME: why is this function valuable? It should be scheduled for |
|
// removal on the grounds that dojo.parseObjPath does most of it's work and |
|
// is more straightforward and has fewer dependencies. Also, the order of |
|
// arguments is bone-headed. "context" should clearly come after "create". |
|
// *sigh* |
|
dojo.deprecated("dojo.lang.setObjPathValue", "use dojo.parseObjPath and the '=' operator", "0.6"); |
|
|
|
if(arguments.length < 4){ |
|
create = true; |
|
} |
|
with(dojo.parseObjPath(objpath, context, create)){ |
|
if(obj && (create || (prop in obj))){ |
|
obj[prop] = value; |
|
} |
|
} |
|
} |
|
|
|
dojo.provide("dojo.io.common"); |
|
|
|
|
|
|
|
/****************************************************************************** |
|
* Notes about dojo.io design: |
|
* |
|
* The dojo.io.* package has the unenviable task of making a lot of different |
|
* types of I/O feel natural, despite a universal lack of good (or even |
|
* reasonable!) I/O capability in the host environment. So lets pin this down |
|
* a little bit further. |
|
* |
|
* Rhino: |
|
* perhaps the best situation anywhere. Access to Java classes allows you |
|
* to do anything one might want in terms of I/O, both synchronously and |
|
* async. Can open TCP sockets and perform low-latency client/server |
|
* interactions. HTTP transport is available through Java HTTP client and |
|
* server classes. Wish it were always this easy. |
|
* |
|
* xpcshell: |
|
* XPCOM for I/O. |
|
* |
|
* spidermonkey: |
|
* S.O.L. |
|
* |
|
* Browsers: |
|
* Browsers generally do not provide any useable filesystem access. We are |
|
* therefore limited to HTTP for moving information to and from Dojo |
|
* instances living in a browser. |
|
* |
|
* XMLHTTP: |
|
* Sync or async, allows reading of arbitrary text files (including |
|
* JS, which can then be eval()'d), writing requires server |
|
* cooperation and is limited to HTTP mechanisms (POST and GET). |
|
* |
|
* <iframe> hacks: |
|
* iframe document hacks allow browsers to communicate asynchronously |
|
* with a server via HTTP POST and GET operations. With significant |
|
* effort and server cooperation, low-latency data transit between |
|
* client and server can be acheived via iframe mechanisms (repubsub). |
|
* |
|
* SVG: |
|
* Adobe's SVG viewer implements helpful primitives for XML-based |
|
* requests, but receipt of arbitrary text data seems unlikely w/o |
|
* <![CDATA[]]> sections. |
|
* |
|
* |
|
* A discussion between Dylan, Mark, Tom, and Alex helped to lay down a lot |
|
* the IO API interface. A transcript of it can be found at: |
|
* http://dojotoolkit.org/viewcvs/viewcvs.py/documents/irc/irc_io_api_log.txt?rev=307&view=auto |
|
* |
|
* Also referenced in the design of the API was the DOM 3 L&S spec: |
|
* http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407/load-save.html |
|
******************************************************************************/ |
|
|
|
// a map of the available transport options. Transports should add themselves |
|
// by calling add(name) |
|
dojo.io.transports = []; |
|
dojo.io.hdlrFuncNames = [ "load", "error", "timeout" ]; // we're omitting a progress() event for now |
|
|
|
dojo.io.Request = function(/*String*/ url, /*String*/ mimetype, /*String*/ transport, /*String or Boolean*/ changeUrl){ |
|
// summary: |
|
// Constructs a Request object that is used by dojo.io.bind(). |
|
// description: |
|
// dojo.io.bind() will create one of these for you if |
|
// you call dojo.io.bind() with an plain object containing the bind parameters. |
|
// This method can either take the arguments specified, or an Object containing all of the parameters that you |
|
// want to use to create the dojo.io.Request (similar to how dojo.io.bind() is called. |
|
// The named parameters to this constructor represent the minimum set of parameters need |
|
if((arguments.length == 1)&&(arguments[0].constructor == Object)){ |
|
this.fromKwArgs(arguments[0]); |
|
}else{ |
|
this.url = url; |
|
if(mimetype){ this.mimetype = mimetype; } |
|
if(transport){ this.transport = transport; } |
|
if(arguments.length >= 4){ this.changeUrl = changeUrl; } |
|
} |
|
} |
|
|
|
dojo.lang.extend(dojo.io.Request, { |
|
|
|
/** The URL to hit */ |
|
url: "", |
|
|
|
/** The mime type used to interrpret the response body */ |
|
mimetype: "text/plain", |
|
|
|
/** The HTTP method to use */ |
|
method: "GET", |
|
|
|
/** An Object containing key-value pairs to be included with the request */ |
|
content: undefined, // Object |
|
|
|
/** The transport medium to use */ |
|
transport: undefined, // String |
|
|
|
/** If defined the URL of the page is physically changed */ |
|
changeUrl: undefined, // String |
|
|
|
/** A form node to use in the request */ |
|
formNode: undefined, // HTMLFormElement |
|
|
|
/** Whether the request should be made synchronously */ |
|
sync: false, |
|
|
|
bindSuccess: false, |
|
|
|
/** Cache/look for the request in the cache before attempting to request? |
|
* NOTE: this isn't a browser cache, this is internal and would only cache in-page |
|
*/ |
|
useCache: false, |
|
|
|
/** Prevent the browser from caching this by adding a query string argument to the URL */ |
|
preventCache: false, |
|
|
|
// events stuff |
|
load: function(/*String*/type, /*Object*/data, /*Object*/transportImplementation, /*Object*/kwArgs){ |
|
// summary: |
|
// Called on successful completion of a bind. |
|
// type: String |
|
// A string with value "load" |
|
// data: Object |
|
// The object representing the result of the bind. The actual structure |
|
// of the data object will depend on the mimetype that was given to bind |
|
// in the bind arguments. |
|
// transportImplementation: Object |
|
// The object that implements a particular transport. Structure is depedent |
|
// on the transport. For XMLHTTPTransport (dojo.io.BrowserIO), it will be the |
|
// XMLHttpRequest object from the browser. |
|
// kwArgs: Object |
|
// Object that contains the request parameters that were given to the |
|
// bind call. Useful for storing and retrieving state from when bind |
|
// was called. |
|
}, |
|
error: function(/*String*/type, /*Object*/error, /*Object*/transportImplementation, /*Object*/kwArgs){ |
|
// summary: |
|
// Called when there is an error with a bind. |
|
// type: String |
|
// A string with value "error" |
|
// error: Object |
|
// The error object. Should be a dojo.io.Error object, but not guaranteed. |
|
// transportImplementation: Object |
|
// The object that implements a particular transport. Structure is depedent |
|
// on the transport. For XMLHTTPTransport (dojo.io.BrowserIO), it will be the |
|
// XMLHttpRequest object from the browser. |
|
// kwArgs: Object |
|
// Object that contains the request parameters that were given to the |
|
// bind call. Useful for storing and retrieving state from when bind |
|
// was called. |
|
}, |
|
timeout: function(/*String*/type, /*Object*/empty, /*Object*/transportImplementation, /*Object*/kwArgs){ |
|
// summary: |
|
// Called when there is an error with a bind. Only implemented in certain transports at this time. |
|
// type: String |
|
// A string with value "timeout" |
|
// empty: Object |
|
// Should be null. Just a spacer argument so that load, error, timeout and handle have the |
|
// same signatures. |
|
// transportImplementation: Object |
|
// The object that implements a particular transport. Structure is depedent |
|
// on the transport. For XMLHTTPTransport (dojo.io.BrowserIO), it will be the |
|
// XMLHttpRequest object from the browser. May be null for the timeout case for |
|
// some transports. |
|
// kwArgs: Object |
|
// Object that contains the request parameters that were given to the |
|
// bind call. Useful for storing and retrieving state from when bind |
|
// was called. |
|
}, |
|
handle: function(/*String*/type, /*Object*/data, /*Object*/transportImplementation, /*Object*/kwArgs){ |
|
// summary: |
|
// The handle method can be defined instead of defining separate load, error and timeout |
|
// callbacks. |
|
// type: String |
|
// A string with the type of callback: "load", "error", or "timeout". |
|
// data: Object |
|
// See the above callbacks for what this parameter could be. |
|
// transportImplementation: Object |
|
// The object that implements a particular transport. Structure is depedent |
|
// on the transport. For XMLHTTPTransport (dojo.io.BrowserIO), it will be the |
|
// XMLHttpRequest object from the browser. |
|
// kwArgs: Object |
|
// Object that contains the request parameters that were given to the |
|
// bind call. Useful for storing and retrieving state from when bind |
|
// was called. |
|
}, |
|
|
|
//FIXME: change IframeIO.js to use timeouts? |
|
// The number of seconds to wait until firing a timeout callback. |
|
// If it is zero, that means, don't do a timeout check. |
|
timeoutSeconds: 0, |
|
|
|
// the abort method needs to be filled in by the transport that accepts the |
|
// bind() request |
|
abort: function(){ }, |
|
|
|
// backButton: function(){ }, |
|
// forwardButton: function(){ }, |
|
|
|
fromKwArgs: function(/*Object*/ kwArgs){ |
|
// summary: |
|
// Creates a dojo.io.Request from a simple object (kwArgs object). |
|
|
|
// normalize args |
|
if(kwArgs["url"]){ kwArgs.url = kwArgs.url.toString(); } |
|
if(kwArgs["formNode"]) { kwArgs.formNode = dojo.byId(kwArgs.formNode); } |
|
if(!kwArgs["method"] && kwArgs["formNode"] && kwArgs["formNode"].method) { |
|
kwArgs.method = kwArgs["formNode"].method; |
|
} |
|
|
|
// backwards compatibility |
|
if(!kwArgs["handle"] && kwArgs["handler"]){ kwArgs.handle = kwArgs.handler; } |
|
if(!kwArgs["load"] && kwArgs["loaded"]){ kwArgs.load = kwArgs.loaded; } |
|
if(!kwArgs["changeUrl"] && kwArgs["changeURL"]) { kwArgs.changeUrl = kwArgs.changeURL; } |
|
|
|
// encoding fun! |
|
kwArgs.encoding = dojo.lang.firstValued(kwArgs["encoding"], djConfig["bindEncoding"], ""); |
|
|
|
kwArgs.sendTransport = dojo.lang.firstValued(kwArgs["sendTransport"], djConfig["ioSendTransport"], false); |
|
|
|
var isFunction = dojo.lang.isFunction; |
|
for(var x=0; x<dojo.io.hdlrFuncNames.length; x++){ |
|
var fn = dojo.io.hdlrFuncNames[x]; |
|
if(kwArgs[fn] && isFunction(kwArgs[fn])){ continue; } |
|
if(kwArgs["handle"] && isFunction(kwArgs["handle"])){ |
|
kwArgs[fn] = kwArgs.handle; |
|
} |
|
// handler is aliased above, shouldn't need this check |
|
/* else if(dojo.lang.isObject(kwArgs.handler)){ |
|
if(isFunction(kwArgs.handler[fn])){ |
|
kwArgs[fn] = kwArgs.handler[fn]||kwArgs.handler["handle"]||function(){}; |
|
} |
|
}*/ |
|
} |
|
dojo.lang.mixin(this, kwArgs); |
|
} |
|
|
|
}); |
|
|
|
dojo.io.Error = function(/*String*/ msg, /*String*/ type, /*Number*/num){ |
|
// summary: |
|
// Constructs an object representing a bind error. |
|
this.message = msg; |
|
this.type = type || "unknown"; // must be one of "io", "parse", "unknown" |
|
this.number = num || 0; // per-substrate error number, not normalized |
|
} |
|
|
|
dojo.io.transports.addTransport = function(/*String*/name){ |
|
// summary: |
|
// Used to register transports that can support bind calls. |
|
this.push(name); |
|
// FIXME: do we need to handle things that aren't direct children of the |
|
// dojo.io module? (say, dojo.io.foo.fooTransport?) |
|
this[name] = dojo.io[name]; |
|
} |
|
|
|
// binding interface, the various implementations register their capabilities |
|
// and the bind() method dispatches |
|
dojo.io.bind = function(/*dojo.io.Request or Object*/request){ |
|
// summary: |
|
// Binding interface for IO. Loading different IO transports, like |
|
// dojo.io.BrowserIO or dojo.io.IframeIO, will register with bind |
|
// to handle particular types of bind calls. |
|
// request: Object |
|
// Object containing bind arguments. This object is converted to |
|
// a dojo.io.Request object, and that request object is the return |
|
// value for this method. |
|
if(!(request instanceof dojo.io.Request)){ |
|
try{ |
|
request = new dojo.io.Request(request); |
|
}catch(e){ dojo.debug(e); } |
|
} |
|
|
|
// if the request asks for a particular implementation, use it |
|
var tsName = ""; |
|
if(request["transport"]){ |
|
tsName = request["transport"]; |
|
if(!this[tsName]){ |
|
dojo.io.sendBindError(request, "No dojo.io.bind() transport with name '" |
|
+ request["transport"] + "'."); |
|
return request; //dojo.io.Request |
|
} |
|
if(!this[tsName].canHandle(request)){ |
|
dojo.io.sendBindError(request, "dojo.io.bind() transport with name '" |
|
+ request["transport"] + "' cannot handle this type of request."); |
|
return request; //dojo.io.Request |
|
} |
|
}else{ |
|
// otherwise we do our best to auto-detect what available transports |
|
// will handle |
|
for(var x=0; x<dojo.io.transports.length; x++){ |
|
var tmp = dojo.io.transports[x]; |
|
if((this[tmp])&&(this[tmp].canHandle(request))){ |
|
tsName = tmp; |
|
break; |
|
} |
|
} |
|
if(tsName == ""){ |
|
dojo.io.sendBindError(request, "None of the loaded transports for dojo.io.bind()" |
|
+ " can handle the request."); |
|
return request; //dojo.io.Request |
|
} |
|
} |
|
this[tsName].bind(request); |
|
request.bindSuccess = true; |
|
return request; //dojo.io.Request |
|
} |
|
|
|
dojo.io.sendBindError = function(/* Object */request, /* String */message){ |
|
// summary: |
|
// Used internally by dojo.io.bind() to return/raise a bind error. |
|
|
|
//Need to be careful since not all hostenvs support setTimeout. |
|
if((typeof request.error == "function" || typeof request.handle == "function") |
|
&& (typeof setTimeout == "function" || typeof setTimeout == "object")){ |
|
var errorObject = new dojo.io.Error(message); |
|
setTimeout(function(){ |
|
request[(typeof request.error == "function") ? "error" : "handle"]("error", errorObject, null, request); |
|
}, 50); |
|
}else{ |
|
dojo.raise(message); |
|
} |
|
} |
|
|
|
dojo.io.queueBind = function(/*dojo.io.Request or Object*/request){ |
|
// summary: |
|
// queueBind will use dojo.io.bind() but guarantee that only one bind |
|
// call is handled at a time. |
|
// description: |
|
// If queueBind is called while a bind call |
|
// is in process, it will queue up the other calls to bind and call them |
|
// in order as bind calls complete. |
|
// request: Object |
|
// Same sort of request object as used for dojo.io.bind(). |
|
if(!(request instanceof dojo.io.Request)){ |
|
try{ |
|
request = new dojo.io.Request(request); |
|
}catch(e){ dojo.debug(e); } |
|
} |
|
|
|
// make sure we get called if/when we get a response |
|
var oldLoad = request.load; |
|
request.load = function(){ |
|
dojo.io._queueBindInFlight = false; |
|
var ret = oldLoad.apply(this, arguments); |
|
dojo.io._dispatchNextQueueBind(); |
|
return ret; |
|
} |
|
|
|
var oldErr = request.error; |
|
request.error = function(){ |
|
dojo.io._queueBindInFlight = false; |
|
var ret = oldErr.apply(this, arguments); |
|
dojo.io._dispatchNextQueueBind(); |
|
return ret; |
|
} |
|
|
|
dojo.io._bindQueue.push(request); |
|
dojo.io._dispatchNextQueueBind(); |
|
return request; //dojo.io.Request |
|
} |
|
|
|
dojo.io._dispatchNextQueueBind = function(){ |
|
// summary: |
|
// Private method used by dojo.io.queueBind(). |
|
if(!dojo.io._queueBindInFlight){ |
|
dojo.io._queueBindInFlight = true; |
|
if(dojo.io._bindQueue.length > 0){ |
|
dojo.io.bind(dojo.io._bindQueue.shift()); |
|
}else{ |
|
dojo.io._queueBindInFlight = false; |
|
} |
|
} |
|
} |
|
dojo.io._bindQueue = []; |
|
dojo.io._queueBindInFlight = false; |
|
|
|
dojo.io.argsFromMap = function(/*Object*/map, /*String?*/encoding, /*String?*/last){ |
|
// summary: |
|
// Converts name/values pairs in the map object to an URL-encoded string |
|
// with format of name1=value1&name2=value2... |
|
// map: Object |
|
// Object that has the contains the names and values. |
|
// encoding: String? |
|
// String to specify how to encode the name and value. If the encoding string |
|
// contains "utf" (case-insensitive), then encodeURIComponent is used. Otherwise |
|
// dojo.string.encodeAscii is used. |
|
// last: String? |
|
// The last parameter in the list. Helps with final string formatting? |
|
var enc = /utf/i.test(encoding||"") ? encodeURIComponent : dojo.string.encodeAscii; |
|
var mapped = []; |
|
var control = new Object(); |
|
for(var name in map){ |
|
var domap = function(elt){ |
|
var val = enc(name)+"="+enc(elt); |
|
mapped[(last == name) ? "push" : "unshift"](val); |
|
} |
|
if(!control[name]){ |
|
var value = map[name]; |
|
// FIXME: should be isArrayLike? |
|
if (dojo.lang.isArray(value)){ |
|
dojo.lang.forEach(value, domap); |
|
}else{ |
|
domap(value); |
|
} |
|
} |
|
} |
|
return mapped.join("&"); //String |
|
} |
|
|
|
dojo.io.setIFrameSrc = function(/*DOMNode*/ iframe, /*String*/ src, /*Boolean*/ replace){ |
|
//summary: |
|
// Sets the URL that is loaded in an IFrame. The replace parameter indicates whether |
|
// location.replace() should be used when changing the location of the iframe. |
|
try{ |
|
var r = dojo.render.html; |
|
// dojo.debug(iframe); |
|
if(!replace){ |
|
if(r.safari){ |
|
iframe.location = src; |
|
}else{ |
|
frames[iframe.name].location = src; |
|
} |
|
}else{ |
|
// Fun with DOM 0 incompatibilities! |
|
var idoc; |
|
if(r.ie){ |
|
idoc = iframe.contentWindow.document; |
|
}else if(r.safari){ |
|
idoc = iframe.document; |
|
}else{ // if(r.moz){ |
|
idoc = iframe.contentWindow; |
|
} |
|
|
|
//For Safari (at least 2.0.3) and Opera, if the iframe |
|
//has just been created but it doesn't have content |
|
//yet, then iframe.document may be null. In that case, |
|
//use iframe.location and return. |
|
if(!idoc){ |
|
iframe.location = src; |
|
return; |
|
}else{ |
|
idoc.location.replace(src); |
|
} |
|
} |
|
}catch(e){ |
|
dojo.debug(e); |
|
dojo.debug("setIFrameSrc: "+e); |
|
} |
|
} |
|
|
|
/* |
|
dojo.io.sampleTranport = new function(){ |
|
this.canHandle = function(kwArgs){ |
|
// canHandle just tells dojo.io.bind() if this is a good transport to |
|
// use for the particular type of request. |
|
if( |
|
( |
|
(kwArgs["mimetype"] == "text/plain") || |
|
(kwArgs["mimetype"] == "text/html") || |
|
(kwArgs["mimetype"] == "text/javascript") |
|
)&&( |
|
(kwArgs["method"] == "get") || |
|
( (kwArgs["method"] == "post") && (!kwArgs["formNode"]) ) |
|
) |
|
){ |
|
return true; |
|
} |
|
|
|
return false; |
|
} |
|
|
|
this.bind = function(kwArgs){ |
|
var hdlrObj = {}; |
|
|
|
// set up a handler object |
|
for(var x=0; x<dojo.io.hdlrFuncNames.length; x++){ |
|
var fn = dojo.io.hdlrFuncNames[x]; |
|
if(typeof kwArgs.handler == "object"){ |
|
if(typeof kwArgs.handler[fn] == "function"){ |
|
hdlrObj[fn] = kwArgs.handler[fn]||kwArgs.handler["handle"]; |
|
} |
|
}else if(typeof kwArgs[fn] == "function"){ |
|
hdlrObj[fn] = kwArgs[fn]; |
|
}else{ |
|
hdlrObj[fn] = kwArgs["handle"]||function(){}; |
|
} |
|
} |
|
|
|
// build a handler function that calls back to the handler obj |
|
var hdlrFunc = function(evt){ |
|
if(evt.type == "onload"){ |
|
hdlrObj.load("load", evt.data, evt); |
|
}else if(evt.type == "onerr"){ |
|
var errObj = new dojo.io.Error("sampleTransport Error: "+evt.msg); |
|
hdlrObj.error("error", errObj); |
|
} |
|
} |
|
|
|
// the sample transport would attach the hdlrFunc() when sending the |
|
// request down the pipe at this point |
|
var tgtURL = kwArgs.url+"?"+dojo.io.argsFromMap(kwArgs.content); |
|
// sampleTransport.sendRequest(tgtURL, hdlrFunc); |
|
} |
|
|
|
dojo.io.transports.addTransport("sampleTranport"); |
|
} |
|
*/ |
|
|
|
dojo.provide("dojo.lang.array"); |
|
|
|
|
|
|
|
// FIXME: Is this worthless since you can do: if(name in obj) |
|
// is this the right place for this? |
|
|
|
dojo.lang.mixin(dojo.lang, { |
|
has: function(/*Object*/obj, /*String*/name){ |
|
// summary: is there a property with the passed name in obj? |
|
try{ |
|
return typeof obj[name] != "undefined"; // Boolean |
|
}catch(e){ return false; } // Boolean |
|
}, |
|
|
|
isEmpty: function(/*Object*/obj){ |
|
// summary: |
|
// can be used to determine if the passed object is "empty". In |
|
// the case of array-like objects, the length, property is |
|
// examined, but for other types of objects iteration is used to |
|
// examine the iterable "surface area" to determine if any |
|
// non-prototypal properties have been assigned. This iteration is |
|
// prototype-extension safe. |
|
if(dojo.lang.isObject(obj)){ |
|
var tmp = {}; |
|
var count = 0; |
|
for(var x in obj){ |
|
if(obj[x] && (!tmp[x])){ |
|
count++; |
|
break; |
|
} |
|
} |
|
return count == 0; // boolean |
|
}else if(dojo.lang.isArrayLike(obj) || dojo.lang.isString(obj)){ |
|
return obj.length == 0; // boolean |
|
} |
|
}, |
|
|
|
map: function(/*Array*/arr, /*Object|Function*/obj, /*Function?*/unary_func){ |
|
// summary: |
|
// returns a new array constituded from the return values of |
|
// passing each element of arr into unary_func. The obj parameter |
|
// may be passed to enable the passed function to be called in |
|
// that scope. In environments that support JavaScript 1.6, this |
|
// function is a passthrough to the built-in map() function |
|
// provided by Array instances. For details on this, see: |
|
// http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:map |
|
// examples: |
|
// dojo.lang.map([1, 2, 3, 4], function(item){ return item+1 }); |
|
// // returns [2, 3, 4, 5] |
|
var isString = dojo.lang.isString(arr); |
|
if(isString){ |
|
// arr: String |
|
arr = arr.split(""); |
|
} |
|
if(dojo.lang.isFunction(obj)&&(!unary_func)){ |
|
unary_func = obj; |
|
obj = dj_global; |
|
}else if(dojo.lang.isFunction(obj) && unary_func){ |
|
// ff 1.5 compat |
|
var tmpObj = obj; |
|
obj = unary_func; |
|
unary_func = tmpObj; |
|
} |
|
if(Array.map){ |
|
var outArr = Array.map(arr, unary_func, obj); |
|
}else{ |
|
var outArr = []; |
|
for(var i=0;i<arr.length;++i){ |
|
outArr.push(unary_func.call(obj, arr[i])); |
|
} |
|
} |
|
if(isString) { |
|
return outArr.join(""); // String |
|
} else { |
|
return outArr; // Array |
|
} |
|
}, |
|
|
|
reduce: function(/*Array*/arr, initialValue, /*Object|Function*/obj, /*Function*/binary_func){ |
|
// summary: |
|
// similar to Python's builtin reduce() function. The result of |
|
// the previous computation is passed as the first argument to |
|
// binary_func along with the next value from arr. The result of |
|
// this call is used along with the subsequent value from arr, and |
|
// this continues until arr is exhausted. The return value is the |
|
// last result. The "obj" and "initialValue" parameters may be |
|
// safely omitted and the order of obj and binary_func may be |
|
// reversed. The default order of the obj and binary_func argument |
|
// will probably be reversed in a future release, and this call |
|
// order is supported today. |
|
// examples: |
|
// dojo.lang.reduce([1, 2, 3, 4], function(last, next){ return last+next}); |
|
// returns 10 |
|
var reducedValue = initialValue; |
|
if(arguments.length == 2){ |
|
binary_func = initialValue; |
|
reducedValue = arr[0]; |
|
arr = arr.slice(1); |
|
}else if(arguments.length == 3){ |
|
if(dojo.lang.isFunction(obj)){ |
|
binary_func = obj; |
|
obj = null; |
|
} |
|
}else{ |
|
// un-fsck the default order |
|
// FIXME: |
|
// could be wrong for some strange function object cases. Not |
|
// sure how to test for them. |
|
if(dojo.lang.isFunction(obj)){ |
|
var tmp = binary_func; |
|
binary_func = obj; |
|
obj = tmp; |
|
} |
|
} |
|
|
|
var ob = obj || dj_global; |
|
dojo.lang.map(arr, |
|
function(val){ |
|
reducedValue = binary_func.call(ob, reducedValue, val); |
|
} |
|
); |
|
return reducedValue; |
|
}, |
|
|
|
forEach: function(/*Array*/anArray, /*Function*/callback, /*Object?*/thisObject){ |
|
// summary: |
|
// for every item in anArray, call callback with that item as its |
|
// only parameter. Return values are ignored. This funciton |
|
// corresponds (and wraps) the JavaScript 1.6 forEach method. For |
|
// more details, see: |
|
// http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:forEach |
|
if(dojo.lang.isString(anArray)){ |
|
// anArray: String |
|
anArray = anArray.split(""); |
|
} |
|
if(Array.forEach){ |
|
Array.forEach(anArray, callback, thisObject); |
|
}else{ |
|
// FIXME: there are several ways of handilng thisObject. Is dj_global always the default context? |
|
if(!thisObject){ |
|
thisObject=dj_global; |
|
} |
|
for(var i=0,l=anArray.length; i<l; i++){ |
|
callback.call(thisObject, anArray[i], i, anArray); |
|
} |
|
} |
|
}, |
|
|
|
_everyOrSome: function(/*Boolean*/every, /*Array*/arr, /*Function*/callback, /*Object?*/thisObject){ |
|
if(dojo.lang.isString(arr)){ |
|
//arr: String |
|
arr = arr.split(""); |
|
} |
|
if(Array.every){ |
|
return Array[ every ? "every" : "some" ](arr, callback, thisObject); |
|
}else{ |
|
if(!thisObject){ |
|
thisObject = dj_global; |
|
} |
|
for(var i=0,l=arr.length; i<l; i++){ |
|
var result = callback.call(thisObject, arr[i], i, arr); |
|
if(every && !result){ |
|
return false; // Boolean |
|
}else if((!every)&&(result)){ |
|
return true; // Boolean |
|
} |
|
} |
|
return Boolean(every); // Boolean |
|
} |
|
}, |
|
|
|
every: function(/*Array*/arr, /*Function*/callback, /*Object?*/thisObject){ |
|
// summary: |
|
// determines whether or not every item in the array satisfies the |
|
// condition implemented by callback. thisObject may be used to |
|
// scope the call to callback. The function signature is derived |
|
// from the JavaScript 1.6 Array.every() function. More |
|
// information on this can be found here: |
|
// http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:every |
|
// examples: |
|
// dojo.lang.every([1, 2, 3, 4], function(item){ return item>1; }); |
|
// // returns false |
|
// dojo.lang.every([1, 2, 3, 4], function(item){ return item>0; }); |
|
// // returns true |
|
return this._everyOrSome(true, arr, callback, thisObject); // Boolean |
|
}, |
|
|
|
some: function(/*Array*/arr, /*Function*/callback, /*Object?*/thisObject){ |
|
// summary: |
|
// determines whether or not any item in the array satisfies the |
|
// condition implemented by callback. thisObject may be used to |
|
// scope the call to callback. The function signature is derived |
|
// from the JavaScript 1.6 Array.some() function. More |
|
// information on this can be found here: |
|
// http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:some |
|
// examples: |
|
// dojo.lang.some([1, 2, 3, 4], function(item){ return item>1; }); |
|
// // returns true |
|
// dojo.lang.some([1, 2, 3, 4], function(item){ return item<1; }); |
|
// // returns false |
|
return this._everyOrSome(false, arr, callback, thisObject); // Boolean |
|
}, |
|
|
|
filter: function(/*Array*/arr, /*Function*/callback, /*Object?*/thisObject){ |
|
// summary: |
|
// returns a new Array with those items from arr that match the |
|
// condition implemented by callback.thisObject may be used to |
|
// scope the call to callback. The function signature is derived |
|
// from the JavaScript 1.6 Array.filter() function, although |
|
// special accomidation is made in our implementation for strings. |
|
// More information on the JS 1.6 API can be found here: |
|
// http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:filter |
|
// examples: |
|
// dojo.lang.some([1, 2, 3, 4], function(item){ return item>1; }); |
|
// // returns [2, 3, 4] |
|
var isString = dojo.lang.isString(arr); |
|
if(isString){ /*arr: String*/arr = arr.split(""); } |
|
var outArr; |
|
if(Array.filter){ |
|
outArr = Array.filter(arr, callback, thisObject); |
|
}else{ |
|
if(!thisObject){ |
|
if(arguments.length >= 3){ dojo.raise("thisObject doesn't exist!"); } |
|
thisObject = dj_global; |
|
} |
|
|
|
outArr = []; |
|
for(var i = 0; i < arr.length; i++){ |
|
if(callback.call(thisObject, arr[i], i, arr)){ |
|
outArr.push(arr[i]); |
|
} |
|
} |
|
} |
|
if(isString){ |
|
return outArr.join(""); // String |
|
} else { |
|
return outArr; // Array |
|
} |
|
}, |
|
|
|
unnest: function(/* ... */){ |
|
// summary: |
|
// Creates a 1-D array out of all the arguments passed, |
|
// unravelling any array-like objects in the process |
|
// usage: |
|
// unnest(1, 2, 3) ==> [1, 2, 3] |
|
// unnest(1, [2, [3], [[[4]]]]) ==> [1, 2, 3, 4] |
|
|
|
var out = []; |
|
for(var i = 0; i < arguments.length; i++){ |
|
if(dojo.lang.isArrayLike(arguments[i])){ |
|
var add = dojo.lang.unnest.apply(this, arguments[i]); |
|
out = out.concat(add); |
|
}else{ |
|
out.push(arguments[i]); |
|
} |
|
} |
|
return out; // Array |
|
}, |
|
|
|
toArray: function(/*Object*/arrayLike, /*Number*/startOffset){ |
|
// summary: |
|
// Converts an array-like object (i.e. arguments, DOMCollection) |
|
// to an array. Returns a new Array object. |
|
var array = []; |
|
for(var i = startOffset||0; i < arrayLike.length; i++){ |
|
array.push(arrayLike[i]); |
|
} |
|
return array; // Array |
|
} |
|
}); |
|
|
|
dojo.provide("dojo.lang.func"); |
|
|
|
|
|
dojo.lang.hitch = function(/*Object*/thisObject, /*Function|String*/method){ |
|
// summary: |
|
// Returns a function that will only ever execute in the a given scope |
|
// (thisObject). This allows for easy use of object member functions |
|
// in callbacks and other places in which the "this" keyword may |
|
// otherwise not reference the expected scope. Note that the order of |
|
// arguments may be reversed in a future version. |
|
// thisObject: the scope to run the method in |
|
// method: |
|
// a function to be "bound" to thisObject or the name of the method in |
|
// thisObject to be used as the basis for the binding |
|
// usage: |
|
// dojo.lang.hitch(foo, "bar")(); // runs foo.bar() in the scope of foo |
|
// dojo.lang.hitch(foo, myFunction); // returns a function that runs myFunction in the scope of foo |
|
|
|
// FIXME: |
|
// should this be extended to "fixate" arguments in a manner similar |
|
// to dojo.lang.curry, but without the default execution of curry()? |
|
var fcn = (dojo.lang.isString(method) ? thisObject[method] : method) || function(){}; |
|
return function(){ |
|
return fcn.apply(thisObject, arguments); // Function |
|
}; |
|
} |
|
|
|
dojo.lang.anonCtr = 0; |
|
dojo.lang.anon = {}; |
|
|
|
dojo.lang.nameAnonFunc = function(/*Function*/anonFuncPtr, /*Object*/thisObj, /*Boolean*/searchForNames){ |
|
// summary: |
|
// Creates a reference to anonFuncPtr in thisObj with a completely |
|
// unique name. The new name is returned as a String. If |
|
// searchForNames is true, an effort will be made to locate an |
|
// existing reference to anonFuncPtr in thisObj, and if one is found, |
|
// the existing name will be returned instead. The default is for |
|
// searchForNames to be false. |
|
var nso = (thisObj|| dojo.lang.anon); |
|
if( (searchForNames) || |
|
((dj_global["djConfig"])&&(djConfig["slowAnonFuncLookups"] == true)) ){ |
|
for(var x in nso){ |
|
try{ |
|
if(nso[x] === anonFuncPtr){ |
|
return x; |
|
} |
|
}catch(e){} // window.external fails in IE embedded in Eclipse (Eclipse bug #151165) |
|
} |
|
} |
|
var ret = "__"+dojo.lang.anonCtr++; |
|
while(typeof nso[ret] != "undefined"){ |
|
ret = "__"+dojo.lang.anonCtr++; |
|
} |
|
nso[ret] = anonFuncPtr; |
|
return ret; // String |
|
} |
|
|
|
dojo.lang.forward = function(funcName){ |
|
// summary: |
|
// Returns a function that forwards a method call to |
|
// this.funcName(...). Unlike dojo.lang.hitch(), the "this" scope is |
|
// not fixed on a single object. Ported from MochiKit. |
|
return function(){ |
|
return this[funcName].apply(this, arguments); |
|
}; // Function |
|
} |
|
|
|
dojo.lang.curry = function(thisObj, func /* args ... */){ |
|
// summary: |
|
// similar to the curry() method found in many functional programming |
|
// environments, this function returns an "argument accumulator" |
|
// function, bound to a particular scope, and "primed" with a variable |
|
// number of arguments. The curry method is unique in that it returns |
|
// a function that may return other "partial" function which can be |
|
// called repeatedly. New functions are returned until the arity of |
|
// the original function is reached, at which point the underlying |
|
// function (func) is called in the scope thisObj with all of the |
|
// accumulated arguments (plus any extras) in positional order. |
|
// examples: |
|
// assuming a function defined like this: |
|
// var foo = { |
|
// bar: function(arg1, arg2, arg3){ |
|
// dojo.debug.apply(dojo, arguments); |
|
// } |
|
// }; |
|
// |
|
// dojo.lang.curry() can be used most simply in this way: |
|
// |
|
// tmp = dojo.lang.curry(foo, foo.bar, "arg one", "thinger"); |
|
// tmp("blah", "this is superfluous"); |
|
// // debugs: "arg one thinger blah this is superfluous" |
|
// tmp("blah"); |
|
// // debugs: "arg one thinger blah" |
|
// tmp(); |
|
// // returns a function exactly like tmp that expects one argument |
|
// |
|
// other intermittent functions could be created until the 3 |
|
// positional arguments are filled: |
|
// |
|
// tmp = dojo.lang.curry(foo, foo.bar, "arg one"); |
|
// tmp2 = tmp("arg two"); |
|
// tmp2("blah blah"); |
|
// // debugs: "arg one arg two blah blah" |
|
// tmp2("oy"); |
|
// // debugs: "arg one arg two oy" |
|
// |
|
// curry() can also be used to call the function if enough arguments |
|
// are passed in the initial invocation: |
|
// |
|
// dojo.lang.curry(foo, foo.bar, "one", "two", "three", "four"); |
|
// // debugs: "one two three four" |
|
// dojo.lang.curry(foo, foo.bar, "one", "two", "three"); |
|
// // debugs: "one two three" |
|
|
|
|
|
// FIXME: the order of func and thisObj should be changed!!! |
|
var outerArgs = []; |
|
thisObj = thisObj||dj_global; |
|
if(dojo.lang.isString(func)){ |
|
func = thisObj[func]; |
|
} |
|
for(var x=2; x<arguments.length; x++){ |
|
outerArgs.push(arguments[x]); |
|
} |
|
// since the event system replaces the original function with a new |
|
// join-point runner with an arity of 0, we check to see if it's left us |
|
// any clues about the original arity in lieu of the function's actual |
|
// length property |
|
var ecount = (func["__preJoinArity"]||func.length) - outerArgs.length; |
|
// borrowed from svend tofte |
|
function gather(nextArgs, innerArgs, expected){ |
|
var texpected = expected; |
|
var totalArgs = innerArgs.slice(0); // copy |
|
for(var x=0; x<nextArgs.length; x++){ |
|
totalArgs.push(nextArgs[x]); |
|
} |
|
// check the list of provided nextArgs to see if it, plus the |
|
// number of innerArgs already supplied, meets the total |
|
// expected. |
|
expected = expected-nextArgs.length; |
|
if(expected<=0){ |
|
var res = func.apply(thisObj, totalArgs); |
|
expected = texpected; |
|
return res; |
|
}else{ |
|
return function(){ |
|
return gather(arguments,// check to see if we've been run |
|
// with enough args |
|
totalArgs, // a copy |
|
expected); // how many more do we need to run?; |
|
}; |
|
} |
|
} |
|
return gather([], outerArgs, ecount); |
|
} |
|
|
|
dojo.lang.curryArguments = function(/*Object*/thisObj, /*Function*/func, /*Array*/args, /*Integer, optional*/offset){ |
|
// summary: |
|
// similar to dojo.lang.curry(), except that a list of arguments to |
|
// start the curry with may be provided as an array instead of as |
|
// positional arguments. An offset may be specified from the 0 index |
|
// to skip some elements in args. |
|
var targs = []; |
|
var x = offset||0; |
|
for(x=offset; x<args.length; x++){ |
|
targs.push(args[x]); // ensure that it's an arr |
|
} |
|
return dojo.lang.curry.apply(dojo.lang, [thisObj, func].concat(targs)); |
|
} |
|
|
|
dojo.lang.tryThese = function(/*...*/){ |
|
// summary: |
|
// executes each function argument in turn, returning the return value |
|
// from the first one which does not throw an exception in execution. |
|
// Any number of functions may be passed. |
|
for(var x=0; x<arguments.length; x++){ |
|
try{ |
|
if(typeof arguments[x] == "function"){ |
|
var ret = (arguments[x]()); |
|
if(ret){ |
|
return ret; |
|
} |
|
} |
|
}catch(e){ |
|
dojo.debug(e); |
|
} |
|
} |
|
} |
|
|
|
dojo.lang.delayThese = function(/*Array*/farr, /*Function, optional*/cb, /*Integer*/delay, /*Function, optional*/onend){ |
|
// summary: |
|
// executes a series of functions contained in farr, but spaces out |
|
// calls to each function by the millisecond delay provided. If cb is |
|
// provided, it will be called directly after each item in farr is |
|
// called and if onend is passed, it will be called when all items |
|
// have completed executing. |
|
|
|
/** |
|
* alternate: (array funcArray, function callback, function onend) |
|
* alternate: (array funcArray, function callback) |
|
* alternate: (array funcArray) |
|
*/ |
|
if(!farr.length){ |
|
if(typeof onend == "function"){ |
|
onend(); |
|
} |
|
return; |
|
} |
|
if((typeof delay == "undefined")&&(typeof cb == "number")){ |
|
delay = cb; |
|
cb = function(){}; |
|
}else if(!cb){ |
|
cb = function(){}; |
|
if(!delay){ delay = 0; } |
|
} |
|
setTimeout(function(){ |
|
(farr.shift())(); |
|
cb(); |
|
dojo.lang.delayThese(farr, cb, delay, onend); |
|
}, delay); |
|
} |
|
|
|
dojo.provide("dojo.string.extras"); |
|
|
|
|
|
|
|
|
|
|
|
//TODO: should we use ${} substitution syntax instead, like widgets do? |
|
dojo.string.substituteParams = function(/*string*/template, /* object - optional or ... */hash){ |
|
// summary: |
|
// Performs parameterized substitutions on a string. Throws an exception if any parameter is unmatched. |
|
// |
|
// description: |
|
// For example, |
|
// dojo.string.substituteParams("File '%{0}' is not found in directory '%{1}'.","foo.html","/temp"); |
|
// returns |
|
// "File 'foo.html' is not found in directory '/temp'." |
|
// |
|
// template: the original string template with %{values} to be replaced |
|
// hash: name/value pairs (type object) to provide substitutions. Alternatively, substitutions may be |
|
// included as arguments 1..n to this function, corresponding to template parameters 0..n-1 |
|
|
|
var map = (typeof hash == 'object') ? hash : dojo.lang.toArray(arguments, 1); |
|
|
|
return template.replace(/\%\{(\w+)\}/g, function(match, key){ |
|
if(typeof(map[key]) != "undefined" && map[key] != null){ |
|
return map[key]; |
|
} |
|
dojo.raise("Substitution not found: " + key); |
|
}); // string |
|
}; |
|
|
|
dojo.string.capitalize = function(/*string*/str){ |
|
// summary: |
|
// Uppercases the first letter of each word |
|
|
|
if(!dojo.lang.isString(str)){ return ""; } |
|
if(arguments.length == 0){ str = this; } |
|
|
|
var words = str.split(' '); |
|
for(var i=0; i<words.length; i++){ |
|
words[i] = words[i].charAt(0).toUpperCase() + words[i].substring(1); |
|
} |
|
return words.join(" "); // string |
|
} |
|
|
|
dojo.string.isBlank = function(/*string*/str){ |
|
// summary: |
|
// Return true if the entire string is whitespace characters |
|
|
|
if(!dojo.lang.isString(str)){ return true; } |
|
return (dojo.string.trim(str).length == 0); // boolean |
|
} |
|
|
|
//FIXME: not sure exactly what encodeAscii is trying to do, or if it's working right |
|
dojo.string.encodeAscii = function(/*string*/str){ |
|
if(!dojo.lang.isString(str)){ return str; } // unknown |
|
var ret = ""; |
|
var value = escape(str); |
|
var match, re = /%u([0-9A-F]{4})/i; |
|
while((match = value.match(re))){ |
|
var num = Number("0x"+match[1]); |
|
var newVal = escape("&#" + num + ";"); |
|
ret += value.substring(0, match.index) + newVal; |
|
value = value.substring(match.index+match[0].length); |
|
} |
|
ret += value.replace(/\+/g, "%2B"); |
|
return ret; // string |
|
} |
|
|
|
dojo.string.escape = function(/*string*/type, /*string*/str){ |
|
// summary: |
|
// Adds escape sequences for special characters according to the convention of 'type' |
|
// |
|
// type: one of xml|html|xhtml|sql|regexp|regex|javascript|jscript|js|ascii |
|
// str: the string to be escaped |
|
|
|
var args = dojo.lang.toArray(arguments, 1); |
|
switch(type.toLowerCase()){ |
|
case "xml": |
|
case "html": |
|
case "xhtml": |
|
return dojo.string.escapeXml.apply(this, args); // string |
|
case "sql": |
|
return dojo.string.escapeSql.apply(this, args); // string |
|
case "regexp": |
|
case "regex": |
|
return dojo.string.escapeRegExp.apply(this, args); // string |
|
case "javascript": |
|
case "jscript": |
|
case "js": |
|
return dojo.string.escapeJavaScript.apply(this, args); // string |
|
case "ascii": |
|
// so it's encode, but it seems useful |
|
return dojo.string.encodeAscii.apply(this, args); // string |
|
default: |
|
return str; // string |
|
} |
|
} |
|
|
|
dojo.string.escapeXml = function(/*string*/str, /*boolean*/noSingleQuotes){ |
|
//summary: |
|
// Adds escape sequences for special characters in XML: &<>"' |
|
// Optionally skips escapes for single quotes |
|
|
|
str = str.replace(/&/gm, "&").replace(/</gm, "<") |
|
.replace(/>/gm, ">").replace(/"/gm, """); |
|
if(!noSingleQuotes){ str = str.replace(/'/gm, "'"); } |
|
return str; // string |
|
} |
|
|
|
dojo.string.escapeSql = function(/*string*/str){ |
|
//summary: |
|
// Adds escape sequences for single quotes in SQL expressions |
|
|
|
return str.replace(/'/gm, "''"); //string |
|
} |
|
|
|
dojo.string.escapeRegExp = function(/*string*/str){ |
|
//summary: |
|
// Adds escape sequences for special characters in regular expressions |
|
|
|
return str.replace(/\\/gm, "\\\\").replace(/([\f\b\n\t\r[\^$|?*+(){}])/gm, "\\$1"); // string |
|
} |
|
|
|
//FIXME: should this one also escape backslash? |
|
dojo.string.escapeJavaScript = function(/*string*/str){ |
|
//summary: |
|
// Adds escape sequences for single and double quotes as well |
|
// as non-visible characters in JavaScript string literal expressions |
|
|
|
return str.replace(/(["'\f\b\n\t\r])/gm, "\\$1"); // string |
|
} |
|
|
|
//FIXME: looks a lot like escapeJavaScript, just adds quotes? deprecate one? |
|
dojo.string.escapeString = function(/*string*/str){ |
|
//summary: |
|
// Adds escape sequences for non-visual characters, double quote and backslash |
|
// and surrounds with double quotes to form a valid string literal. |
|
return ('"' + str.replace(/(["\\])/g, '\\$1') + '"' |
|
).replace(/[\f]/g, "\\f" |
|
).replace(/[\b]/g, "\\b" |
|
).replace(/[\n]/g, "\\n" |
|
).replace(/[\t]/g, "\\t" |
|
).replace(/[\r]/g, "\\r"); // string |
|
} |
|
|
|
// TODO: make an HTML version |
|
dojo.string.summary = function(/*string*/str, /*number*/len){ |
|
// summary: |
|
// Truncates 'str' after 'len' characters and appends periods as necessary so that it ends with "..." |
|
|
|
if(!len || str.length <= len){ |
|
return str; // string |
|
} |
|
|
|
return str.substring(0, len).replace(/\.+$/, "") + "..."; // string |
|
} |
|
|
|
dojo.string.endsWith = function(/*string*/str, /*string*/end, /*boolean*/ignoreCase){ |
|
// summary: |
|
// Returns true if 'str' ends with 'end' |
|
|
|
if(ignoreCase){ |
|
str = str.toLowerCase(); |
|
end = end.toLowerCase(); |
|
} |
|
if((str.length - end.length) < 0){ |
|
return false; // boolean |
|
} |
|
return str.lastIndexOf(end) == str.length - end.length; // boolean |
|
} |
|
|
|
dojo.string.endsWithAny = function(/*string*/str /* , ... */){ |
|
// summary: |
|
// Returns true if 'str' ends with any of the arguments[2 -> n] |
|
|
|
for(var i = 1; i < arguments.length; i++) { |
|
if(dojo.string.endsWith(str, arguments[i])) { |
|
return true; // boolean |
|
} |
|
} |
|
return false; // boolean |
|
} |
|
|
|
dojo.string.startsWith = function(/*string*/str, /*string*/start, /*boolean*/ignoreCase){ |
|
// summary: |
|
// Returns true if 'str' starts with 'start' |
|
|
|
if(ignoreCase) { |
|
str = str.toLowerCase(); |
|
start = start.toLowerCase(); |
|
} |
|
return str.indexOf(start) == 0; // boolean |
|
} |
|
|
|
dojo.string.startsWithAny = function(/*string*/str /* , ... */){ |
|
// summary: |
|
// Returns true if 'str' starts with any of the arguments[2 -> n] |
|
|
|
for(var i = 1; i < arguments.length; i++) { |
|
if(dojo.string.startsWith(str, arguments[i])) { |
|
return true; // boolean |
|
} |
|
} |
|
return false; // boolean |
|
} |
|
|
|
dojo.string.has = function(/*string*/str /* , ... */) { |
|
// summary: |
|
// Returns true if 'str' contains any of the arguments 2 -> n |
|
|
|
for(var i = 1; i < arguments.length; i++) { |
|
if(str.indexOf(arguments[i]) > -1){ |
|
return true; // boolean |
|
} |
|
} |
|
return false; // boolean |
|
} |
|
|
|
dojo.string.normalizeNewlines = function(/*string*/text, /*string? (\n or \r)*/newlineChar){ |
|
// summary: |
|
// Changes occurences of CR and LF in text to CRLF, or if newlineChar is provided as '\n' or '\r', |
|
// substitutes newlineChar for occurrences of CR/LF and CRLF |
|
|
|
if (newlineChar == "\n"){ |
|
text = text.replace(/\r\n/g, "\n"); |
|
text = text.replace(/\r/g, "\n"); |
|
} else if (newlineChar == "\r"){ |
|
text = text.replace(/\r\n/g, "\r"); |
|
text = text.replace(/\n/g, "\r"); |
|
}else{ |
|
text = text.replace(/([^\r])\n/g, "$1\r\n").replace(/\r([^\n])/g, "\r\n$1"); |
|
} |
|
return text; // string |
|
} |
|
|
|
dojo.string.splitEscaped = function(/*string*/str, /*string of length=1*/charac){ |
|
// summary: |
|
// Splits 'str' into an array separated by 'charac', but skips characters escaped with a backslash |
|
|
|
var components = []; |
|
for (var i = 0, prevcomma = 0; i < str.length; i++){ |
|
if (str.charAt(i) == '\\'){ i++; continue; } |
|
if (str.charAt(i) == charac){ |
|
components.push(str.substring(prevcomma, i)); |
|
prevcomma = i + 1; |
|
} |
|
} |
|
components.push(str.substr(prevcomma)); |
|
return components; // array |
|
} |
|
|
|
dojo.provide("dojo.dom"); |
|
|
|
dojo.dom.ELEMENT_NODE = 1; |
|
dojo.dom.ATTRIBUTE_NODE = 2; |
|
dojo.dom.TEXT_NODE = 3; |
|
dojo.dom.CDATA_SECTION_NODE = 4; |
|
dojo.dom.ENTITY_REFERENCE_NODE = 5; |
|
dojo.dom.ENTITY_NODE = 6; |
|
dojo.dom.PROCESSING_INSTRUCTION_NODE = 7; |
|
dojo.dom.COMMENT_NODE = 8; |
|
dojo.dom.DOCUMENT_NODE = 9; |
|
dojo.dom.DOCUMENT_TYPE_NODE = 10; |
|
dojo.dom.DOCUMENT_FRAGMENT_NODE = 11; |
|
dojo.dom.NOTATION_NODE = 12; |
|
|
|
dojo.dom.dojoml = "http://www.dojotoolkit.org/2004/dojoml"; |
|
|
|
/** |
|
* comprehensive list of XML namespaces |
|
**/ |
|
dojo.dom.xmlns = { |
|
// summary |
|
// aliases for various common XML namespaces |
|
svg : "http://www.w3.org/2000/svg", |
|
smil : "http://www.w3.org/2001/SMIL20/", |
|
mml : "http://www.w3.org/1998/Math/MathML", |
|
cml : "http://www.xml-cml.org", |
|
xlink : "http://www.w3.org/1999/xlink", |
|
xhtml : "http://www.w3.org/1999/xhtml", |
|
xul : "http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul", |
|
xbl : "http://www.mozilla.org/xbl", |
|
fo : "http://www.w3.org/1999/XSL/Format", |
|
xsl : "http://www.w3.org/1999/XSL/Transform", |
|
xslt : "http://www.w3.org/1999/XSL/Transform", |
|
xi : "http://www.w3.org/2001/XInclude", |
|
xforms : "http://www.w3.org/2002/01/xforms", |
|
saxon : "http://icl.com/saxon", |
|
xalan : "http://xml.apache.org/xslt", |
|
xsd : "http://www.w3.org/2001/XMLSchema", |
|
dt: "http://www.w3.org/2001/XMLSchema-datatypes", |
|
xsi : "http://www.w3.org/2001/XMLSchema-instance", |
|
rdf : "http://www.w3.org/1999/02/22-rdf-syntax-ns#", |
|
rdfs : "http://www.w3.org/2000/01/rdf-schema#", |
|
dc : "http://purl.org/dc/elements/1.1/", |
|
dcq: "http://purl.org/dc/qualifiers/1.0", |
|
"soap-env" : "http://schemas.xmlsoap.org/soap/envelope/", |
|
wsdl : "http://schemas.xmlsoap.org/wsdl/", |
|
AdobeExtensions : "http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" |
|
}; |
|
|
|
dojo.dom.isNode = function(/* object */wh){ |
|
// summary: |
|
// checks to see if wh is actually a node. |
|
if(typeof Element == "function") { |
|
try { |
|
return wh instanceof Element; // boolean |
|
} catch(e) {} |
|
} else { |
|
// best-guess |
|
return wh && !isNaN(wh.nodeType); // boolean |
|
} |
|
} |
|
|
|
dojo.dom.getUniqueId = function(){ |
|
// summary: |
|
// returns a unique string for use with any DOM element |
|
var _document = dojo.doc(); |
|
do { |
|
var id = "dj_unique_" + (++arguments.callee._idIncrement); |
|
}while(_document.getElementById(id)); |
|
return id; // string |
|
} |
|
dojo.dom.getUniqueId._idIncrement = 0; |
|
|
|
dojo.dom.firstElement = dojo.dom.getFirstChildElement = function(/* Element */parentNode, /* string? */tagName){ |
|
// summary: |
|
// returns the first child element matching tagName |
|
var node = parentNode.firstChild; |
|
while(node && node.nodeType != dojo.dom.ELEMENT_NODE){ |
|
node = node.nextSibling; |
|
} |
|
if(tagName && node && node.tagName && node.tagName.toLowerCase() != tagName.toLowerCase()) { |
|
node = dojo.dom.nextElement(node, tagName); |
|
} |
|
return node; // Element |
|
} |
|
|
|
dojo.dom.lastElement = dojo.dom.getLastChildElement = function(/* Element */parentNode, /* string? */tagName){ |
|
// summary: |
|
// returns the last child element matching tagName |
|
var node = parentNode.lastChild; |
|
while(node && node.nodeType != dojo.dom.ELEMENT_NODE) { |
|
node = node.previousSibling; |
|
} |
|
if(tagName && node && node.tagName && node.tagName.toLowerCase() != tagName.toLowerCase()) { |
|
node = dojo.dom.prevElement(node, tagName); |
|
} |
|
return node; // Element |
|
} |
|
|
|
dojo.dom.nextElement = dojo.dom.getNextSiblingElement = function(/* Node */node, /* string? */tagName){ |
|
// summary: |
|
// returns the next sibling element matching tagName |
|
if(!node) { return null; } |
|
do { |
|
node = node.nextSibling; |
|
} while(node && node.nodeType != dojo.dom.ELEMENT_NODE); |
|
|
|
if(node && tagName && tagName.toLowerCase() != node.tagName.toLowerCase()) { |
|
return dojo.dom.nextElement(node, tagName); |
|
} |
|
return node; // Element |
|
} |
|
|
|
dojo.dom.prevElement = dojo.dom.getPreviousSiblingElement = function(/* Node */node, /* string? */tagName){ |
|
// summary: |
|
// returns the previous sibling element matching tagName |
|
if(!node) { return null; } |
|
if(tagName) { tagName = tagName.toLowerCase(); } |
|
do { |
|
node = node.previousSibling; |
|
} while(node && node.nodeType != dojo.dom.ELEMENT_NODE); |
|
|
|
if(node && tagName && tagName.toLowerCase() != node.tagName.toLowerCase()) { |
|
return dojo.dom.prevElement(node, tagName); |
|
} |
|
return node; // Element |
|
} |
|
|
|
// TODO: hmph |
|
/*this.forEachChildTag = function(node, unaryFunc) { |
|
var child = this.getFirstChildTag(node); |
|
while(child) { |
|
if(unaryFunc(child) == "break") { break; } |
|
child = this.getNextSiblingTag(child); |
|
} |
|
}*/ |
|
|
|
dojo.dom.moveChildren = function(/*Element*/srcNode, /*Element*/destNode, /*boolean?*/trim){ |
|
// summary: |
|
// Moves children from srcNode to destNode and returns the count of |
|
// children moved; will trim off text nodes if trim == true |
|
var count = 0; |
|
if(trim) { |
|
while(srcNode.hasChildNodes() && |
|
srcNode.firstChild.nodeType == dojo.dom.TEXT_NODE) { |
|
srcNode.removeChild(srcNode.firstChild); |
|
} |
|
while(srcNode.hasChildNodes() && |
|
srcNode.lastChild.nodeType == dojo.dom.TEXT_NODE) { |
|
srcNode.removeChild(srcNode.lastChild); |
|
} |
|
} |
|
while(srcNode.hasChildNodes()){ |
|
destNode.appendChild(srcNode.firstChild); |
|
count++; |
|
} |
|
return count; // number |
|
} |
|
|
|
dojo.dom.copyChildren = function(/*Element*/srcNode, /*Element*/destNode, /*boolean?*/trim){ |
|
// summary: |
|
// Copies children from srcNde to destNode and returns the count of |
|
// children copied; will trim off text nodes if trim == true |
|
var clonedNode = srcNode.cloneNode(true); |
|
return this.moveChildren(clonedNode, destNode, trim); // number |
|
} |
|
|
|
dojo.dom.replaceChildren = function(/*Element*/node, /*Node*/newChild){ |
|
// summary: |
|
// Removes all children of node and appends newChild. All the existing |
|
// children will be destroyed. |
|
// FIXME: what if newChild is an array-like object? |
|
var nodes = []; |
|
if(dojo.render.html.ie){ |
|
for(var i=0;i<node.childNodes.length;i++){ |
|
nodes.push(node.childNodes[i]); |
|
} |
|
} |
|
dojo.dom.removeChildren(node); |
|
node.appendChild(newChild); |
|
for(var i=0;i<nodes.length;i++){ |
|
dojo.dom.destroyNode(nodes[i]); |
|
} |
|
} |
|
|
|
dojo.dom.removeChildren = function(/*Element*/node){ |
|
// summary: |
|
// removes all children from node and returns the count of children removed. |
|
// The children nodes are not destroyed. Be sure to call destroyNode on them |
|
// after they are not used anymore. |
|
var count = node.childNodes.length; |
|
while(node.hasChildNodes()){ dojo.dom.removeNode(node.firstChild); } |
|
return count; // int |
|
} |
|
|
|
dojo.dom.replaceNode = function(/*Element*/node, /*Element*/newNode){ |
|
// summary: |
|
// replaces node with newNode and returns a reference to the removed node. |
|
// To prevent IE memory leak, call destroyNode on the returned node when |
|
// it is no longer needed. |
|
return node.parentNode.replaceChild(newNode, node); // Node |
|
} |
|
|
|
dojo.dom.destroyNode = function(/*Node*/node){ |
|
// summary: |
|
// destroy a node (it can not be used any more). For IE, this is the |
|
// right function to call to prevent memory leaks. While for other |
|
// browsers, this is identical to dojo.dom.removeNode |
|
if(node.parentNode){ |
|
node = dojo.dom.removeNode(node); |
|
} |
|
if(node.nodeType != 3){ // ingore TEXT_NODE |
|
if(dojo.evalObjPath("dojo.event.browser.clean", false)){ |
|
dojo.event.browser.clean(node); |
|
} |
|
if(dojo.render.html.ie){ |
|
node.outerHTML=''; //prevent ugly IE mem leak associated with Node.removeChild (ticket #1727) |
|
} |
|
} |
|
} |
|
|
|
dojo.dom.removeNode = function(/*Node*/node){ |
|
// summary: |
|
// if node has a parent, removes node from parent and returns a |
|
// reference to the removed child. |
|
// To prevent IE memory leak, call destroyNode on the returned node when |
|
// it is no longer needed. |
|
// node: |
|
// the node to remove from its parent. |
|
|
|
if(node && node.parentNode){ |
|
// return a ref to the removed child |
|
return node.parentNode.removeChild(node); //Node |
|
} |
|
} |
|
|
|
dojo.dom.getAncestors = function(/*Node*/node, /*function?*/filterFunction, /*boolean?*/returnFirstHit){ |
|
// summary: |
|
// returns all ancestors matching optional filterFunction; will return |
|
// only the first if returnFirstHit |
|
var ancestors = []; |
|
var isFunction = (filterFunction && (filterFunction instanceof Function || typeof filterFunction == "function")); |
|
while(node){ |
|
if(!isFunction || filterFunction(node)){ |
|
ancestors.push(node); |
|
} |
|
if(returnFirstHit && ancestors.length > 0){ |
|
return ancestors[0]; // Node |
|
} |
|
|
|
node = node.parentNode; |
|
} |
|
if(returnFirstHit){ return null; } |
|
return ancestors; // array |
|
} |
|
|
|
dojo.dom.getAncestorsByTag = function(/*Node*/node, /*String*/tag, /*boolean?*/returnFirstHit){ |
|
// summary: |
|
// returns all ancestors matching tag (as tagName), will only return |
|
// first one if returnFirstHit |
|
tag = tag.toLowerCase(); |
|
return dojo.dom.getAncestors(node, function(el){ |
|
return ((el.tagName)&&(el.tagName.toLowerCase() == tag)); |
|
}, returnFirstHit); // Node || array |
|
} |
|
|
|
dojo.dom.getFirstAncestorByTag = function(/*Node*/node, /*string*/tag){ |
|
// summary: |
|
// Returns first ancestor of node with tag tagName |
|
return dojo.dom.getAncestorsByTag(node, tag, true); // Node |
|
} |
|
|
|
dojo.dom.isDescendantOf = function(/* Node */node, /* Node */ancestor, /* boolean? */guaranteeDescendant){ |
|
// summary |
|
// Returns boolean if node is a descendant of ancestor |
|
// guaranteeDescendant allows us to be a "true" isDescendantOf function |
|
if(guaranteeDescendant && node) { node = node.parentNode; } |
|
while(node) { |
|
if(node == ancestor){ |
|
return true; // boolean |
|
} |
|
node = node.parentNode; |
|
} |
|
return false; // boolean |
|
} |
|
|
|
dojo.dom.innerXML = function(/*Node*/node){ |
|
// summary: |
|
// Implementation of MS's innerXML function. |
|
if(node.innerXML){ |
|
return node.innerXML; // string |
|
}else if (node.xml){ |
|
return node.xml; // string |
|
}else if(typeof XMLSerializer != "undefined"){ |
|
return (new XMLSerializer()).serializeToString(node); // string |
|
} |
|
} |
|
|
|
dojo.dom.createDocument = function(){ |
|
// summary: |
|
// cross-browser implementation of creating an XML document object. |
|
var doc = null; |
|
var _document = dojo.doc(); |
|
|
|
if(!dj_undef("ActiveXObject")){ |
|
var prefixes = [ "MSXML2", "Microsoft", "MSXML", "MSXML3" ]; |
|
for(var i = 0; i<prefixes.length; i++){ |
|
try{ |
|
doc = new ActiveXObject(prefixes[i]+".XMLDOM"); |
|
}catch(e){ /* squelch */ }; |
|
|
|
if(doc){ break; } |
|
} |
|
}else if((_document.implementation)&& |
|
(_document.implementation.createDocument)){ |
|
doc = _document.implementation.createDocument("", "", null); |
|
} |
|
|
|
return doc; // DOMDocument |
|
} |
|
|
|
dojo.dom.createDocumentFromText = function(/*string*/str, /*string?*/mimetype){ |
|
// summary: |
|
// attempts to create a Document object based on optional mime-type, |
|
// using str as the contents of the document |
|
if(!mimetype){ mimetype = "text/xml"; } |
|
if(!dj_undef("DOMParser")){ |
|
var parser = new DOMParser(); |
|
return parser.parseFromString(str, mimetype); // DOMDocument |
|
}else if(!dj_undef("ActiveXObject")){ |
|
var domDoc = dojo.dom.createDocument(); |
|
if(domDoc){ |
|
domDoc.async = false; |
|
domDoc.loadXML(str); |
|
return domDoc; // DOMDocument |
|
}else{ |
|
dojo.debug("toXml didn't work?"); |
|
} |
|
/* |
|
}else if((dojo.render.html.capable)&&(dojo.render.html.safari)){ |
|
// FIXME: this doesn't appear to work! |
|
// from: http://web-graphics.com/mtarchive/001606.php |
|
// var xml = '<?xml version="1.0"?>'+str; |
|
var mtype = "text/xml"; |
|
var xml = '<?xml version="1.0"?>'+str; |
|
var url = "data:"+mtype+";charset=utf-8,"+encodeURIComponent(xml); |
|
var req = new XMLHttpRequest(); |
|
req.open("GET", url, false); |
|
req.overrideMimeType(mtype); |
|
req.send(null); |
|
return req.responseXML; |
|
*/ |
|
}else{ |
|
var _document = dojo.doc(); |
|
if(_document.createElement){ |
|
// FIXME: this may change all tags to uppercase! |
|
var tmp = _document.createElement("xml"); |
|
tmp.innerHTML = str; |
|
if(_document.implementation && _document.implementation.createDocument){ |
|
var xmlDoc = _document.implementation.createDocument("foo", "", null); |
|
for(var i = 0; i < tmp.childNodes.length; i++) { |
|
xmlDoc.importNode(tmp.childNodes.item(i), true); |
|
} |
|
return xmlDoc; // DOMDocument |
|
} |
|
// FIXME: probably not a good idea to have to return an HTML fragment |
|
// FIXME: the tmp.doc.firstChild is as tested from IE, so it may not |
|
// work that way across the board |
|
return ((tmp.document)&& |
|
(tmp.document.firstChild ? tmp.document.firstChild : tmp)); // DOMDocument |
|
} |
|
} |
|
return null; |
|
} |
|
|
|
dojo.dom.prependChild = function(/*Element*/node, /*Element*/parent){ |
|
// summary: |
|
// prepends node to parent's children nodes |
|
if(parent.firstChild) { |
|
parent.insertBefore(node, parent.firstChild); |
|
} else { |
|
parent.appendChild(node); |
|
} |
|
return true; // boolean |
|
} |
|
|
|
dojo.dom.insertBefore = function(/*Node*/node, /*Node*/ref, /*boolean?*/force){ |
|
// summary: |
|
// Try to insert node before ref |
|
if( (force != true)&& |
|
(node === ref || node.nextSibling === ref)){ return false; } |
|
var parent = ref.parentNode; |
|
parent.insertBefore(node, ref); |
|
return true; // boolean |
|
} |
|
|
|
dojo.dom.insertAfter = function(/*Node*/node, /*Node*/ref, /*boolean?*/force){ |
|
// summary: |
|
// Try to insert node after ref |
|
var pn = ref.parentNode; |
|
if(ref == pn.lastChild){ |
|
if((force != true)&&(node === ref)){ |
|
return false; // boolean |
|
} |
|
pn.appendChild(node); |
|
}else{ |
|
return this.insertBefore(node, ref.nextSibling, force); // boolean |
|
} |
|
return true; // boolean |
|
} |
|
|
|
dojo.dom.insertAtPosition = function(/*Node*/node, /*Node*/ref, /*string*/position){ |
|
// summary: |
|
// attempt to insert node in relation to ref based on position |
|
if((!node)||(!ref)||(!position)){ |
|
return false; // boolean |
|
} |
|
switch(position.toLowerCase()){ |
|
case "before": |
|
return dojo.dom.insertBefore(node, ref); // boolean |
|
case "after": |
|
return dojo.dom.insertAfter(node, ref); // boolean |
|
case "first": |
|
if(ref.firstChild){ |
|
return dojo.dom.insertBefore(node, ref.firstChild); // boolean |
|
}else{ |
|
ref.appendChild(node); |
|
return true; // boolean |
|
} |
|
break; |
|
default: // aka: last |
|
ref.appendChild(node); |
|
return true; // boolean |
|
} |
|
} |
|
|
|
dojo.dom.insertAtIndex = function(/*Node*/node, /*Element*/containingNode, /*number*/insertionIndex){ |
|
// summary: |
|
// insert node into child nodes nodelist of containingNode at |
|
// insertionIndex. insertionIndex should be between 0 and |
|
// the number of the childNodes in containingNode. insertionIndex |
|
// specifys after how many childNodes in containingNode the node |
|
// shall be inserted. If 0 is given, node will be appended to |
|
// containingNode. |
|
var siblingNodes = containingNode.childNodes; |
|
|
|
// if there aren't any kids yet, just add it to the beginning |
|
|
|
if (!siblingNodes.length || siblingNodes.length == insertionIndex){ |
|
containingNode.appendChild(node); |
|
return true; // boolean |
|
} |
|
|
|
if(insertionIndex == 0){ |
|
return dojo.dom.prependChild(node, containingNode); // boolean |
|
} |
|
// otherwise we need to walk the childNodes |
|
// and find our spot |
|
|
|
return dojo.dom.insertAfter(node, siblingNodes[insertionIndex-1]); // boolean |
|
} |
|
|
|
dojo.dom.textContent = function(/*Node*/node, /*string*/text){ |
|
// summary: |
|
// implementation of the DOM Level 3 attribute; scan node for text |
|
if (arguments.length>1) { |
|
var _document = dojo.doc(); |
|
dojo.dom.replaceChildren(node, _document.createTextNode(text)); |
|
return text; // string |
|
} else { |
|
if(node.textContent != undefined){ //FF 1.5 |
|
return node.textContent; // string |
|
} |
|
var _result = ""; |
|
if (node == null) { return _result; } |
|
for (var i = 0; i < node.childNodes.length; i++) { |
|
switch (node.childNodes[i].nodeType) { |
|
case 1: // ELEMENT_NODE |
|
case 5: // ENTITY_REFERENCE_NODE |
|
_result += dojo.dom.textContent(node.childNodes[i]); |
|
break; |
|
case 3: // TEXT_NODE |
|
case 2: // ATTRIBUTE_NODE |
|
case 4: // CDATA_SECTION_NODE |
|
_result += node.childNodes[i].nodeValue; |
|
break; |
|
default: |
|
break; |
|
} |
|
} |
|
return _result; // string |
|
} |
|
} |
|
|
|
dojo.dom.hasParent = function(/*Node*/node){ |
|
// summary: |
|
// returns whether or not node is a child of another node. |
|
return Boolean(node && node.parentNode && dojo.dom.isNode(node.parentNode)); // boolean |
|
} |
|
|
|
/** |
|
* Examples: |
|
* |
|
* myFooNode = <foo /> |
|
* isTag(myFooNode, "foo"); // returns "foo" |
|
* isTag(myFooNode, "bar"); // returns "" |
|
* isTag(myFooNode, "FOO"); // returns "" |
|
* isTag(myFooNode, "hey", "foo", "bar"); // returns "foo" |
|
**/ |
|
dojo.dom.isTag = function(/* Node */node /* ... */){ |
|
// summary: |
|
// determines if node has any of the provided tag names and returns |
|
// the tag name that matches, empty string otherwise. |
|
if(node && node.tagName) { |
|
for(var i=1; i<arguments.length; i++){ |
|
if(node.tagName==String(arguments[i])){ |
|
return String(arguments[i]); // string |
|
} |
|
} |
|
} |
|
return ""; // string |
|
} |
|
|
|
dojo.dom.setAttributeNS = function( /*Element*/elem, /*string*/namespaceURI, |
|
/*string*/attrName, /*string*/attrValue){ |
|
// summary: |
|
// implementation of DOM2 setAttributeNS that works cross browser. |
|
if(elem == null || ((elem == undefined)&&(typeof elem == "undefined"))){ |
|
dojo.raise("No element given to dojo.dom.setAttributeNS"); |
|
} |
|
|
|
if(!((elem.setAttributeNS == undefined)&&(typeof elem.setAttributeNS == "undefined"))){ // w3c |
|
elem.setAttributeNS(namespaceURI, attrName, attrValue); |
|
}else{ // IE |
|
// get a root XML document |
|
var ownerDoc = elem.ownerDocument; |
|
var attribute = ownerDoc.createNode( |
|
2, // node type |
|
attrName, |
|
namespaceURI |
|
); |
|
|
|
// set value |
|
attribute.nodeValue = attrValue; |
|
|
|
// attach to element |
|
elem.setAttributeNode(attribute); |
|
} |
|
} |
|
|
|
dojo.provide("dojo.undo.browser"); |
|
|
|
|
|
try{ |
|
if((!djConfig["preventBackButtonFix"])&&(!dojo.hostenv.post_load_)){ |
|
document.write("<iframe style='border: 0px; width: 1px; height: 1px; position: absolute; bottom: 0px; right: 0px; visibility: visible;' name='djhistory' id='djhistory' src='" + (djConfig["dojoIframeHistoryUrl"] || dojo.hostenv.getBaseScriptUri()+'iframe_history.html') + "'></iframe>"); |
|
} |
|
}catch(e){/* squelch */} |
|
|
|
if(dojo.render.html.opera){ |
|
dojo.debug("Opera is not supported with dojo.undo.browser, so back/forward detection will not work."); |
|
} |
|
|
|
dojo.undo.browser = { |
|
initialHref: (!dj_undef("window")) ? window.location.href : "", |
|
initialHash: (!dj_undef("window")) ? window.location.hash : "", |
|
|
|
moveForward: false, |
|
historyStack: [], |
|
forwardStack: [], |
|
historyIframe: null, |
|
bookmarkAnchor: null, |
|
locationTimer: null, |
|
|
|
/** |
|
* |
|
*/ |
|
setInitialState: function(/*Object*/args){ |
|
//summary: Sets the state object and back callback for the very first page that is loaded. |
|
//description: It is recommended that you call this method as part of an event listener that is registered via |
|
//dojo.addOnLoad(). |
|
//args: Object |
|
// See the addToHistory() function for the list of valid args properties. |
|
this.initialState = this._createState(this.initialHref, args, this.initialHash); |
|
}, |
|
|
|
//FIXME: Would like to support arbitrary back/forward jumps. Have to rework iframeLoaded among other things. |
|
//FIXME: is there a slight race condition in moz using change URL with the timer check and when |
|
// the hash gets set? I think I have seen a back/forward call in quick succession, but not consistent. |
|
addToHistory: function(args){ |
|
//summary: adds a state object (args) to the history list. You must set |
|
//djConfig.preventBackButtonFix = false to use dojo.undo.browser. |
|
|
|
//args: Object |
|
// args can have the following properties: |
|
// To support getting back button notifications, the object argument should implement a |
|
// function called either "back", "backButton", or "handle". The string "back" will be |
|
// passed as the first and only argument to this callback. |
|
// - To support getting forward button notifications, the object argument should implement a |
|
// function called either "forward", "forwardButton", or "handle". The string "forward" will be |
|
// passed as the first and only argument to this callback. |
|
// - If you want the browser location string to change, define "changeUrl" on the object. If the |
|
// value of "changeUrl" is true, then a unique number will be appended to the URL as a fragment |
|
// identifier (http://some.domain.com/path#uniquenumber). If it is any other value that does |
|
// not evaluate to false, that value will be used as the fragment identifier. For example, |
|
// if changeUrl: 'page1', then the URL will look like: http://some.domain.com/path#page1 |
|
// Full example: |
|
// dojo.undo.browser.addToHistory({ |
|
// back: function() { alert('back pressed'); }, |
|
// forward: function() { alert('forward pressed'); }, |
|
// changeUrl: true |
|
// }); |
|
// |
|
// BROWSER NOTES: |
|
// Safari 1.2: |
|
// back button "works" fine, however it's not possible to actually |
|
// DETECT that you've moved backwards by inspecting window.location. |
|
// Unless there is some other means of locating. |
|
// FIXME: perhaps we can poll on history.length? |
|
// Safari 2.0.3+ (and probably 1.3.2+): |
|
// works fine, except when changeUrl is used. When changeUrl is used, |
|
// Safari jumps all the way back to whatever page was shown before |
|
// the page that uses dojo.undo.browser support. |
|
// IE 5.5 SP2: |
|
// back button behavior is macro. It does not move back to the |
|
// previous hash value, but to the last full page load. This suggests |
|
// that the iframe is the correct way to capture the back button in |
|
// these cases. |
|
// Don't test this page using local disk for MSIE. MSIE will not create |
|
// a history list for iframe_history.html if served from a file: URL. |
|
// The XML served back from the XHR tests will also not be properly |
|
// created if served from local disk. Serve the test pages from a web |
|
// server to test in that browser. |
|
// IE 6.0: |
|
// same behavior as IE 5.5 SP2 |
|
// Firefox 1.0+: |
|
// the back button will return us to the previous hash on the same |
|
// page, thereby not requiring an iframe hack, although we do then |
|
// need to run a timer to detect inter-page movement. |
|
|
|
//If addToHistory is called, then that means we prune the |
|
//forward stack -- the user went back, then wanted to |
|
//start a new forward path. |
|
this.forwardStack = []; |
|
|
|
var hash = null; |
|
var url = null; |
|
if(!this.historyIframe){ |
|
if(djConfig["useXDomain"] && !djConfig["dojoIframeHistoryUrl"]){ |
|
dojo.debug("dojo.undo.browser: When using cross-domain Dojo builds," |
|
+ " please save iframe_history.html to your domain and set djConfig.dojoIframeHistoryUrl" |
|
+ " to the path on your domain to iframe_history.html"); |
|
} |
|
this.historyIframe = window.frames["djhistory"]; |
|
} |
|
if(!this.bookmarkAnchor){ |
|
this.bookmarkAnchor = document.createElement("a"); |
|
dojo.body().appendChild(this.bookmarkAnchor); |
|
this.bookmarkAnchor.style.display = "none"; |
|
} |
|
if(args["changeUrl"]){ |
|
hash = "#"+ ((args["changeUrl"]!==true) ? args["changeUrl"] : (new Date()).getTime()); |
|
|
|
//If the current hash matches the new one, just replace the history object with |
|
//this new one. It doesn't make sense to track different state objects for the same |
|
//logical URL. This matches the browser behavior of only putting in one history |
|
//item no matter how many times you click on the same #hash link, at least in Firefox |
|
//and Safari, and there is no reliable way in those browsers to know if a #hash link |
|
//has been clicked on multiple times. So making this the standard behavior in all browsers |
|
//so that dojo.undo.browser's behavior is the same in all browsers. |
|
if(this.historyStack.length == 0 && this.initialState.urlHash == hash){ |
|
this.initialState = this._createState(url, args, hash); |
|
return; |
|
}else if(this.historyStack.length > 0 && this.historyStack[this.historyStack.length - 1].urlHash == hash){ |
|
this.historyStack[this.historyStack.length - 1] = this._createState(url, args, hash); |
|
return; |
|
} |
|
|
|
this.changingUrl = true; |
|
setTimeout("window.location.href = '"+hash+"'; dojo.undo.browser.changingUrl = false;", 1); |
|
this.bookmarkAnchor.href = hash; |
|
|
|
if(dojo.render.html.ie){ |
|
url = this._loadIframeHistory(); |
|
|
|
var oldCB = args["back"]||args["backButton"]||args["handle"]; |
|
|
|
//The function takes handleName as a parameter, in case the |
|
//callback we are overriding was "handle". In that case, |
|
//we will need to pass the handle name to handle. |
|
var tcb = function(handleName){ |
|
if(window.location.hash != ""){ |
|
setTimeout("window.location.href = '"+hash+"';", 1); |
|
} |
|
//Use apply to set "this" to args, and to try to avoid memory leaks. |
|
oldCB.apply(this, [handleName]); |
|
} |
|
|
|
//Set interceptor function in the right place. |
|
if(args["back"]){ |
|
args.back = tcb; |
|
}else if(args["backButton"]){ |
|
args.backButton = tcb; |
|
}else if(args["handle"]){ |
|
args.handle = tcb; |
|
} |
|
|
|
var oldFW = args["forward"]||args["forwardButton"]||args["handle"]; |
|
|
|
//The function takes handleName as a parameter, in case the |
|
//callback we are overriding was "handle". In that case, |
|
//we will need to pass the handle name to handle. |
|
var tfw = function(handleName){ |
|
if(window.location.hash != ""){ |
|
window.location.href = hash; |
|
} |
|
if(oldFW){ // we might not actually have one |
|
//Use apply to set "this" to args, and to try to avoid memory leaks. |
|
oldFW.apply(this, [handleName]); |
|
} |
|
} |
|
|
|
//Set interceptor function in the right place. |
|
if(args["forward"]){ |
|
args.forward = tfw; |
|
}else if(args["forwardButton"]){ |
|
args.forwardButton = tfw; |
|
}else if(args["handle"]){ |
|
args.handle = tfw; |
|
} |
|
|
|
}else if(dojo.render.html.moz){ |
|
// start the timer |
|
if(!this.locationTimer){ |
|
this.locationTimer = setInterval("dojo.undo.browser.checkLocation();", 200); |
|
} |
|
} |
|
}else{ |
|
url = this._loadIframeHistory(); |
|
} |
|
|
|
this.historyStack.push(this._createState(url, args, hash)); |
|
}, |
|
|
|
checkLocation: function(){ |
|
//summary: private method. Do not call this directly. |
|
if (!this.changingUrl){ |
|
var hsl = this.historyStack.length; |
|
|
|
if((window.location.hash == this.initialHash||window.location.href == this.initialHref)&&(hsl == 1)){ |
|
// FIXME: could this ever be a forward button? |
|
// we can't clear it because we still need to check for forwards. Ugg. |
|
// clearInterval(this.locationTimer); |
|
this.handleBackButton(); |
|
return; |
|
} |
|
|
|
// first check to see if we could have gone forward. We always halt on |
|
// a no-hash item. |
|
if(this.forwardStack.length > 0){ |
|
if(this.forwardStack[this.forwardStack.length-1].urlHash == window.location.hash){ |
|
this.handleForwardButton(); |
|
return; |
|
} |
|
} |
|
|
|
// ok, that didn't work, try someplace back in the history stack |
|
if((hsl >= 2)&&(this.historyStack[hsl-2])){ |
|
if(this.historyStack[hsl-2].urlHash==window.location.hash){ |
|
this.handleBackButton(); |
|
return; |
|
} |
|
} |
|
} |
|
}, |
|
|
|
iframeLoaded: function(evt, ifrLoc){ |
|
//summary: private method. Do not call this directly. |
|
if(!dojo.render.html.opera){ |
|
var query = this._getUrlQuery(ifrLoc.href); |
|
if(query == null){ |
|
// alert("iframeLoaded"); |
|
// we hit the end of the history, so we should go back |
|
if(this.historyStack.length == 1){ |
|
this.handleBackButton(); |
|
} |
|
return; |
|
} |
|
if(this.moveForward){ |
|
// we were expecting it, so it's not either a forward or backward movement |
|
this.moveForward = false; |
|
return; |
|
} |
|
|
|
//Check the back stack first, since it is more likely. |
|
//Note that only one step back or forward is supported. |
|
if(this.historyStack.length >= 2 && query == this._getUrlQuery(this.historyStack[this.historyStack.length-2].url)){ |
|
this.handleBackButton(); |
|
} |
|
else if(this.forwardStack.length > 0 && query == this._getUrlQuery(this.forwardStack[this.forwardStack.length-1].url)){ |
|
this.handleForwardButton(); |
|
} |
|
} |
|
}, |
|
|
|
handleBackButton: function(){ |
|
//summary: private method. Do not call this directly. |
|
|
|
//The "current" page is always at the top of the history stack. |
|
var current = this.historyStack.pop(); |
|
if(!current){ return; } |
|
var last = this.historyStack[this.historyStack.length-1]; |
|
if(!last && this.historyStack.length == 0){ |
|
last = this.initialState; |
|
} |
|
if (last){ |
|
if(last.kwArgs["back"]){ |
|
last.kwArgs["back"](); |
|
}else if(last.kwArgs["backButton"]){ |
|
last.kwArgs["backButton"](); |
|
}else if(last.kwArgs["handle"]){ |
|
last.kwArgs.handle("back"); |
|
} |
|
} |
|
this.forwardStack.push(current); |
|
}, |
|
|
|
handleForwardButton: function(){ |
|
//summary: private method. Do not call this directly. |
|
|
|
var last = this.forwardStack.pop(); |
|
if(!last){ return; } |
|
if(last.kwArgs["forward"]){ |
|
last.kwArgs.forward(); |
|
}else if(last.kwArgs["forwardButton"]){ |
|
last.kwArgs.forwardButton(); |
|
}else if(last.kwArgs["handle"]){ |
|
last.kwArgs.handle("forward"); |
|
} |
|
this.historyStack.push(last); |
|
}, |
|
|
|
_createState: function(url, args, hash){ |
|
//summary: private method. Do not call this directly. |
|
|
|
return {"url": url, "kwArgs": args, "urlHash": hash}; //Object |
|
}, |
|
|
|
_getUrlQuery: function(url){ |
|
//summary: private method. Do not call this directly. |
|
var segments = url.split("?"); |
|
if (segments.length < 2){ |
|
return null; //null |
|
} |
|
else{ |
|
return segments[1]; //String |
|
} |
|
}, |
|
|
|
_loadIframeHistory: function(){ |
|
//summary: private method. Do not call this directly. |
|
var url = (djConfig["dojoIframeHistoryUrl"] || dojo.hostenv.getBaseScriptUri()+'iframe_history.html') |
|
+ "?" + (new Date()).getTime(); |
|
this.moveForward = true; |
|
dojo.io.setIFrameSrc(this.historyIframe, url, false); |
|
return url; //String |
|
} |
|
} |
|
|
|
dojo.provide("dojo.io.BrowserIO"); |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
if(!dj_undef("window")) { |
|
|
|
dojo.io.checkChildrenForFile = function(/*DOMNode*/node){ |
|
//summary: Checks any child nodes of node for an input type="file" element. |
|
var hasFile = false; |
|
var inputs = node.getElementsByTagName("input"); |
|
dojo.lang.forEach(inputs, function(input){ |
|
if(hasFile){ return; } |
|
if(input.getAttribute("type")=="file"){ |
|
hasFile = true; |
|
} |
|
}); |
|
return hasFile; //boolean |
|
} |
|
|
|
dojo.io.formHasFile = function(/*DOMNode*/formNode){ |
|
//summary: Just calls dojo.io.checkChildrenForFile(). |
|
return dojo.io.checkChildrenForFile(formNode); //boolean |
|
} |
|
|
|
dojo.io.updateNode = function(/*DOMNode*/node, /*String or Object*/urlOrArgs){ |
|
//summary: Updates a DOMnode with the result of a dojo.io.bind() call. |
|
//node: DOMNode |
|
//urlOrArgs: String or Object |
|
// Either a String that has an URL, or an object containing dojo.io.bind() |
|
// arguments. |
|
node = dojo.byId(node); |
|
var args = urlOrArgs; |
|
if(dojo.lang.isString(urlOrArgs)){ |
|
args = { url: urlOrArgs }; |
|
} |
|
args.mimetype = "text/html"; |
|
args.load = function(t, d, e){ |
|
while(node.firstChild){ |
|
dojo.dom.destroyNode(node.firstChild); |
|
} |
|
node.innerHTML = d; |
|
}; |
|
dojo.io.bind(args); |
|
} |
|
|
|
dojo.io.formFilter = function(/*DOMNode*/node) { |
|
//summary: Returns true if the node is an input element that is enabled, has |
|
//a name, and whose type is one of the following values: ["file", "submit", "image", "reset", "button"] |
|
var type = (node.type||"").toLowerCase(); |
|
return !node.disabled && node.name |
|
&& !dojo.lang.inArray(["file", "submit", "image", "reset", "button"], type); //boolean |
|
} |
|
|
|
// TODO: Move to htmlUtils |
|
dojo.io.encodeForm = function(/*DOMNode*/formNode, /*String?*/encoding, /*Function?*/formFilter){ |
|
//summary: Converts the names and values of form elements into an URL-encoded |
|
//string (name=value&name=value...). |
|
//formNode: DOMNode |
|
//encoding: String? |
|
// The encoding to use for the values. Specify a string that starts with |
|
// "utf" (for instance, "utf8"), to use encodeURIComponent() as the encoding |
|
// function. Otherwise, dojo.string.encodeAscii will be used. |
|
//formFilter: Function? |
|
// A function used to filter out form elements. The element node will be passed |
|
// to the formFilter function, and a boolean result is expected (true indicating |
|
// indicating that the element should have its name/value included in the output). |
|
// If no formFilter is specified, then dojo.io.formFilter() will be used. |
|
if((!formNode)||(!formNode.tagName)||(!formNode.tagName.toLowerCase() == "form")){ |
|
dojo.raise("Attempted to encode a non-form element."); |
|
} |
|
if(!formFilter) { formFilter = dojo.io.formFilter; } |
|
var enc = /utf/i.test(encoding||"") ? encodeURIComponent : dojo.string.encodeAscii; |
|
var values = []; |
|
|
|
for(var i = 0; i < formNode.elements.length; i++){ |
|
var elm = formNode.elements[i]; |
|
if(!elm || elm.tagName.toLowerCase() == "fieldset" || !formFilter(elm)) { continue; } |
|
var name = enc(elm.name); |
|
var type = elm.type.toLowerCase(); |
|
|
|
if(type == "select-multiple"){ |
|
for(var j = 0; j < elm.options.length; j++){ |
|
if(elm.options[j].selected) { |
|
values.push(name + "=" + enc(elm.options[j].value)); |
|
} |
|
} |
|
}else if(dojo.lang.inArray(["radio", "checkbox"], type)){ |
|
if(elm.checked){ |
|
values.push(name + "=" + enc(elm.value)); |
|
} |
|
}else{ |
|
values.push(name + "=" + enc(elm.value)); |
|
} |
|
} |
|
|
|
// now collect input type="image", which doesn't show up in the elements array |
|
var inputs = formNode.getElementsByTagName("input"); |
|
for(var i = 0; i < inputs.length; i++) { |
|
var input = inputs[i]; |
|
if(input.type.toLowerCase() == "image" && input.form == formNode |
|
&& formFilter(input)) { |
|
var name = enc(input.name); |
|
values.push(name + "=" + enc(input.value)); |
|
values.push(name + ".x=0"); |
|
values.push(name + ".y=0"); |
|
} |
|
} |
|
return values.join("&") + "&"; //String |
|
} |
|
|
|
dojo.io.FormBind = function(/*DOMNode or Object*/args) { |
|
//summary: constructor for a dojo.io.FormBind object. See the Dojo Book for |
|
//some information on usage: http://manual.dojotoolkit.org/WikiHome/DojoDotBook/Book23 |
|
//args: DOMNode or Object |
|
// args can either be the DOMNode for a form element, or an object containing |
|
// dojo.io.bind() arguments, one of which should be formNode with the value of |
|
// a form element DOMNode. |
|
this.bindArgs = {}; |
|
|
|
if(args && args.formNode) { |
|
this.init(args); |
|
} else if(args) { |
|
this.init({formNode: args}); |
|
} |
|
} |
|
dojo.lang.extend(dojo.io.FormBind, { |
|
form: null, |
|
|
|
bindArgs: null, |
|
|
|
clickedButton: null, |
|
|
|
init: function(/*DOMNode or Object*/args) { |
|
//summary: Internal function called by the dojo.io.FormBind() constructor |
|
//do not call this method directly. |
|
var form = dojo.byId(args.formNode); |
|
|
|
if(!form || !form.tagName || form.tagName.toLowerCase() != "form") { |
|
throw new Error("FormBind: Couldn't apply, invalid form"); |
|
} else if(this.form == form) { |
|
return; |
|
} else if(this.form) { |
|
throw new Error("FormBind: Already applied to a form"); |
|
} |
|
|
|
dojo.lang.mixin(this.bindArgs, args); |
|
this.form = form; |
|
|
|
this.connect(form, "onsubmit", "submit"); |
|
|
|
for(var i = 0; i < form.elements.length; i++) { |
|
var node = form.elements[i]; |
|
if(node && node.type && dojo.lang.inArray(["submit", "button"], node.type.toLowerCase())) { |
|
this.connect(node, "onclick", "click"); |
|
} |
|
} |
|
|
|
var inputs = form.getElementsByTagName("input"); |
|
for(var i = 0; i < inputs.length; i++) { |
|
var input = inputs[i]; |
|
if(input.type.toLowerCase() == "image" && input.form == form) { |
|
this.connect(input, "onclick", "click"); |
|
} |
|
} |
|
}, |
|
|
|
onSubmit: function(/*DOMNode*/form) { |
|
//summary: Function used to verify that the form is OK to submit. |
|
//Override this function if you want specific form validation done. |
|
return true; //boolean |
|
}, |
|
|
|
submit: function(/*Event*/e) { |
|
//summary: internal function that is connected as a listener to the |
|
//form's onsubmit event. |
|
e.preventDefault(); |
|
if(this.onSubmit(this.form)) { |
|
dojo.io.bind(dojo.lang.mixin(this.bindArgs, { |
|
formFilter: dojo.lang.hitch(this, "formFilter") |
|
})); |
|
} |
|
}, |
|
|
|
click: function(/*Event*/e) { |
|
//summary: internal method that is connected as a listener to the |
|
//form's elements whose click event can submit a form. |
|
var node = e.currentTarget; |
|
if(node.disabled) { return; } |
|
this.clickedButton = node; |
|
}, |
|
|
|
formFilter: function(/*DOMNode*/node) { |
|
//summary: internal function used to know which form element values to include |
|
// in the dojo.io.bind() request. |
|
var type = (node.type||"").toLowerCase(); |
|
var accept = false; |
|
if(node.disabled || !node.name) { |
|
accept = false; |
|
} else if(dojo.lang.inArray(["submit", "button", "image"], type)) { |
|
if(!this.clickedButton) { this.clickedButton = node; } |
|
accept = node == this.clickedButton; |
|
} else { |
|
accept = !dojo.lang.inArray(["file", "submit", "reset", "button"], type); |
|
} |
|
return accept; //boolean |
|
}, |
|
|
|
// in case you don't have dojo.event.* pulled in |
|
connect: function(/*Object*/srcObj, /*Function*/srcFcn, /*Function*/targetFcn) { |
|
//summary: internal function used to connect event listeners to form elements |
|
//that trigger events. Used in case dojo.event is not loaded. |
|
if(dojo.evalObjPath("dojo.event.connect")) { |
|
dojo.event.connect(srcObj, srcFcn, this, targetFcn); |
|
} else { |
|
var fcn = dojo.lang.hitch(this, targetFcn); |
|
srcObj[srcFcn] = function(e) { |
|
if(!e) { e = window.event; } |
|
if(!e.currentTarget) { e.currentTarget = e.srcElement; } |
|
if(!e.preventDefault) { e.preventDefault = function() { window.event.returnValue = false; } } |
|
fcn(e); |
|
} |
|
} |
|
} |
|
}); |
|
|
|
dojo.io.XMLHTTPTransport = new function(){ |
|
//summary: The object that implements the dojo.io.bind transport for XMLHttpRequest. |
|
var _this = this; |
|
|
|
var _cache = {}; // FIXME: make this public? do we even need to? |
|
this.useCache = false; // if this is true, we'll cache unless kwArgs.useCache = false |
|
this.preventCache = false; // if this is true, we'll always force GET requests to cache |
|
|
|
// FIXME: Should this even be a function? or do we just hard code it in the next 2 functions? |
|
function getCacheKey(url, query, method) { |
|
return url + "|" + query + "|" + method.toLowerCase(); |
|
} |
|
|
|
function addToCache(url, query, method, http) { |
|
_cache[getCacheKey(url, query, method)] = http; |
|
} |
|
|
|
function getFromCache(url, query, method) { |
|
return _cache[getCacheKey(url, query, method)]; |
|
} |
|
|
|
this.clearCache = function() { |
|
_cache = {}; |
|
} |
|
|
|
// moved successful load stuff here |
|
function doLoad(kwArgs, http, url, query, useCache) { |
|
if( ((http.status>=200)&&(http.status<300))|| // allow any 2XX response code |
|
(http.status==304)|| // get it out of the cache |
|
(location.protocol=="file:" && (http.status==0 || http.status==undefined))|| |
|
(location.protocol=="chrome:" && (http.status==0 || http.status==undefined)) |
|
){ |
|
var ret; |
|
if(kwArgs.method.toLowerCase() == "head"){ |
|
var headers = http.getAllResponseHeaders(); |
|
ret = {}; |
|
ret.toString = function(){ return headers; } |
|
var values = headers.split(/[\r\n]+/g); |
|
for(var i = 0; i < values.length; i++) { |
|
var pair = values[i].match(/^([^:]+)\s*:\s*(.+)$/i); |
|
if(pair) { |
|
ret[pair[1]] = pair[2]; |
|
} |
|
} |
|
}else if(kwArgs.mimetype == "text/javascript"){ |
|
try{ |
|
ret = dj_eval(http.responseText); |
|
}catch(e){ |
|
dojo.debug(e); |
|
dojo.debug(http.responseText); |
|
ret = null; |
|
} |
|
}else if(kwArgs.mimetype == "text/json" || kwArgs.mimetype == "application/json"){ |
|
try{ |
|
ret = dj_eval("("+http.responseText+")"); |
|
}catch(e){ |
|
dojo.debug(e); |
|
dojo.debug(http.responseText); |
|
ret = false; |
|
} |
|
}else if((kwArgs.mimetype == "application/xml")|| |
|
(kwArgs.mimetype == "text/xml")){ |
|
ret = http.responseXML; |
|
if(!ret || typeof ret == "string" || !http.getResponseHeader("Content-Type")) { |
|
ret = dojo.dom.createDocumentFromText(http.responseText); |
|
} |
|
}else{ |
|
ret = http.responseText; |
|
} |
|
|
|
if(useCache){ // only cache successful responses |
|
addToCache(url, query, kwArgs.method, http); |
|
} |
|
kwArgs[(typeof kwArgs.load == "function") ? "load" : "handle"]("load", ret, http, kwArgs); |
|
}else{ |
|
var errObj = new dojo.io.Error("XMLHttpTransport Error: "+http.status+" "+http.statusText); |
|
kwArgs[(typeof kwArgs.error == "function") ? "error" : "handle"]("error", errObj, http, kwArgs); |
|
} |
|
} |
|
|
|
// set headers (note: Content-Type will get overriden if kwArgs.contentType is set) |
|
function setHeaders(http, kwArgs){ |
|
if(kwArgs["headers"]) { |
|
for(var header in kwArgs["headers"]) { |
|
if(header.toLowerCase() == "content-type" && !kwArgs["contentType"]) { |
|
kwArgs["contentType"] = kwArgs["headers"][header]; |
|
} else { |
|
http.setRequestHeader(header, kwArgs["headers"][header]); |
|
} |
|
} |
|
} |
|
} |
|
|
|
this.inFlight = []; |
|
this.inFlightTimer = null; |
|
|
|
this.startWatchingInFlight = function(){ |
|
//summary: internal method used to trigger a timer to watch all inflight |
|
//XMLHttpRequests. |
|
if(!this.inFlightTimer){ |
|
// setInterval broken in mozilla x86_64 in some circumstances, see |
|
// https://bugzilla.mozilla.org/show_bug.cgi?id=344439 |
|
// using setTimeout instead |
|
this.inFlightTimer = setTimeout("dojo.io.XMLHTTPTransport.watchInFlight();", 10); |
|
} |
|
} |
|
|
|
this.watchInFlight = function(){ |
|
//summary: internal method that checks each inflight XMLHttpRequest to see |
|
//if it has completed or if the timeout situation applies. |
|
var now = null; |
|
// make sure sync calls stay thread safe, if this callback is called during a sync call |
|
// and this results in another sync call before the first sync call ends the browser hangs |
|
if(!dojo.hostenv._blockAsync && !_this._blockAsync){ |
|
for(var x=this.inFlight.length-1; x>=0; x--){ |
|
try{ |
|
var tif = this.inFlight[x]; |
|
if(!tif || tif.http._aborted || !tif.http.readyState){ |
|
this.inFlight.splice(x, 1); continue; |
|
} |
|
if(4==tif.http.readyState){ |
|
// remove it so we can clean refs |
|
this.inFlight.splice(x, 1); |
|
doLoad(tif.req, tif.http, tif.url, tif.query, tif.useCache); |
|
}else if (tif.startTime){ |
|
//See if this is a timeout case. |
|
if(!now){ |
|
now = (new Date()).getTime(); |
|
} |
|
if(tif.startTime + (tif.req.timeoutSeconds * 1000) < now){ |
|
//Stop the request. |
|
if(typeof tif.http.abort == "function"){ |
|
tif.http.abort(); |
|
} |
|
|
|
// remove it so we can clean refs |
|
this.inFlight.splice(x, 1); |
|
tif.req[(typeof tif.req.timeout == "function") ? "timeout" : "handle"]("timeout", null, tif.http, tif.req); |
|
} |
|
} |
|
}catch(e){ |
|
try{ |
|
var errObj = new dojo.io.Error("XMLHttpTransport.watchInFlight Error: " + e); |
|
tif.req[(typeof tif.req.error == "function") ? "error" : "handle"]("error", errObj, tif.http, tif.req); |
|
}catch(e2){ |
|
dojo.debug("XMLHttpTransport error callback failed: " + e2); |
|
} |
|
} |
|
} |
|
} |
|
|
|
clearTimeout(this.inFlightTimer); |
|
if(this.inFlight.length == 0){ |
|
this.inFlightTimer = null; |
|
return; |
|
} |
|
this.inFlightTimer = setTimeout("dojo.io.XMLHTTPTransport.watchInFlight();", 10); |
|
} |
|
|
|
var hasXmlHttp = dojo.hostenv.getXmlhttpObject() ? true : false; |
|
this.canHandle = function(/*dojo.io.Request*/kwArgs){ |
|
//summary: Tells dojo.io.bind() if this is a good transport to |
|
//use for the particular type of request. This type of transport cannot |
|
//handle forms that have an input type="file" element. |
|
|
|
// FIXME: we need to determine when form values need to be |
|
// multi-part mime encoded and avoid using this transport for those |
|
// requests. |
|
return hasXmlHttp |
|
&& dojo.lang.inArray(["text/plain", "text/html", "application/xml", "text/xml", "text/javascript", "text/json", "application/json"], (kwArgs["mimetype"].toLowerCase()||"")) |
|
&& !( kwArgs["formNode"] && dojo.io.formHasFile(kwArgs["formNode"]) ); //boolean |
|
} |
|
|
|
this.multipartBoundary = "45309FFF-BD65-4d50-99C9-36986896A96F"; // unique guid as a boundary value for multipart posts |
|
|
|
this.bind = function(/*dojo.io.Request*/kwArgs){ |
|
//summary: function that sends the request to the server. |
|
|
|
//This function will attach an abort() function to the kwArgs dojo.io.Request object, |
|
//so if you need to abort the request, you can call that method on the request object. |
|
//The following are acceptable properties in kwArgs (in addition to the |
|
//normal dojo.io.Request object properties). |
|
//url: String: URL the server URL to use for the request. |
|
//method: String: the HTTP method to use (GET, POST, etc...). |
|
//mimetype: Specifies what format the result data should be given to the load/handle callback. Valid values are: |
|
// text/javascript, text/json, application/json, application/xml, text/xml. Any other mimetype will give back a text |
|
// string. |
|
//transport: String: specify "XMLHTTPTransport" to force the use of this XMLHttpRequest transport. |
|
//headers: Object: The object property names and values will be sent as HTTP request header |
|
// names and values. |
|
//sendTransport: boolean: If true, then dojo.transport=xmlhttp will be added to the request. |
|
//encoding: String: The type of encoding to use when dealing with the content kwArgs property. |
|
//content: Object: The content object is converted into a name=value&name=value string, by |
|
// using dojo.io.argsFromMap(). The encoding kwArgs property is passed to dojo.io.argsFromMap() |
|
// for use in encoding the names and values. The resulting string is added to the request. |
|
//formNode: DOMNode: a form element node. This should not normally be used. Use new dojo.io.FormBind() instead. |
|
// If formNode is used, then the names and values of the form elements will be converted |
|
// to a name=value&name=value string and added to the request. The encoding kwArgs property is used |
|
// to encode the names and values. |
|
//postContent: String: Raw name=value&name=value string to be included as part of the request. |
|
//back or backButton: Function: A function to be called if the back button is pressed. If this kwArgs property |
|
// is used, then back button support via dojo.undo.browser will be used. See notes for dojo.undo.browser on usage. |
|
// You need to set djConfig.preventBackButtonFix = false to enable back button support. |
|
//changeUrl: boolean or String: Used as part of back button support. See notes for dojo.undo.browser on usage. |
|
//user: String: The user name. Used in conjuction with password. Passed to XMLHttpRequest.open(). |
|
//password: String: The user's password. Used in conjuction with user. Passed to XMLHttpRequest.open(). |
|
//file: Object or Array of Objects: an object simulating a file to be uploaded. file objects should have the following properties: |
|
// name or fileName: the name of the file |
|
// contentType: the MIME content type for the file. |
|
// content: the actual content of the file. |
|
//multipart: boolean: indicates whether this should be a multipart mime request. If kwArgs.file exists, then this |
|
// property is set to true automatically. |
|
//sync: boolean: if true, then a synchronous XMLHttpRequest call is done, |
|
// if false (the default), then an asynchronous call is used. |
|
//preventCache: boolean: If true, then a cache busting parameter is added to the request URL. |
|
// default value is false. |
|
//useCache: boolean: If true, then XMLHttpTransport will keep an internal cache of the server |
|
// response and use that response if a similar request is done again. |
|
// A similar request is one that has the same URL, query string and HTTP method value. |
|
// default is false. |
|
if(!kwArgs["url"]){ |
|
// are we performing a history action? |
|
if( !kwArgs["formNode"] |
|
&& (kwArgs["backButton"] || kwArgs["back"] || kwArgs["changeUrl"] || kwArgs["watchForURL"]) |
|
&& (!djConfig.preventBackButtonFix)) { |
|
dojo.deprecated("Using dojo.io.XMLHTTPTransport.bind() to add to browser history without doing an IO request", |
|
"Use dojo.undo.browser.addToHistory() instead.", "0.4"); |
|
dojo.undo.browser.addToHistory(kwArgs); |
|
return true; |
|
} |
|
} |
|
|
|
// build this first for cache purposes |
|
var url = kwArgs.url; |
|
var query = ""; |
|
if(kwArgs["formNode"]){ |
|
var ta = kwArgs.formNode.getAttribute("action"); |
|
if((ta)&&(!kwArgs["url"])){ url = ta; } |
|
var tp = kwArgs.formNode.getAttribute("method"); |
|
if((tp)&&(!kwArgs["method"])){ kwArgs.method = tp; } |
|
query += dojo.io.encodeForm(kwArgs.formNode, kwArgs.encoding, kwArgs["formFilter"]); |
|
} |
|
|
|
if(url.indexOf("#") > -1) { |
|
dojo.debug("Warning: dojo.io.bind: stripping hash values from url:", url); |
|
url = url.split("#")[0]; |
|
} |
|
|
|
if(kwArgs["file"]){ |
|
// force post for file transfer |
|
kwArgs.method = "post"; |
|
} |
|
|
|
if(!kwArgs["method"]){ |
|
kwArgs.method = "get"; |
|
} |
|
|
|
// guess the multipart value |
|
if(kwArgs.method.toLowerCase() == "get"){ |
|
// GET cannot use multipart |
|
kwArgs.multipart = false; |
|
}else{ |
|
if(kwArgs["file"]){ |
|
// enforce multipart when sending files |
|
kwArgs.multipart = true; |
|
}else if(!kwArgs["multipart"]){ |
|
// default |
|
kwArgs.multipart = false; |
|
} |
|
} |
|
|
|
if(kwArgs["backButton"] || kwArgs["back"] || kwArgs["changeUrl"]){ |
|
dojo.undo.browser.addToHistory(kwArgs); |
|
} |
|
|
|
var content = kwArgs["content"] || {}; |
|
|
|
if(kwArgs.sendTransport) { |
|
content["dojo.transport"] = "xmlhttp"; |
|
} |
|
|
|
do { // break-block |
|
if(kwArgs.postContent){ |
|
query = kwArgs.postContent; |
|
break; |
|
} |
|
|
|
if(content) { |
|
query += dojo.io.argsFromMap(content, kwArgs.encoding); |
|
} |
|
|
|
if(kwArgs.method.toLowerCase() == "get" || !kwArgs.multipart){ |
|
break; |
|
} |
|
|
|
var t = []; |
|
if(query.length){ |
|
var q = query.split("&"); |
|
for(var i = 0; i < q.length; ++i){ |
|
if(q[i].length){ |
|
var p = q[i].split("="); |
|
t.push( "--" + this.multipartBoundary, |
|
"Content-Disposition: form-data; name=\"" + p[0] + "\"", |
|
"", |
|
p[1]); |
|
} |
|
} |
|
} |
|
|
|
if(kwArgs.file){ |
|
if(dojo.lang.isArray(kwArgs.file)){ |
|
for(var i = 0; i < kwArgs.file.length; ++i){ |
|
var o = kwArgs.file[i]; |
|
t.push( "--" + this.multipartBoundary, |
|
"Content-Disposition: form-data; name=\"" + o.name + "\"; filename=\"" + ("fileName" in o ? o.fileName : o.name) + "\"", |
|
"Content-Type: " + ("contentType" in o ? o.contentType : "application/octet-stream"), |
|
"", |
|
o.content); |
|
} |
|
}else{ |
|
var o = kwArgs.file; |
|
t.push( "--" + this.multipartBoundary, |
|
"Content-Disposition: form-data; name=\"" + o.name + "\"; filename=\"" + ("fileName" in o ? o.fileName : o.name) + "\"", |
|
"Content-Type: " + ("contentType" in o ? o.contentType : "application/octet-stream"), |
|
"", |
|
o.content); |
|
} |
|
} |
|
|
|
if(t.length){ |
|
t.push("--"+this.multipartBoundary+"--", ""); |
|
query = t.join("\r\n"); |
|
} |
|
}while(false); |
|
|
|
// kwArgs.Connection = "close"; |
|
|
|
var async = kwArgs["sync"] ? false : true; |
|
|
|
var preventCache = kwArgs["preventCache"] || |
|
(this.preventCache == true && kwArgs["preventCache"] != false); |
|
var useCache = kwArgs["useCache"] == true || |
|
(this.useCache == true && kwArgs["useCache"] != false ); |
|
|
|
// preventCache is browser-level (add query string junk), useCache |
|
// is for the local cache. If we say preventCache, then don't attempt |
|
// to look in the cache, but if useCache is true, we still want to cache |
|
// the response |
|
if(!preventCache && useCache){ |
|
var cachedHttp = getFromCache(url, query, kwArgs.method); |
|
if(cachedHttp){ |
|
doLoad(kwArgs, cachedHttp, url, query, false); |
|
return; |
|
} |
|
} |
|
|
|
// much of this is from getText, but reproduced here because we need |
|
// more flexibility |
|
var http = dojo.hostenv.getXmlhttpObject(kwArgs); |
|
var received = false; |
|
|
|
// build a handler function that calls back to the handler obj |
|
if(async){ |
|
var startTime = |
|
// FIXME: setting up this callback handler leaks on IE!!! |
|
this.inFlight.push({ |
|
"req": kwArgs, |
|
"http": http, |
|
"url": url, |
|
"query": query, |
|
"useCache": useCache, |
|
"startTime": kwArgs.timeoutSeconds ? (new Date()).getTime() : 0 |
|
}); |
|
this.startWatchingInFlight(); |
|
}else{ |
|
// block async callbacks until sync is in, needed in khtml, others? |
|
_this._blockAsync = true; |
|
} |
|
|
|
if(kwArgs.method.toLowerCase() == "post"){ |
|
// FIXME: need to hack in more flexible Content-Type setting here! |
|
if (!kwArgs.user) { |
|
http.open("POST", url, async); |
|
}else{ |
|
http.open("POST", url, async, kwArgs.user, kwArgs.password); |
|
} |
|
setHeaders(http, kwArgs); |
|
http.setRequestHeader("Content-Type", kwArgs.multipart ? ("multipart/form-data; boundary=" + this.multipartBoundary) : |
|
(kwArgs.contentType || "application/x-www-form-urlencoded")); |
|
try{ |
|
http.send(query); |
|
}catch(e){ |
|
if(typeof http.abort == "function"){ |
|
http.abort(); |
|
} |
|
doLoad(kwArgs, {status: 404}, url, query, useCache); |
|
} |
|
}else{ |
|
var tmpUrl = url; |
|
if(query != "") { |
|
tmpUrl += (tmpUrl.indexOf("?") > -1 ? "&" : "?") + query; |
|
} |
|
if(preventCache) { |
|
tmpUrl += (dojo.string.endsWithAny(tmpUrl, "?", "&") |
|
? "" : (tmpUrl.indexOf("?") > -1 ? "&" : "?")) + "dojo.preventCache=" + new Date().valueOf(); |
|
} |
|
if (!kwArgs.user) { |
|
http.open(kwArgs.method.toUpperCase(), tmpUrl, async); |
|
}else{ |
|
http.open(kwArgs.method.toUpperCase(), tmpUrl, async, kwArgs.user, kwArgs.password); |
|
} |
|
setHeaders(http, kwArgs); |
|
try { |
|
http.send(null); |
|
}catch(e) { |
|
if(typeof http.abort == "function"){ |
|
http.abort(); |
|
} |
|
doLoad(kwArgs, {status: 404}, url, query, useCache); |
|
} |
|
} |
|
|
|
if( !async ) { |
|
doLoad(kwArgs, http, url, query, useCache); |
|
_this._blockAsync = false; |
|
} |
|
|
|
kwArgs.abort = function(){ |
|
try{// khtml doesent reset readyState on abort, need this workaround |
|
http._aborted = true; |
|
}catch(e){/*squelsh*/} |
|
return http.abort(); |
|
} |
|
|
|
return; |
|
} |
|
dojo.io.transports.addTransport("XMLHTTPTransport"); |
|
} |
|
|
|
} |
|
|
|
dojo.provide("dojo.io.cookie"); |
|
|
|
dojo.io.cookie.setCookie = function(/*String*/name, /*String*/value, |
|
/*Number?*/days, /*String?*/path, |
|
/*String?*/domain, /*boolean?*/secure){ |
|
//summary: sets a cookie. |
|
var expires = -1; |
|
if((typeof days == "number")&&(days >= 0)){ |
|
var d = new Date(); |
|
d.setTime(d.getTime()+(days*24*60*60*1000)); |
|
expires = d.toGMTString(); |
|
} |
|
value = escape(value); |
|
document.cookie = name + "=" + value + ";" |
|
+ (expires != -1 ? " expires=" + expires + ";" : "") |
|
+ (path ? "path=" + path : "") |
|
+ (domain ? "; domain=" + domain : "") |
|
+ (secure ? "; secure" : ""); |
|
} |
|
|
|
dojo.io.cookie.set = dojo.io.cookie.setCookie; |
|
|
|
dojo.io.cookie.getCookie = function(/*String*/name){ |
|
//summary: Gets a cookie with the given name. |
|
|
|
// FIXME: Which cookie should we return? |
|
// If there are cookies set for different sub domains in the current |
|
// scope there could be more than one cookie with the same name. |
|
// I think taking the last one in the list takes the one from the |
|
// deepest subdomain, which is what we're doing here. |
|
var idx = document.cookie.lastIndexOf(name+'='); |
|
if(idx == -1) { return null; } |
|
var value = document.cookie.substring(idx+name.length+1); |
|
var end = value.indexOf(';'); |
|
if(end == -1) { end = value.length; } |
|
value = value.substring(0, end); |
|
value = unescape(value); |
|
return value; //String |
|
} |
|
|
|
dojo.io.cookie.get = dojo.io.cookie.getCookie; |
|
|
|
dojo.io.cookie.deleteCookie = function(/*String*/name){ |
|
//summary: Deletes a cookie with the given name. |
|
dojo.io.cookie.setCookie(name, "-", 0); |
|
} |
|
|
|
dojo.io.cookie.setObjectCookie = function( /*String*/name, /*Object*/obj, |
|
/*Number?*/days, /*String?*/path, |
|
/*String?*/domain, /*boolean?*/secure, |
|
/*boolean?*/clearCurrent){ |
|
//summary: Takes an object, serializes it to a cookie value, and either |
|
//sets a cookie with the serialized value. |
|
//description: If clearCurrent is true, then any current cookie value |
|
//for this object will be replaced with the the new serialized object value. |
|
//If clearCurrent is false, then the existing cookie value will be modified |
|
//with any changes from the new object value. |
|
//Objects must be simple name/value pairs where the value is either a string |
|
//or a number. Any other value will be ignored. |
|
if(arguments.length == 5){ // for backwards compat |
|
clearCurrent = domain; |
|
domain = null; |
|
secure = null; |
|
} |
|
var pairs = [], cookie, value = ""; |
|
if(!clearCurrent){ |
|
cookie = dojo.io.cookie.getObjectCookie(name); |
|
} |
|
if(days >= 0){ |
|
if(!cookie){ cookie = {}; } |
|
for(var prop in obj){ |
|
if(obj[prop] == null){ |
|
delete cookie[prop]; |
|
}else if((typeof obj[prop] == "string")||(typeof obj[prop] == "number")){ |
|
cookie[prop] = obj[prop]; |
|
} |
|
} |
|
prop = null; |
|
for(var prop in cookie){ |
|
pairs.push(escape(prop) + "=" + escape(cookie[prop])); |
|
} |
|
value = pairs.join("&"); |
|
} |
|
dojo.io.cookie.setCookie(name, value, days, path, domain, secure); |
|
} |
|
|
|
dojo.io.cookie.getObjectCookie = function(/*String*/name){ |
|
//summary: Gets an object value for the given cookie name. The complement of |
|
//dojo.io.cookie.setObjectCookie(). |
|
var values = null, cookie = dojo.io.cookie.getCookie(name); |
|
if(cookie){ |
|
values = {}; |
|
var pairs = cookie.split("&"); |
|
for(var i = 0; i < pairs.length; i++){ |
|
var pair = pairs[i].split("="); |
|
var value = pair[1]; |
|
if( isNaN(value) ){ value = unescape(pair[1]); } |
|
values[ unescape(pair[0]) ] = value; |
|
} |
|
} |
|
return values; |
|
} |
|
|
|
dojo.io.cookie.isSupported = function(){ |
|
//summary: Tests the browser to see if cookies are enabled. |
|
if(typeof navigator.cookieEnabled != "boolean"){ |
|
dojo.io.cookie.setCookie("__TestingYourBrowserForCookieSupport__", |
|
"CookiesAllowed", 90, null); |
|
var cookieVal = dojo.io.cookie.getCookie("__TestingYourBrowserForCookieSupport__"); |
|
navigator.cookieEnabled = (cookieVal == "CookiesAllowed"); |
|
if(navigator.cookieEnabled){ |
|
// FIXME: should we leave this around? |
|
this.deleteCookie("__TestingYourBrowserForCookieSupport__"); |
|
} |
|
} |
|
return navigator.cookieEnabled; //boolean |
|
} |
|
|
|
// need to leave this in for backwards-compat from 0.1 for when it gets pulled in by dojo.io.* |
|
if(!dojo.io.cookies){ dojo.io.cookies = dojo.io.cookie; } |
|
|
|
dojo.kwCompoundRequire({ |
|
common: ["dojo.io.common"], |
|
rhino: ["dojo.io.RhinoIO"], |
|
browser: ["dojo.io.BrowserIO", "dojo.io.cookie"], |
|
dashboard: ["dojo.io.BrowserIO", "dojo.io.cookie"] |
|
}); |
|
dojo.provide("dojo.io.*"); |
|
|
|
dojo.provide("dojo.event.common"); |
|
|
|
|
|
|
|
|
|
|
|
// TODO: connection filter functions |
|
// these are functions that accept a method invocation (like around |
|
// advice) and return a boolean based on it. That value determines |
|
// whether or not the connection proceeds. It could "feel" like around |
|
// advice for those who know what it is (calling proceed() or not), |
|
// but I think presenting it as a "filter" and/or calling it with the |
|
// function args and not the MethodInvocation might make it more |
|
// palletable to "normal" users than around-advice currently is |
|
// TODO: execution scope mangling |
|
// YUI's event facility by default executes listeners in the context |
|
// of the source object. This is very odd, but should probably be |
|
// supported as an option (both for the source and for the dest). It |
|
// can be thought of as a connection-specific hitch(). |
|
// TODO: more resiliency for 4+ arguments to connect() |
|
|
|
dojo.event = new function(){ |
|
this._canTimeout = dojo.lang.isFunction(dj_global["setTimeout"])||dojo.lang.isAlien(dj_global["setTimeout"]); |
|
|
|
// FIXME: where should we put this method (not here!)? |
|
function interpolateArgs(args, searchForNames){ |
|
var dl = dojo.lang; |
|
var ao = { |
|
srcObj: dj_global, |
|
srcFunc: null, |
|
adviceObj: dj_global, |
|
adviceFunc: null, |
|
aroundObj: null, |
|
aroundFunc: null, |
|
adviceType: (args.length>2) ? args[0] : "after", |
|
precedence: "last", |
|
once: false, |
|
delay: null, |
|
rate: 0, |
|
adviceMsg: false, |
|
maxCalls: -1 |
|
}; |
|
|
|
switch(args.length){ |
|
case 0: return; |
|
case 1: return; |
|
case 2: |
|
ao.srcFunc = args[0]; |
|
ao.adviceFunc = args[1]; |
|
break; |
|
case 3: |
|
if((dl.isObject(args[0]))&&(dl.isString(args[1]))&&(dl.isString(args[2]))){ |
|
ao.adviceType = "after"; |
|
ao.srcObj = args[0]; |
|
ao.srcFunc = args[1]; |
|
ao.adviceFunc = args[2]; |
|
}else if((dl.isString(args[1]))&&(dl.isString(args[2]))){ |
|
ao.srcFunc = args[1]; |
|
ao.adviceFunc = args[2]; |
|
}else if((dl.isObject(args[0]))&&(dl.isString(args[1]))&&(dl.isFunction(args[2]))){ |
|
ao.adviceType = "after"; |
|
ao.srcObj = args[0]; |
|
ao.srcFunc = args[1]; |
|
var tmpName = dl.nameAnonFunc(args[2], ao.adviceObj, searchForNames); |
|
ao.adviceFunc = tmpName; |
|
}else if((dl.isFunction(args[0]))&&(dl.isObject(args[1]))&&(dl.isString(args[2]))){ |
|
ao.adviceType = "after"; |
|
ao.srcObj = dj_global; |
|
var tmpName = dl.nameAnonFunc(args[0], ao.srcObj, searchForNames); |
|
ao.srcFunc = tmpName; |
|
ao.adviceObj = args[1]; |
|
ao.adviceFunc = args[2]; |
|
} |
|
break; |
|
case 4: |
|
if((dl.isObject(args[0]))&&(dl.isObject(args[2]))){ |
|
// we can assume that we've got an old-style "connect" from |
|
// the sigslot school of event attachment. We therefore |
|
// assume after-advice. |
|
ao.adviceType = "after"; |
|
ao.srcObj = args[0]; |
|
ao.srcFunc = args[1]; |
|
ao.adviceObj = args[2]; |
|
ao.adviceFunc = args[3]; |
|
}else if((dl.isString(args[0]))&&(dl.isString(args[1]))&&(dl.isObject(args[2]))){ |
|
ao.adviceType = args[0]; |
|
ao.srcObj = dj_global; |
|
ao.srcFunc = args[1]; |
|
ao.adviceObj = args[2]; |
|
ao.adviceFunc = args[3]; |
|
}else if((dl.isString(args[0]))&&(dl.isFunction(args[1]))&&(dl.isObject(args[2]))){ |
|
ao.adviceType = args[0]; |
|
ao.srcObj = dj_global; |
|
var tmpName = dl.nameAnonFunc(args[1], dj_global, searchForNames); |
|
ao.srcFunc = tmpName; |
|
ao.adviceObj = args[2]; |
|
ao.adviceFunc = args[3]; |
|
}else if((dl.isString(args[0]))&&(dl.isObject(args[1]))&&(dl.isString(args[2]))&&(dl.isFunction(args[3]))){ |
|
ao.srcObj = args[1]; |
|
ao.srcFunc = args[2]; |
|
var tmpName = dl.nameAnonFunc(args[3], dj_global, searchForNames); |
|
ao.adviceObj = dj_global; |
|
ao.adviceFunc = tmpName; |
|
}else if(dl.isObject(args[1])){ |
|
ao.srcObj = args[1]; |
|
ao.srcFunc = args[2]; |
|
ao.adviceObj = dj_global; |
|
ao.adviceFunc = args[3]; |
|
}else if(dl.isObject(args[2])){ |
|
ao.srcObj = dj_global; |
|
ao.srcFunc = args[1]; |
|
ao.adviceObj = args[2]; |
|
ao.adviceFunc = args[3]; |
|
}else{ |
|
ao.srcObj = ao.adviceObj = ao.aroundObj = dj_global; |
|
ao.srcFunc = args[1]; |
|
ao.adviceFunc = args[2]; |
|
ao.aroundFunc = args[3]; |
|
} |
|
break; |
|
case 6: |
|
ao.srcObj = args[1]; |
|
ao.srcFunc = args[2]; |
|
ao.adviceObj = args[3] |
|
ao.adviceFunc = args[4]; |
|
ao.aroundFunc = args[5]; |
|
ao.aroundObj = dj_global; |
|
break; |
|
default: |
|
ao.srcObj = args[1]; |
|
ao.srcFunc = args[2]; |
|
ao.adviceObj = args[3] |
|
ao.adviceFunc = args[4]; |
|
ao.aroundObj = args[5]; |
|
ao.aroundFunc = args[6]; |
|
ao.once = args[7]; |
|
ao.delay = args[8]; |
|
ao.rate = args[9]; |
|
ao.adviceMsg = args[10]; |
|
ao.maxCalls = (!isNaN(parseInt(args[11]))) ? args[11] : -1; |
|
break; |
|
} |
|
|
|
if(dl.isFunction(ao.aroundFunc)){ |
|
var tmpName = dl.nameAnonFunc(ao.aroundFunc, ao.aroundObj, searchForNames); |
|
ao.aroundFunc = tmpName; |
|
} |
|
|
|
if(dl.isFunction(ao.srcFunc)){ |
|
ao.srcFunc = dl.getNameInObj(ao.srcObj, ao.srcFunc); |
|
} |
|
|
|
if(dl.isFunction(ao.adviceFunc)){ |
|
ao.adviceFunc = dl.getNameInObj(ao.adviceObj, ao.adviceFunc); |
|
} |
|
|
|
if((ao.aroundObj)&&(dl.isFunction(ao.aroundFunc))){ |
|
ao.aroundFunc = dl.getNameInObj(ao.aroundObj, ao.aroundFunc); |
|
} |
|
|
|
if(!ao.srcObj){ |
|
dojo.raise("bad srcObj for srcFunc: "+ao.srcFunc); |
|
} |
|
if(!ao.adviceObj){ |
|
dojo.raise("bad adviceObj for adviceFunc: "+ao.adviceFunc); |
|
} |
|
|
|
if(!ao.adviceFunc){ |
|
dojo.debug("bad adviceFunc for srcFunc: "+ao.srcFunc); |
|
dojo.debugShallow(ao); |
|
} |
|
|
|
return ao; |
|
} |
|
|
|
this.connect = function(/*...*/){ |
|
// summary: |
|
// dojo.event.connect is the glue that holds most Dojo-based |
|
// applications together. Most combinations of arguments are |
|
// supported, with the connect() method attempting to disambiguate |
|
// the implied types of positional parameters. The following will |
|
// all work: |
|
// dojo.event.connect("globalFunctionName1", "globalFunctionName2"); |
|
// dojo.event.connect(functionReference1, functionReference2); |
|
// dojo.event.connect("globalFunctionName1", functionReference2); |
|
// dojo.event.connect(functionReference1, "globalFunctionName2"); |
|
// dojo.event.connect(scope1, "functionName1", "globalFunctionName2"); |
|
// dojo.event.connect("globalFunctionName1", scope2, "functionName2"); |
|
// dojo.event.connect(scope1, "functionName1", scope2, "functionName2"); |
|
// dojo.event.connect("after", scope1, "functionName1", scope2, "functionName2"); |
|
// dojo.event.connect("before", scope1, "functionName1", scope2, "functionName2"); |
|
// dojo.event.connect("around", scope1, "functionName1", |
|
// scope2, "functionName2", |
|
// aroundFunctionReference); |
|
// dojo.event.connect("around", scope1, "functionName1", |
|
// scope2, "functionName2", |
|
// scope3, "aroundFunctionName"); |
|
// dojo.event.connect("before-around", scope1, "functionName1", |
|
// scope2, "functionName2", |
|
// aroundFunctionReference); |
|
// dojo.event.connect("after-around", scope1, "functionName1", |
|
// scope2, "functionName2", |
|
// aroundFunctionReference); |
|
// dojo.event.connect("after-around", scope1, "functionName1", |
|
// scope2, "functionName2", |
|
// scope3, "aroundFunctionName"); |
|
// dojo.event.connect("around", scope1, "functionName1", |
|
// scope2, "functionName2", |
|
// scope3, "aroundFunctionName", true, 30); |
|
// dojo.event.connect("around", scope1, "functionName1", |
|
// scope2, "functionName2", |
|
// scope3, "aroundFunctionName", null, null, 10); |
|
// adviceType: |
|
// Optional. String. One of "before", "after", "around", |
|
// "before-around", or "after-around". FIXME |
|
// srcObj: |
|
// the scope in which to locate/execute the named srcFunc. Along |
|
// with srcFunc, this creates a way to dereference the function to |
|
// call. So if the function in question is "foo.bar", the |
|
// srcObj/srcFunc pair would be foo and "bar", where "bar" is a |
|
// string and foo is an object reference. |
|
// srcFunc: |
|
// the name of the function to connect to. When it is executed, |
|
// the listener being registered with this call will be called. |
|
// The adviceType defines the call order between the source and |
|
// the target functions. |
|
// adviceObj: |
|
// the scope in which to locate/execute the named adviceFunc. |
|
// adviceFunc: |
|
// the name of the function being conected to srcObj.srcFunc |
|
// aroundObj: |
|
// the scope in which to locate/execute the named aroundFunc. |
|
// aroundFunc: |
|
// the name of, or a reference to, the function that will be used |
|
// to mediate the advice call. Around advice requires a special |
|
// unary function that will be passed a "MethodInvocation" object. |
|
// These objects have several important properties, namely: |
|
// - args |
|
// a mutable array of arguments to be passed into the |
|
// wrapped function |
|
// - proceed |
|
// a function that "continues" the invocation. The result |
|
// of this function is the return of the wrapped function. |
|
// You can then manipulate this return before passing it |
|
// back out (or take further action based on it). |
|
// once: |
|
// boolean that determines whether or not this connect() will |
|
// create a new connection if an identical connect() has already |
|
// been made. Defaults to "false". |
|
// delay: |
|
// an optional delay (in ms), as an integer, for dispatch of a |
|
// listener after the source has been fired. |
|
// rate: |
|
// an optional rate throttling parameter (integer, in ms). When |
|
// specified, this particular connection will not fire more than |
|
// once in the interval specified by the rate |
|
// adviceMsg: |
|
// boolean. Should the listener have all the parameters passed in |
|
// as a single argument? |
|
|
|
/* |
|
ao.adviceType = args[0]; |
|
ao.srcObj = args[1]; |
|
ao.srcFunc = args[2]; |
|
ao.adviceObj = args[3] |
|
ao.adviceFunc = args[4]; |
|
ao.aroundObj = args[5]; |
|
ao.aroundFunc = args[6]; |
|
ao.once = args[7]; |
|
ao.delay = args[8]; |
|
ao.rate = args[9]; |
|
ao.adviceMsg = args[10]; |
|
ao.maxCalls = args[11]; |
|
*/ |
|
if(arguments.length == 1){ |
|
var ao = arguments[0]; |
|
}else{ |
|
var ao = interpolateArgs(arguments, true); |
|
} |
|
/* |
|
if(dojo.lang.isString(ao.srcFunc) && (ao.srcFunc.toLowerCase() == "onkey") ){ |
|
if(dojo.render.html.ie){ |
|
ao.srcFunc = "onkeydown"; |
|
this.connect(ao); |
|
} |
|
ao.srcFunc = "onkeypress"; |
|
} |
|
*/ |
|
|
|
if(dojo.lang.isArray(ao.srcObj) && ao.srcObj!=""){ |
|
var tmpAO = {}; |
|
for(var x in ao){ |
|
tmpAO[x] = ao[x]; |
|
} |
|
var mjps = []; |
|
dojo.lang.forEach(ao.srcObj, function(src){ |
|
if((dojo.render.html.capable)&&(dojo.lang.isString(src))){ |
|
src = dojo.byId(src); |
|
// dojo.debug(src); |
|
} |
|
tmpAO.srcObj = src; |
|
// dojo.debug(tmpAO.srcObj, tmpAO.srcFunc); |
|
// dojo.debug(tmpAO.adviceObj, tmpAO.adviceFunc); |
|
mjps.push(dojo.event.connect.call(dojo.event, tmpAO)); |
|
}); |
|
return mjps; |
|
} |
|
|
|
// FIXME: just doing a "getForMethod()" seems to be enough to put this into infinite recursion!! |
|
var mjp = dojo.event.MethodJoinPoint.getForMethod(ao.srcObj, ao.srcFunc); |
|
if(ao.adviceFunc){ |
|
var mjp2 = dojo.event.MethodJoinPoint.getForMethod(ao.adviceObj, ao.adviceFunc); |
|
} |
|
|
|
mjp.kwAddAdvice(ao); |
|
|
|
// advanced users might want to fsck w/ the join point manually |
|
return mjp; // a MethodJoinPoint object |
|
} |
|
|
|
this.log = function(/*object or funcName*/ a1, /*funcName*/ a2){ |
|
// summary: |
|
// a function that will wrap and log all calls to the specified |
|
// a1.a2() function. If only a1 is passed, it'll be used as a |
|
// function or function name on the global context. Logging will |
|
// be sent to dojo.debug |
|
// a1: |
|
// if a2 is passed, this should be an object. If not, it can be a |
|
// function or function name. |
|
// a2: |
|
// a function name |
|
var kwArgs; |
|
if((arguments.length == 1)&&(typeof a1 == "object")){ |
|
kwArgs = a1; |
|
}else{ |
|
kwArgs = { |
|
srcObj: a1, |
|
srcFunc: a2 |
|
}; |
|
} |
|
kwArgs.adviceFunc = function(){ |
|
var argsStr = []; |
|
for(var x=0; x<arguments.length; x++){ |
|
argsStr.push(arguments[x]); |
|
} |
|
dojo.debug("("+kwArgs.srcObj+")."+kwArgs.srcFunc, ":", argsStr.join(", ")); |
|
}; |
|
this.kwConnect(kwArgs); |
|
} |
|
|
|
this.connectBefore = function(){ |
|
// summary: |
|
// takes the same parameters as dojo.event.connect(), except that |
|
// the advice type will always be "before" |
|
var args = ["before"]; |
|
for(var i = 0; i < arguments.length; i++){ args.push(arguments[i]); } |
|
return this.connect.apply(this, args); // a MethodJoinPoint object |
|
} |
|
|
|
this.connectAround = function(){ |
|
// summary: |
|
// takes the same parameters as dojo.event.connect(), except that |
|
// the advice type will always be "around" |
|
var args = ["around"]; |
|
for(var i = 0; i < arguments.length; i++){ args.push(arguments[i]); } |
|
return this.connect.apply(this, args); // a MethodJoinPoint object |
|
} |
|
|
|
this.connectOnce = function(){ |
|
// summary: |
|
// takes the same parameters as dojo.event.connect(), except that |
|
// the "once" flag will always be set to "true" |
|
var ao = interpolateArgs(arguments, true); |
|
ao.once = true; |
|
return this.connect(ao); // a MethodJoinPoint object |
|
} |
|
|
|
this.connectRunOnce = function(){ |
|
// summary: |
|
// takes the same parameters as dojo.event.connect(), except that |
|
// the "maxCalls" flag will always be set to 1 |
|
var ao = interpolateArgs(arguments, true); |
|
ao.maxCalls = 1; |
|
return this.connect(ao); // a MethodJoinPoint object |
|
} |
|
|
|
this._kwConnectImpl = function(kwArgs, disconnect){ |
|
var fn = (disconnect) ? "disconnect" : "connect"; |
|
if(typeof kwArgs["srcFunc"] == "function"){ |
|
kwArgs.srcObj = kwArgs["srcObj"]||dj_global; |
|
var tmpName = dojo.lang.nameAnonFunc(kwArgs.srcFunc, kwArgs.srcObj, true); |
|
kwArgs.srcFunc = tmpName; |
|
} |
|
if(typeof kwArgs["adviceFunc"] == "function"){ |
|
kwArgs.adviceObj = kwArgs["adviceObj"]||dj_global; |
|
var tmpName = dojo.lang.nameAnonFunc(kwArgs.adviceFunc, kwArgs.adviceObj, true); |
|
kwArgs.adviceFunc = tmpName; |
|
} |
|
kwArgs.srcObj = kwArgs["srcObj"]||dj_global; |
|
kwArgs.adviceObj = kwArgs["adviceObj"]||kwArgs["targetObj"]||dj_global; |
|
kwArgs.adviceFunc = kwArgs["adviceFunc"]||kwArgs["targetFunc"]; |
|
// pass kwargs to avoid unrolling/repacking |
|
return dojo.event[fn](kwArgs); |
|
} |
|
|
|
this.kwConnect = function(/*Object*/ kwArgs){ |
|
// summary: |
|
// A version of dojo.event.connect() that takes a map of named |
|
// parameters instead of the positional parameters that |
|
// dojo.event.connect() uses. For many advanced connection types, |
|
// this can be a much more readable (and potentially faster) |
|
// alternative. |
|
// kwArgs: |
|
// An object that can have the following properties: |
|
// - adviceType |
|
// - srcObj |
|
// - srcFunc |
|
// - adviceObj |
|
// - adviceFunc |
|
// - aroundObj |
|
// - aroundFunc |
|
// - once |
|
// - delay |
|
// - rate |
|
// - adviceMsg |
|
// As with connect, only srcFunc and adviceFunc are generally |
|
// required |
|
|
|
return this._kwConnectImpl(kwArgs, false); // a MethodJoinPoint object |
|
|
|
} |
|
|
|
this.disconnect = function(){ |
|
// summary: |
|
// Takes the same parameters as dojo.event.connect() but destroys |
|
// an existing connection instead of building a new one. For |
|
// multiple identical connections, multiple disconnect() calls |
|
// will unroll one each time it's called. |
|
if(arguments.length == 1){ |
|
var ao = arguments[0]; |
|
}else{ |
|
var ao = interpolateArgs(arguments, true); |
|
} |
|
if(!ao.adviceFunc){ return; } // nothing to disconnect |
|
if(dojo.lang.isString(ao.srcFunc) && (ao.srcFunc.toLowerCase() == "onkey") ){ |
|
if(dojo.render.html.ie){ |
|
ao.srcFunc = "onkeydown"; |
|
this.disconnect(ao); |
|
} |
|
ao.srcFunc = "onkeypress"; |
|
} |
|
if(!ao.srcObj[ao.srcFunc]){ return null; } // prevent un-necessaray joinpoint creation |
|
var mjp = dojo.event.MethodJoinPoint.getForMethod(ao.srcObj, ao.srcFunc, true); |
|
mjp.removeAdvice(ao.adviceObj, ao.adviceFunc, ao.adviceType, ao.once); // a MethodJoinPoint object |
|
return mjp; |
|
} |
|
|
|
this.kwDisconnect = function(kwArgs){ |
|
// summary: |
|
// Takes the same parameters as dojo.event.kwConnect() but |
|
// destroys an existing connection instead of building a new one. |
|
return this._kwConnectImpl(kwArgs, true); |
|
} |
|
} |
|
|
|
// exactly one of these is created whenever a method with a joint point is run, |
|
// if there is at least one 'around' advice. |
|
dojo.event.MethodInvocation = function(/*dojo.event.MethodJoinPoint*/join_point, /*Object*/obj, /*Array*/args){ |
|
// summary: |
|
// a class the models the call into a function. This is used under the |
|
// covers for all method invocations on both ends of a |
|
// connect()-wrapped function dispatch. This allows us to "pickle" |
|
// calls, such as in the case of around advice. |
|
// join_point: |
|
// a dojo.event.MethodJoinPoint object that represents a connection |
|
// obj: |
|
// the scope the call will execute in |
|
// args: |
|
// an array of parameters that will get passed to the callee |
|
this.jp_ = join_point; |
|
this.object = obj; |
|
this.args = []; |
|
// make sure we don't lock into a mutable object which can change under us. |
|
// It's ok if the individual items change, though. |
|
for(var x=0; x<args.length; x++){ |
|
this.args[x] = args[x]; |
|
} |
|
// the index of the 'around' that is currently being executed. |
|
this.around_index = -1; |
|
} |
|
|
|
dojo.event.MethodInvocation.prototype.proceed = function(){ |
|
// summary: |
|
// proceed with the method call that's represented by this invocation |
|
// object |
|
this.around_index++; |
|
if(this.around_index >= this.jp_.around.length){ |
|
return this.jp_.object[this.jp_.methodname].apply(this.jp_.object, this.args); |
|
// return this.jp_.run_before_after(this.object, this.args); |
|
}else{ |
|
var ti = this.jp_.around[this.around_index]; |
|
var mobj = ti[0]||dj_global; |
|
var meth = ti[1]; |
|
return mobj[meth].call(mobj, this); |
|
} |
|
} |
|
|
|
|
|
dojo.event.MethodJoinPoint = function(/*Object*/obj, /*String*/funcName){ |
|
this.object = obj||dj_global; |
|
this.methodname = funcName; |
|
this.methodfunc = this.object[funcName]; |
|
this.squelch = false; |
|
// this.before = []; |
|
// this.after = []; |
|
// this.around = []; |
|
} |
|
|
|
dojo.event.MethodJoinPoint.getForMethod = function(/*Object*/obj, /*String*/funcName){ |
|
// summary: |
|
// "static" class function for returning a MethodJoinPoint from a |
|
// scoped function. If one doesn't exist, one is created. |
|
// obj: |
|
// the scope to search for the function in |
|
// funcName: |
|
// the name of the function to return a MethodJoinPoint for |
|
if(!obj){ obj = dj_global; } |
|
var ofn = obj[funcName]; |
|
if(!ofn){ |
|
// supply a do-nothing method implementation |
|
ofn = obj[funcName] = function(){}; |
|
if(!obj[funcName]){ |
|
// e.g. cannot add to inbuilt objects in IE6 |
|
dojo.raise("Cannot set do-nothing method on that object "+funcName); |
|
} |
|
}else if((typeof ofn != "function")&&(!dojo.lang.isFunction(ofn))&&(!dojo.lang.isAlien(ofn))){ |
|
// FIXME: should we throw an exception here instead? |
|
return null; |
|
} |
|
// we hide our joinpoint instance in obj[funcName + '$joinpoint'] |
|
var jpname = funcName + "$joinpoint"; |
|
var jpfuncname = funcName + "$joinpoint$method"; |
|
var joinpoint = obj[jpname]; |
|
if(!joinpoint){ |
|
var isNode = false; |
|
if(dojo.event["browser"]){ |
|
if( (obj["attachEvent"])|| |
|
(obj["nodeType"])|| |
|
(obj["addEventListener"]) ){ |
|
isNode = true; |
|
dojo.event.browser.addClobberNodeAttrs(obj, [jpname, jpfuncname, funcName]); |
|
} |
|
} |
|
var origArity = ofn.length; |
|
obj[jpfuncname] = ofn; |
|
// joinpoint = obj[jpname] = new dojo.event.MethodJoinPoint(obj, funcName); |
|
joinpoint = obj[jpname] = new dojo.event.MethodJoinPoint(obj, jpfuncname); |
|
|
|
if(!isNode){ |
|
obj[funcName] = function(){ |
|
// var args = []; |
|
// for(var x=0; x<arguments.length; x++){ |
|
// args.push(arguments[x]); |
|
// } |
|
// return joinpoint.run.apply(joinpoint, args); |
|
return joinpoint.run.apply(joinpoint, arguments); |
|
} |
|
}else{ |
|
obj[funcName] = function(){ |
|
var args = []; |
|
|
|
if(!arguments.length){ |
|
var evt = null; |
|
try{ |
|
if(obj.ownerDocument){ |
|
evt = obj.ownerDocument.parentWindow.event; |
|
}else if(obj.documentElement){ |
|
evt = obj.documentElement.ownerDocument.parentWindow.event; |
|
}else if(obj.event){ //obj is a window |
|
evt = obj.event; |
|
}else{ |
|
evt = window.event; |
|
} |
|
}catch(e){ |
|
evt = window.event; |
|
} |
|
|
|
if(evt){ |
|
args.push(dojo.event.browser.fixEvent(evt, this)); |
|
} |
|
}else{ |
|
for(var x=0; x<arguments.length; x++){ |
|
if((x==0)&&(dojo.event.browser.isEvent(arguments[x]))){ |
|
args.push(dojo.event.browser.fixEvent(arguments[x], this)); |
|
}else{ |
|
args.push(arguments[x]); |
|
} |
|
} |
|
} |
|
// return joinpoint.run.apply(joinpoint, arguments); |
|
return joinpoint.run.apply(joinpoint, args); |
|
} |
|
} |
|
obj[funcName].__preJoinArity = origArity; |
|
} |
|
return joinpoint; // dojo.event.MethodJoinPoint |
|
} |
|
|
|
dojo.lang.extend(dojo.event.MethodJoinPoint, { |
|
squelch: false, |
|
|
|
unintercept: function(){ |
|
// summary: |
|
// destroy the connection to all listeners that may have been |
|
// registered on this joinpoint |
|
this.object[this.methodname] = this.methodfunc; |
|
this.before = []; |
|
this.after = []; |
|
this.around = []; |
|
}, |
|
|
|
disconnect: dojo.lang.forward("unintercept"), |
|
|
|
run: function(){ |
|
// summary: |
|
// execute the connection represented by this join point. The |
|
// arguments passed to run() will be passed to the function and |
|
// its listeners. |
|
var obj = this.object||dj_global; |
|
var args = arguments; |
|
|
|
// optimization. We only compute once the array version of the arguments |
|
// pseudo-arr in order to prevent building it each time advice is unrolled. |
|
var aargs = []; |
|
for(var x=0; x<args.length; x++){ |
|
aargs[x] = args[x]; |
|
} |
|
|
|
var unrollAdvice = function(marr){ |
|
if(!marr){ |
|
dojo.debug("Null argument to unrollAdvice()"); |
|
return; |
|
} |
|
|
|
var callObj = marr[0]||dj_global; |
|
var callFunc = marr[1]; |
|
|
|
if(!callObj[callFunc]){ |
|
dojo.raise("function \"" + callFunc + "\" does not exist on \"" + callObj + "\""); |
|
} |
|
|
|
var aroundObj = marr[2]||dj_global; |
|
var aroundFunc = marr[3]; |
|
var msg = marr[6]; |
|
var maxCount = marr[7]; |
|
if(maxCount > -1){ |
|
if(maxCount == 0){ |
|
return; |
|
} |
|
marr[7]--; |
|
} |
|
var undef; |
|
|
|
var to = { |
|
args: [], |
|
jp_: this, |
|
object: obj, |
|
proceed: function(){ |
|
return callObj[callFunc].apply(callObj, to.args); |
|
} |
|
}; |
|
to.args = aargs; |
|
|
|
var delay = parseInt(marr[4]); |
|
var hasDelay = ((!isNaN(delay))&&(marr[4]!==null)&&(typeof marr[4] != "undefined")); |
|
if(marr[5]){ |
|
var rate = parseInt(marr[5]); |
|
var cur = new Date(); |
|
var timerSet = false; |
|
if((marr["last"])&&((cur-marr.last)<=rate)){ |
|
if(dojo.event._canTimeout){ |
|
if(marr["delayTimer"]){ |
|
clearTimeout(marr.delayTimer); |
|
} |
|
var tod = parseInt(rate*2); // is rate*2 naive? |
|
var mcpy = dojo.lang.shallowCopy(marr); |
|
marr.delayTimer = setTimeout(function(){ |
|
// FIXME: on IE at least, event objects from the |
|
// browser can go out of scope. How (or should?) we |
|
// deal with it? |
|
mcpy[5] = 0; |
|
unrollAdvice(mcpy); |
|
}, tod); |
|
} |
|
return; |
|
}else{ |
|
marr.last = cur; |
|
} |
|
} |
|
|
|
// FIXME: need to enforce rates for a connection here! |
|
|
|
if(aroundFunc){ |
|
// NOTE: around advice can't delay since we might otherwise depend |
|
// on execution order! |
|
aroundObj[aroundFunc].call(aroundObj, to); |
|
}else{ |
|
// var tmjp = dojo.event.MethodJoinPoint.getForMethod(obj, methname); |
|
if((hasDelay)&&((dojo.render.html)||(dojo.render.svg))){ // FIXME: the render checks are grotty! |
|
dj_global["setTimeout"](function(){ |
|
if(msg){ |
|
callObj[callFunc].call(callObj, to); |
|
}else{ |
|
callObj[callFunc].apply(callObj, args); |
|
} |
|
}, delay); |
|
}else{ // many environments can't support delay! |
|
if(msg){ |
|
callObj[callFunc].call(callObj, to); |
|
}else{ |
|
callObj[callFunc].apply(callObj, args); |
|
} |
|
} |
|
} |
|
}; |
|
|
|
var unRollSquelch = function(){ |
|
if(this.squelch){ |
|
try{ |
|
return unrollAdvice.apply(this, arguments); |
|
}catch(e){ |
|
dojo.debug(e); |
|
} |
|
}else{ |
|
return unrollAdvice.apply(this, arguments); |
|
} |
|
}; |
|
|
|
if((this["before"])&&(this.before.length>0)){ |
|
// pass a cloned array, if this event disconnects this event forEach on this.before wont work |
|
dojo.lang.forEach(this.before.concat(new Array()), unRollSquelch); |
|
} |
|
|
|
var result; |
|
try{ |
|
if((this["around"])&&(this.around.length>0)){ |
|
var mi = new dojo.event.MethodInvocation(this, obj, args); |
|
result = mi.proceed(); |
|
}else if(this.methodfunc){ |
|
result = this.object[this.methodname].apply(this.object, args); |
|
} |
|
}catch(e){ |
|
if(!this.squelch){ |
|
dojo.debug(e,"when calling",this.methodname,"on",this.object,"with arguments",args); |
|
dojo.raise(e); |
|
} |
|
} |
|
|
|
if((this["after"])&&(this.after.length>0)){ |
|
// see comment on this.before above |
|
dojo.lang.forEach(this.after.concat(new Array()), unRollSquelch); |
|
} |
|
|
|
return (this.methodfunc) ? result : null; |
|
}, |
|
|
|
getArr: function(/*String*/kind){ |
|
// summary: return a list of listeners of the past "kind" |
|
// kind: |
|
// can be one of: "before", "after", "around", "before-around", or |
|
// "after-around" |
|
var type = "after"; |
|
// FIXME: we should be able to do this through props or Array.in() |
|
if((typeof kind == "string")&&(kind.indexOf("before")!=-1)){ |
|
type = "before"; |
|
}else if(kind=="around"){ |
|
type = "around"; |
|
} |
|
if(!this[type]){ this[type] = []; } |
|
return this[type]; // Array |
|
}, |
|
|
|
kwAddAdvice: function(/*Object*/args){ |
|
// summary: |
|
// adds advice to the joinpoint with arguments in a map |
|
// args: |
|
// An object that can have the following properties: |
|
// - adviceType |
|
// - adviceObj |
|
// - adviceFunc |
|
// - aroundObj |
|
// - aroundFunc |
|
// - once |
|
// - delay |
|
// - rate |
|
// - adviceMsg |
|
// - maxCalls |
|
this.addAdvice( args["adviceObj"], args["adviceFunc"], |
|
args["aroundObj"], args["aroundFunc"], |
|
args["adviceType"], args["precedence"], |
|
args["once"], args["delay"], args["rate"], |
|
args["adviceMsg"], args["maxCalls"]); |
|
}, |
|
|
|
addAdvice: function( thisAdviceObj, thisAdvice, |
|
thisAroundObj, thisAround, |
|
adviceType, precedence, |
|
once, delay, rate, asMessage, |
|
maxCalls){ |
|
// summary: |
|
// add advice to this joinpoint using positional parameters |
|
// thisAdviceObj: |
|
// the scope in which to locate/execute the named adviceFunc. |
|
// thisAdviceFunc: |
|
// the name of the function being conected |
|
// thisAroundObj: |
|
// the scope in which to locate/execute the named aroundFunc. |
|
// thisAroundFunc: |
|
// the name of the function that will be used to mediate the |
|
// advice call. |
|
// adviceType: |
|
// Optional. String. One of "before", "after", "around", |
|
// "before-around", or "after-around". FIXME |
|
// once: |
|
// boolean that determines whether or not this advice will create |
|
// a new connection if an identical advice set has already been |
|
// provided. Defaults to "false". |
|
// delay: |
|
// an optional delay (in ms), as an integer, for dispatch of a |
|
// listener after the source has been fired. |
|
// rate: |
|
// an optional rate throttling parameter (integer, in ms). When |
|
// specified, this particular connection will not fire more than |
|
// once in the interval specified by the rate |
|
// adviceMsg: |
|
// boolean. Should the listener have all the parameters passed in |
|
// as a single argument? |
|
// maxCalls: |
|
// Integer. The maximum number of times this connection can be |
|
// used before being auto-disconnected. -1 signals that the |
|
// connection should never be disconnected. |
|
var arr = this.getArr(adviceType); |
|
if(!arr){ |
|
dojo.raise("bad this: " + this); |
|
} |
|
|
|
var ao = [thisAdviceObj, thisAdvice, thisAroundObj, thisAround, delay, rate, asMessage, maxCalls]; |
|
|
|
if(once){ |
|
if(this.hasAdvice(thisAdviceObj, thisAdvice, adviceType, arr) >= 0){ |
|
return; |
|
} |
|
} |
|
|
|
if(precedence == "first"){ |
|
arr.unshift(ao); |
|
}else{ |
|
arr.push(ao); |
|
} |
|
}, |
|
|
|
hasAdvice: function(thisAdviceObj, thisAdvice, adviceType, arr){ |
|
// summary: |
|
// returns the array index of the first existing connection |
|
// betweened the passed advice and this joinpoint. Will be -1 if |
|
// none exists. |
|
// thisAdviceObj: |
|
// the scope in which to locate/execute the named adviceFunc. |
|
// thisAdviceFunc: |
|
// the name of the function being conected |
|
// adviceType: |
|
// Optional. String. One of "before", "after", "around", |
|
// "before-around", or "after-around". FIXME |
|
// arr: |
|
// Optional. The list of advices to search. Will be found via |
|
// adviceType if not passed |
|
if(!arr){ arr = this.getArr(adviceType); } |
|
var ind = -1; |
|
for(var x=0; x<arr.length; x++){ |
|
var aao = (typeof thisAdvice == "object") ? (new String(thisAdvice)).toString() : thisAdvice; |
|
var a1o = (typeof arr[x][1] == "object") ? (new String(arr[x][1])).toString() : arr[x][1]; |
|
if((arr[x][0] == thisAdviceObj)&&(a1o == aao)){ |
|
ind = x; |
|
} |
|
} |
|
return ind; // Integer |
|
}, |
|
|
|
removeAdvice: function(thisAdviceObj, thisAdvice, adviceType, once){ |
|
// summary: |
|
// returns the array index of the first existing connection |
|
// betweened the passed advice and this joinpoint. Will be -1 if |
|
// none exists. |
|
// thisAdviceObj: |
|
// the scope in which to locate/execute the named adviceFunc. |
|
// thisAdviceFunc: |
|
// the name of the function being conected |
|
// adviceType: |
|
// Optional. String. One of "before", "after", "around", |
|
// "before-around", or "after-around". FIXME |
|
// once: |
|
// Optional. Should this only remove the first occurance of the |
|
// connection? |
|
var arr = this.getArr(adviceType); |
|
var ind = this.hasAdvice(thisAdviceObj, thisAdvice, adviceType, arr); |
|
if(ind == -1){ |
|
return false; |
|
} |
|
while(ind != -1){ |
|
arr.splice(ind, 1); |
|
if(once){ break; } |
|
ind = this.hasAdvice(thisAdviceObj, thisAdvice, adviceType, arr); |
|
} |
|
return true; |
|
} |
|
}); |
|
|
|
|
|
dojo.provide("dojo.event.topic"); |
|
|
|
dojo.event.topic = new function(){ |
|
this.topics = {}; |
|
|
|
this.getTopic = function(/*String*/topic){ |
|
// summary: |
|
// returns a topic implementation object of type |
|
// dojo.event.topic.TopicImpl |
|
// topic: |
|
// a unique, opaque string that names the topic |
|
if(!this.topics[topic]){ |
|
this.topics[topic] = new this.TopicImpl(topic); |
|
} |
|
return this.topics[topic]; // a dojo.event.topic.TopicImpl object |
|
} |
|
|
|
this.registerPublisher = function(/*String*/topic, /*Object*/obj, /*String*/funcName){ |
|
// summary: |
|
// registers a function as a publisher on a topic. Subsequent |
|
// calls to the function will cause a publish event on the topic |
|
// with the arguments passed to the function passed to registered |
|
// listeners. |
|
// topic: |
|
// a unique, opaque string that names the topic |
|
// obj: |
|
// the scope to locate the function in |
|
// funcName: |
|
// the name of the function to register |
|
var topic = this.getTopic(topic); |
|
topic.registerPublisher(obj, funcName); |
|
} |
|
|
|
this.subscribe = function(/*String*/topic, /*Object*/obj, /*String*/funcName){ |
|
// summary: |
|
// susbscribes the function to the topic. Subsequent events |
|
// dispached to the topic will create a function call for the |
|
// obj.funcName() function. |
|
// topic: |
|
// a unique, opaque string that names the topic |
|
// obj: |
|
// the scope to locate the function in |
|
// funcName: |
|
// the name of the function to being registered as a listener |
|
var topic = this.getTopic(topic); |
|
topic.subscribe(obj, funcName); |
|
} |
|
|
|
this.unsubscribe = function(/*String*/topic, /*Object*/obj, /*String*/funcName){ |
|
// summary: |
|
// unsubscribes the obj.funcName() from the topic |
|
// topic: |
|
// a unique, opaque string that names the topic |
|
// obj: |
|
// the scope to locate the function in |
|
// funcName: |
|
// the name of the function to being unregistered as a listener |
|
var topic = this.getTopic(topic); |
|
topic.unsubscribe(obj, funcName); |
|
} |
|
|
|
this.destroy = function(/*String*/topic){ |
|
// summary: |
|
// destroys the topic and unregisters all listeners |
|
// topic: |
|
// a unique, opaque string that names the topic |
|
this.getTopic(topic).destroy(); |
|
delete this.topics[topic]; |
|
} |
|
|
|
this.publishApply = function(/*String*/topic, /*Array*/args){ |
|
// summary: |
|
// dispatches an event to the topic using the args array as the |
|
// source for the call arguments to each listener. This is similar |
|
// to JavaScript's built-in Function.apply() |
|
// topic: |
|
// a unique, opaque string that names the topic |
|
// args: |
|
// the arguments to be passed into listeners of the topic |
|
var topic = this.getTopic(topic); |
|
topic.sendMessage.apply(topic, args); |
|
} |
|
|
|
this.publish = function(/*String*/topic, /*Object*/message){ |
|
// summary: |
|
// manually "publish" to the passed topic |
|
// topic: |
|
// a unique, opaque string that names the topic |
|
// message: |
|
// can be an array of parameters (similar to publishApply), or |
|
// will be treated as one of many arguments to be passed along in |
|
// a "flat" unrolling |
|
var topic = this.getTopic(topic); |
|
// if message is an array, we treat it as a set of arguments, |
|
// otherwise, we just pass on the arguments passed in as-is |
|
var args = []; |
|
// could we use concat instead here? |
|
for(var x=1; x<arguments.length; x++){ |
|
args.push(arguments[x]); |
|
} |
|
topic.sendMessage.apply(topic, args); |
|
} |
|
} |
|
|
|
dojo.event.topic.TopicImpl = function(topicName){ |
|
// summary: a class to represent topics |
|
|
|
this.topicName = topicName; |
|
|
|
this.subscribe = function(/*Object*/listenerObject, /*Function or String*/listenerMethod){ |
|
// summary: |
|
// use dojo.event.connect() to attach the passed listener to the |
|
// topic represented by this object |
|
// listenerObject: |
|
// if a string and listenerMethod is ommitted, this is treated as |
|
// the name of a function in the global namespace. If |
|
// listenerMethod is provided, this is the scope to find/execute |
|
// the function in. |
|
// listenerMethod: |
|
// Optional. The function to register. |
|
var tf = listenerMethod||listenerObject; |
|
var to = (!listenerMethod) ? dj_global : listenerObject; |
|
return dojo.event.kwConnect({ // dojo.event.MethodJoinPoint |
|
srcObj: this, |
|
srcFunc: "sendMessage", |
|
adviceObj: to, |
|
adviceFunc: tf |
|
}); |
|
} |
|
|
|
this.unsubscribe = function(/*Object*/listenerObject, /*Function or String*/listenerMethod){ |
|
// summary: |
|
// use dojo.event.disconnect() to attach the passed listener to the |
|
// topic represented by this object |
|
// listenerObject: |
|
// if a string and listenerMethod is ommitted, this is treated as |
|
// the name of a function in the global namespace. If |
|
// listenerMethod is provided, this is the scope to find the |
|
// function in. |
|
// listenerMethod: |
|
// Optional. The function to unregister. |
|
var tf = (!listenerMethod) ? listenerObject : listenerMethod; |
|
var to = (!listenerMethod) ? null : listenerObject; |
|
return dojo.event.kwDisconnect({ // dojo.event.MethodJoinPoint |
|
srcObj: this, |
|
srcFunc: "sendMessage", |
|
adviceObj: to, |
|
adviceFunc: tf |
|
}); |
|
} |
|
|
|
this._getJoinPoint = function(){ |
|
return dojo.event.MethodJoinPoint.getForMethod(this, "sendMessage"); |
|
} |
|
|
|
this.setSquelch = function(/*Boolean*/shouldSquelch){ |
|
// summary: |
|
// determine whether or not exceptions in the calling of a |
|
// listener in the chain should stop execution of the chain. |
|
this._getJoinPoint().squelch = shouldSquelch; |
|
} |
|
|
|
this.destroy = function(){ |
|
// summary: disconnects all listeners from this topic |
|
this._getJoinPoint().disconnect(); |
|
} |
|
|
|
this.registerPublisher = function( /*Object*/publisherObject, |
|
/*Function or String*/publisherMethod){ |
|
// summary: |
|
// registers the passed function as a publisher on this topic. |
|
// Each time the function is called, an event will be published on |
|
// this topic. |
|
// publisherObject: |
|
// if a string and listenerMethod is ommitted, this is treated as |
|
// the name of a function in the global namespace. If |
|
// listenerMethod is provided, this is the scope to find the |
|
// function in. |
|
// publisherMethod: |
|
// Optional. The function to register. |
|
dojo.event.connect(publisherObject, publisherMethod, this, "sendMessage"); |
|
} |
|
|
|
this.sendMessage = function(message){ |
|
// summary: a stub to be called when a message is sent to the topic. |
|
|
|
// The message has been propagated |
|
} |
|
} |
|
|
|
|
|
dojo.provide("dojo.event.browser"); |
|
|
|
|
|
// FIXME: any particular reason this is in the global scope? |
|
dojo._ie_clobber = new function(){ |
|
this.clobberNodes = []; |
|
|
|
function nukeProp(node, prop){ |
|
// try{ node.removeAttribute(prop); }catch(e){ /* squelch */ } |
|
try{ node[prop] = null; }catch(e){ /* squelch */ } |
|
try{ delete node[prop]; }catch(e){ /* squelch */ } |
|
// FIXME: JotLive needs this, but I'm not sure if it's too slow or not |
|
try{ node.removeAttribute(prop); }catch(e){ /* squelch */ } |
|
} |
|
|
|
this.clobber = function(nodeRef){ |
|
var na; |
|
var tna; |
|
if(nodeRef){ |
|
tna = nodeRef.all || nodeRef.getElementsByTagName("*"); |
|
na = [nodeRef]; |
|
for(var x=0; x<tna.length; x++){ |
|
// if we're gonna be clobbering the thing, at least make sure |
|
// we aren't trying to do it twice |
|
if(tna[x]["__doClobber__"]){ |
|
na.push(tna[x]); |
|
} |
|
} |
|
}else{ |
|
try{ window.onload = null; }catch(e){} |
|
na = (this.clobberNodes.length) ? this.clobberNodes : document.all; |
|
} |
|
tna = null; |
|
var basis = {}; |
|
for(var i = na.length-1; i>=0; i=i-1){ |
|
var el = na[i]; |
|
try{ |
|
if(el && el["__clobberAttrs__"]){ |
|
for(var j=0; j<el.__clobberAttrs__.length; j++){ |
|
nukeProp(el, el.__clobberAttrs__[j]); |
|
} |
|
nukeProp(el, "__clobberAttrs__"); |
|
nukeProp(el, "__doClobber__"); |
|
} |
|
}catch(e){ /* squelch! */}; |
|
} |
|
na = null; |
|
} |
|
} |
|
|
|
if(dojo.render.html.ie){ |
|
dojo.addOnUnload(function(){ |
|
dojo._ie_clobber.clobber(); |
|
try{ |
|
if((dojo["widget"])&&(dojo.widget["manager"])){ |
|
dojo.widget.manager.destroyAll(); |
|
} |
|
}catch(e){} |
|
|
|
// Workaround for IE leak recommended in ticket #1727 by schallm |
|
if(dojo.widget){ |
|
for(var name in dojo.widget._templateCache){ |
|
if(dojo.widget._templateCache[name].node){ |
|
dojo.dom.destroyNode(dojo.widget._templateCache[name].node); |
|
dojo.widget._templateCache[name].node = null; |
|
delete dojo.widget._templateCache[name].node; |
|
} |
|
} |
|
} |
|
|
|
try{ window.onload = null; }catch(e){} |
|
try{ window.onunload = null; }catch(e){} |
|
dojo._ie_clobber.clobberNodes = []; |
|
// CollectGarbage(); |
|
}); |
|
} |
|
|
|
dojo.event.browser = new function(){ |
|
|
|
var clobberIdx = 0; |
|
|
|
this.normalizedEventName = function(/*String*/eventName){ |
|
switch(eventName){ |
|
case "CheckboxStateChange": |
|
case "DOMAttrModified": |
|
case "DOMMenuItemActive": |
|
case "DOMMenuItemInactive": |
|
case "DOMMouseScroll": |
|
case "DOMNodeInserted": |
|
case "DOMNodeRemoved": |
|
case "RadioStateChange": |
|
return eventName; |
|
break; |
|
default: |
|
var lcn = eventName.toLowerCase(); |
|
return (lcn.indexOf("on") == 0) ? lcn.substr(2) : lcn; |
|
break; |
|
} |
|
} |
|
|
|
this.clean = function(/*DOMNode*/node){ |
|
// summary: |
|
// removes native event handlers so that destruction of the node |
|
// will not leak memory. On most browsers this is a no-op, but |
|
// it's critical for manual node removal on IE. |
|
// node: |
|
// A DOM node. All of it's children will also be cleaned. |
|
if(dojo.render.html.ie){ |
|
dojo._ie_clobber.clobber(node); |
|
} |
|
} |
|
|
|
this.addClobberNode = function(/*DOMNode*/node){ |
|
// summary: |
|
// register the passed node to support event stripping |
|
// node: |
|
// A DOM node |
|
if(!dojo.render.html.ie){ return; } |
|
if(!node["__doClobber__"]){ |
|
node.__doClobber__ = true; |
|
dojo._ie_clobber.clobberNodes.push(node); |
|
// this might not be the most efficient thing to do, but it's |
|
// much less error prone than other approaches which were |
|
// previously tried and failed |
|
node.__clobberAttrs__ = []; |
|
} |
|
} |
|
|
|
this.addClobberNodeAttrs = function(/*DOMNode*/node, /*Array*/props){ |
|
// summary: |
|
// register the passed node to support event stripping |
|
// node: |
|
// A DOM node to stip properties from later |
|
// props: |
|
// A list of propeties to strip from the node |
|
if(!dojo.render.html.ie){ return; } |
|
this.addClobberNode(node); |
|
for(var x=0; x<props.length; x++){ |
|
node.__clobberAttrs__.push(props[x]); |
|
} |
|
} |
|
|
|
this.removeListener = function( /*DOMNode*/ node, |
|
/*String*/ evtName, |
|
/*Function*/fp, |
|
/*Boolean*/ capture){ |
|
// summary: |
|
// clobbers the listener from the node |
|
// evtName: |
|
// the name of the handler to remove the function from |
|
// node: |
|
// DOM node to attach the event to |
|
// fp: |
|
// the function to register |
|
// capture: |
|
// Optional. should this listener prevent propigation? |
|
if(!capture){ var capture = false; } |
|
evtName = dojo.event.browser.normalizedEventName(evtName); |
|
if(evtName == "key"){ |
|
if(dojo.render.html.ie){ |
|
this.removeListener(node, "onkeydown", fp, capture); |
|
} |
|
evtName = "keypress"; |
|
} |
|
// FIXME: this is mostly a punt, we aren't actually doing anything on IE |
|
if(node.removeEventListener){ |
|
node.removeEventListener(evtName, fp, capture); |
|
} |
|
} |
|
|
|
this.addListener = function(/*DOMNode*/node, /*String*/evtName, /*Function*/fp, /*Boolean*/capture, /*Boolean*/dontFix){ |
|
// summary: |
|
// adds a listener to the node |
|
// evtName: |
|
// the name of the handler to add the listener to can be either of |
|
// the form "onclick" or "click" |
|
// node: |
|
// DOM node to attach the event to |
|
// fp: |
|
// the function to register |
|
// capture: |
|
// Optional. Should this listener prevent propigation? |
|
// dontFix: |
|
// Optional. Should we avoid registering a new closure around the |
|
// listener to enable fixEvent for dispatch of the registered |
|
// function? |
|
if(!node){ return; } // FIXME: log and/or bail? |
|
if(!capture){ var capture = false; } |
|
evtName = dojo.event.browser.normalizedEventName(evtName); |
|
if(evtName == "key"){ |
|
if(dojo.render.html.ie){ |
|
this.addListener(node, "onkeydown", fp, capture, dontFix); |
|
} |
|
evtName = "keypress"; |
|
} |
|
|
|
if(!dontFix){ |
|
// build yet another closure around fp in order to inject fixEvent |
|
// around the resulting event |
|
var newfp = function(evt){ |
|
if(!evt){ evt = window.event; } |
|
var ret = fp(dojo.event.browser.fixEvent(evt, this)); |
|
if(capture){ |
|
dojo.event.browser.stopEvent(evt); |
|
} |
|
return ret; |
|
} |
|
}else{ |
|
newfp = fp; |
|
} |
|
|
|
if(node.addEventListener){ |
|
node.addEventListener(evtName, newfp, capture); |
|
return newfp; |
|
}else{ |
|
evtName = "on"+evtName; |
|
if(typeof node[evtName] == "function" ){ |
|
var oldEvt = node[evtName]; |
|
node[evtName] = function(e){ |
|
oldEvt(e); |
|
return newfp(e); |
|
} |
|
}else{ |
|
node[evtName]=newfp; |
|
} |
|
if(dojo.render.html.ie){ |
|
this.addClobberNodeAttrs(node, [evtName]); |
|
} |
|
return newfp; |
|
} |
|
} |
|
|
|
this.isEvent = function(/*Object*/obj){ |
|
// summary: |
|
// Tries to determine whether or not the object is a DOM event. |
|
|
|
// FIXME: event detection hack ... could test for additional attributes |
|
// if necessary |
|
return (typeof obj != "undefined")&&(obj)&&(typeof Event != "undefined")&&(obj.eventPhase); // Boolean |
|
// Event does not support instanceof in Opera, otherwise: |
|
//return (typeof Event != "undefined")&&(obj instanceof Event); |
|
} |
|
|
|
this.currentEvent = null; |
|
|
|
this.callListener = function(/*Function*/listener, /*DOMNode*/curTarget){ |
|
// summary: |
|
// calls the specified listener in the context of the passed node |
|
// with the current DOM event object as the only parameter |
|
// listener: |
|
// the function to call |
|
// curTarget: |
|
// the Node to call the function in the scope of |
|
if(typeof listener != 'function'){ |
|
dojo.raise("listener not a function: " + listener); |
|
} |
|
dojo.event.browser.currentEvent.currentTarget = curTarget; |
|
return listener.call(curTarget, dojo.event.browser.currentEvent); |
|
} |
|
|
|
this._stopPropagation = function(){ |
|
dojo.event.browser.currentEvent.cancelBubble = true; |
|
} |
|
|
|
this._preventDefault = function(){ |
|
dojo.event.browser.currentEvent.returnValue = false; |
|
} |
|
|
|
this.keys = { |
|
KEY_BACKSPACE: 8, |
|
KEY_TAB: 9, |
|
KEY_CLEAR: 12, |
|
KEY_ENTER: 13, |
|
KEY_SHIFT: 16, |
|
KEY_CTRL: 17, |
|
KEY_ALT: 18, |
|
KEY_PAUSE: 19, |
|
KEY_CAPS_LOCK: 20, |
|
KEY_ESCAPE: 27, |
|
KEY_SPACE: 32, |
|
KEY_PAGE_UP: 33, |
|
KEY_PAGE_DOWN: 34, |
|
KEY_END: 35, |
|
KEY_HOME: 36, |
|
KEY_LEFT_ARROW: 37, |
|
KEY_UP_ARROW: 38, |
|
KEY_RIGHT_ARROW: 39, |
|
KEY_DOWN_ARROW: 40, |
|
KEY_INSERT: 45, |
|
KEY_DELETE: 46, |
|
KEY_HELP: 47, |
|
KEY_LEFT_WINDOW: 91, |
|
KEY_RIGHT_WINDOW: 92, |
|
KEY_SELECT: 93, |
|
KEY_NUMPAD_0: 96, |
|
KEY_NUMPAD_1: 97, |
|
KEY_NUMPAD_2: 98, |
|
KEY_NUMPAD_3: 99, |
|
KEY_NUMPAD_4: 100, |
|
KEY_NUMPAD_5: 101, |
|
KEY_NUMPAD_6: 102, |
|
KEY_NUMPAD_7: 103, |
|
KEY_NUMPAD_8: 104, |
|
KEY_NUMPAD_9: 105, |
|
KEY_NUMPAD_MULTIPLY: 106, |
|
KEY_NUMPAD_PLUS: 107, |
|
KEY_NUMPAD_ENTER: 108, |
|
KEY_NUMPAD_MINUS: 109, |
|
KEY_NUMPAD_PERIOD: 110, |
|
KEY_NUMPAD_DIVIDE: 111, |
|
KEY_F1: 112, |
|
KEY_F2: 113, |
|
KEY_F3: 114, |
|
KEY_F4: 115, |
|
KEY_F5: 116, |
|
KEY_F6: 117, |
|
KEY_F7: 118, |
|
KEY_F8: 119, |
|
KEY_F9: 120, |
|
KEY_F10: 121, |
|
KEY_F11: 122, |
|
KEY_F12: 123, |
|
KEY_F13: 124, |
|
KEY_F14: 125, |
|
KEY_F15: 126, |
|
KEY_NUM_LOCK: 144, |
|
KEY_SCROLL_LOCK: 145 |
|
}; |
|
|
|
// reverse lookup |
|
this.revKeys = []; |
|
for(var key in this.keys){ |
|
this.revKeys[this.keys[key]] = key; |
|
} |
|
|
|
this.fixEvent = function(/*Event*/evt, /*DOMNode*/sender){ |
|
// summary: |
|
// normalizes properties on the event object including event |
|
// bubbling methods, keystroke normalization, and x/y positions |
|
// evt: the native event object |
|
// sender: the node to treat as "currentTarget" |
|
if(!evt){ |
|
if(window["event"]){ |
|
evt = window.event; |
|
} |
|
} |
|
|
|
if((evt["type"])&&(evt["type"].indexOf("key") == 0)){ // key events |
|
evt.keys = this.revKeys; |
|
// FIXME: how can we eliminate this iteration? |
|
for(var key in this.keys){ |
|
evt[key] = this.keys[key]; |
|
} |
|
if(evt["type"] == "keydown" && dojo.render.html.ie){ |
|
switch(evt.keyCode){ |
|
case evt.KEY_SHIFT: |
|
case evt.KEY_CTRL: |
|
case evt.KEY_ALT: |
|
case evt.KEY_CAPS_LOCK: |
|
case evt.KEY_LEFT_WINDOW: |
|
case evt.KEY_RIGHT_WINDOW: |
|
case evt.KEY_SELECT: |
|
case evt.KEY_NUM_LOCK: |
|
case evt.KEY_SCROLL_LOCK: |
|
// I'll get these in keypress after the OS munges them based on numlock |
|
case evt.KEY_NUMPAD_0: |
|
case evt.KEY_NUMPAD_1: |
|
case evt.KEY_NUMPAD_2: |
|
case evt.KEY_NUMPAD_3: |
|
case evt.KEY_NUMPAD_4: |
|
case evt.KEY_NUMPAD_5: |
|
case evt.KEY_NUMPAD_6: |
|
case evt.KEY_NUMPAD_7: |
|
case evt.KEY_NUMPAD_8: |
|
case evt.KEY_NUMPAD_9: |
|
case evt.KEY_NUMPAD_PERIOD: |
|
break; // just ignore the keys that can morph |
|
case evt.KEY_NUMPAD_MULTIPLY: |
|
case evt.KEY_NUMPAD_PLUS: |
|
case evt.KEY_NUMPAD_ENTER: |
|
case evt.KEY_NUMPAD_MINUS: |
|
case evt.KEY_NUMPAD_DIVIDE: |
|
break; // I could handle these but just pick them up in keypress |
|
case evt.KEY_PAUSE: |
|
case evt.KEY_TAB: |
|
case evt.KEY_BACKSPACE: |
|
case evt.KEY_ENTER: |
|
case evt.KEY_ESCAPE: |
|
case evt.KEY_PAGE_UP: |
|
case evt.KEY_PAGE_DOWN: |
|
case evt.KEY_END: |
|
case evt.KEY_HOME: |
|
case evt.KEY_LEFT_ARROW: |
|
case evt.KEY_UP_ARROW: |
|
case evt.KEY_RIGHT_ARROW: |
|
case evt.KEY_DOWN_ARROW: |
|
case evt.KEY_INSERT: |
|
case evt.KEY_DELETE: |
|
case evt.KEY_F1: |
|
case evt.KEY_F2: |
|
case evt.KEY_F3: |
|
case evt.KEY_F4: |
|
case evt.KEY_F5: |
|
case evt.KEY_F6: |
|
case evt.KEY_F7: |
|
case evt.KEY_F8: |
|
case evt.KEY_F9: |
|
case evt.KEY_F10: |
|
case evt.KEY_F11: |
|
case evt.KEY_F12: |
|
case evt.KEY_F12: |
|
case evt.KEY_F13: |
|
case evt.KEY_F14: |
|
case evt.KEY_F15: |
|
case evt.KEY_CLEAR: |
|
case evt.KEY_HELP: |
|
evt.key = evt.keyCode; |
|
break; |
|
default: |
|
if(evt.ctrlKey || evt.altKey){ |
|
var unifiedCharCode = evt.keyCode; |
|
// if lower case but keycode is uppercase, convert it |
|
if(unifiedCharCode >= 65 && unifiedCharCode <= 90 && evt.shiftKey == false){ |
|
unifiedCharCode += 32; |
|
} |
|
if(unifiedCharCode >= 1 && unifiedCharCode <= 26 && evt.ctrlKey){ |
|
unifiedCharCode += 96; // 001-032 = ctrl+[a-z] |
|
} |
|
evt.key = String.fromCharCode(unifiedCharCode); |
|
} |
|
} |
|
} else if(evt["type"] == "keypress"){ |
|
if(dojo.render.html.opera){ |
|
if(evt.which == 0){ |
|
evt.key = evt.keyCode; |
|
}else if(evt.which > 0){ |
|
switch(evt.which){ |
|
case evt.KEY_SHIFT: |
|
case evt.KEY_CTRL: |
|
case evt.KEY_ALT: |
|
case evt.KEY_CAPS_LOCK: |
|
case evt.KEY_NUM_LOCK: |
|
case evt.KEY_SCROLL_LOCK: |
|
break; |
|
case evt.KEY_PAUSE: |
|
case evt.KEY_TAB: |
|
case evt.KEY_BACKSPACE: |
|
case evt.KEY_ENTER: |
|
case evt.KEY_ESCAPE: |
|
evt.key = evt.which; |
|
break; |
|
default: |
|
var unifiedCharCode = evt.which; |
|
if((evt.ctrlKey || evt.altKey || evt.metaKey) && (evt.which >= 65 && evt.which <= 90 && evt.shiftKey == false)){ |
|
unifiedCharCode += 32; |
|
} |
|
evt.key = String.fromCharCode(unifiedCharCode); |
|
} |
|
} |
|
}else if(dojo.render.html.ie){ // catch some IE keys that are hard to get in keyDown |
|
// key combinations were handled in onKeyDown |
|
if(!evt.ctrlKey && !evt.altKey && evt.keyCode >= evt.KEY_SPACE){ |
|
evt.key = String.fromCharCode(evt.keyCode); |
|
} |
|
}else if(dojo.render.html.safari){ |
|
switch(evt.keyCode){ |
|
case 25: evt.key = evt.KEY_TAB; evt.shift = true;break; |
|
case 63232: evt.key = evt.KEY_UP_ARROW; break; |
|
case 63233: evt.key = evt.KEY_DOWN_ARROW; break; |
|
case 63234: evt.key = evt.KEY_LEFT_ARROW; break; |
|
case 63235: evt.key = evt.KEY_RIGHT_ARROW; break; |
|
case 63236: evt.key = evt.KEY_F1; break; |
|
case 63237: evt.key = evt.KEY_F2; break; |
|
case 63238: evt.key = evt.KEY_F3; break; |
|
case 63239: evt.key = evt.KEY_F4; break; |
|
case 63240: evt.key = evt.KEY_F5; break; |
|
case 63241: evt.key = evt.KEY_F6; break; |
|
case 63242: evt.key = evt.KEY_F7; break; |
|
case 63243: evt.key = evt.KEY_F8; break; |
|
case 63244: evt.key = evt.KEY_F9; break; |
|
case 63245: evt.key = evt.KEY_F10; break; |
|
case 63246: evt.key = evt.KEY_F11; break; |
|
case 63247: evt.key = evt.KEY_F12; break; |
|
case 63250: evt.key = evt.KEY_PAUSE; break; |
|
case 63272: evt.key = evt.KEY_DELETE; break; |
|
case 63273: evt.key = evt.KEY_HOME; break; |
|
case 63275: evt.key = evt.KEY_END; break; |
|
case 63276: evt.key = evt.KEY_PAGE_UP; break; |
|
case 63277: evt.key = evt.KEY_PAGE_DOWN; break; |
|
case 63302: evt.key = evt.KEY_INSERT; break; |
|
case 63248://prtscr |
|
case 63249://scrolllock |
|
case 63289://numlock |
|
break; |
|
default: |
|
evt.key = evt.charCode >= evt.KEY_SPACE ? String.fromCharCode(evt.charCode) : evt.keyCode; |
|
} |
|
}else{ |
|
evt.key = evt.charCode > 0 ? String.fromCharCode(evt.charCode) : evt.keyCode; |
|
} |
|
} |
|
} |
|
if(dojo.render.html.ie){ |
|
if(!evt.target){ evt.target = evt.srcElement; } |
|
if(!evt.currentTarget){ evt.currentTarget = (sender ? sender : evt.srcElement); } |
|
if(!evt.layerX){ evt.layerX = evt.offsetX; } |
|
if(!evt.layerY){ evt.layerY = evt.offsetY; } |
|
// FIXME: scroll position query is duped from dojo.html to avoid dependency on that entire module |
|
// DONOT replace the following to use dojo.body(), in IE, document.documentElement should be used |
|
// here rather than document.body |
|
var doc = (evt.srcElement && evt.srcElement.ownerDocument) ? evt.srcElement.ownerDocument : document; |
|
var docBody = ((dojo.render.html.ie55)||(doc["compatMode"] == "BackCompat")) ? doc.body : doc.documentElement; |
|
if(!evt.pageX){ evt.pageX = evt.clientX + (docBody.scrollLeft || 0) } |
|
if(!evt.pageY){ evt.pageY = evt.clientY + (docBody.scrollTop || 0) } |
|
// mouseover |
|
if(evt.type == "mouseover"){ evt.relatedTarget = evt.fromElement; } |
|
// mouseout |
|
if(evt.type == "mouseout"){ evt.relatedTarget = evt.toElement; } |
|
this.currentEvent = evt; |
|
evt.callListener = this.callListener; |
|
evt.stopPropagation = this._stopPropagation; |
|
evt.preventDefault = this._preventDefault; |
|
} |
|
return evt; // Event |
|
} |
|
|
|
this.stopEvent = function(/*Event*/evt){ |
|
// summary: |
|
// prevents propigation and clobbers the default action of the |
|
// passed event |
|
// evt: Optional for IE. The native event object. |
|
if(window.event){ |
|
evt.cancelBubble = true; |
|
evt.returnValue = false; |
|
}else{ |
|
evt.preventDefault(); |
|
evt.stopPropagation(); |
|
} |
|
} |
|
} |
|
|
|
dojo.kwCompoundRequire({ |
|
common: ["dojo.event.common", "dojo.event.topic"], |
|
browser: ["dojo.event.browser"], |
|
dashboard: ["dojo.event.browser"] |
|
}); |
|
dojo.provide("dojo.event.*"); |
|
|
|
dojo.provide("dojo.gfx.color"); |
|
|
|
|
|
|
|
// TODO: rewrite the "x2y" methods to take advantage of the parsing |
|
// abilities of the Color object. Also, beef up the Color |
|
// object (as possible) to parse most common formats |
|
|
|
// takes an r, g, b, a(lpha) value, [r, g, b, a] array, "rgb(...)" string, hex string (#aaa, #aaaaaa, aaaaaaa) |
|
dojo.gfx.color.Color = function(r, g, b, a) { |
|
// dojo.debug("r:", r[0], "g:", r[1], "b:", r[2]); |
|
if(dojo.lang.isArray(r)){ |
|
this.r = r[0]; |
|
this.g = r[1]; |
|
this.b = r[2]; |
|
this.a = r[3]||1.0; |
|
}else if(dojo.lang.isString(r)){ |
|
var rgb = dojo.gfx.color.extractRGB(r); |
|
this.r = rgb[0]; |
|
this.g = rgb[1]; |
|
this.b = rgb[2]; |
|
this.a = g||1.0; |
|
}else if(r instanceof dojo.gfx.color.Color){ |
|
// why does this create a new instance if we were passed one? |
|
this.r = r.r; |
|
this.b = r.b; |
|
this.g = r.g; |
|
this.a = r.a; |
|
}else{ |
|
this.r = r; |
|
this.g = g; |
|
this.b = b; |
|
this.a = a; |
|
} |
|
} |
|
|
|
dojo.gfx.color.Color.fromArray = function(arr) { |
|
return new dojo.gfx.color.Color(arr[0], arr[1], arr[2], arr[3]); |
|
} |
|
|
|
dojo.extend(dojo.gfx.color.Color, { |
|
toRgb: function(includeAlpha) { |
|
if(includeAlpha) { |
|
return this.toRgba(); |
|
} else { |
|
return [this.r, this.g, this.b]; |
|
} |
|
}, |
|
toRgba: function() { |
|
return [this.r, this.g, this.b, this.a]; |
|
}, |
|
toHex: function() { |
|
return dojo.gfx.color.rgb2hex(this.toRgb()); |
|
}, |
|
toCss: function() { |
|
return "rgb(" + this.toRgb().join() + ")"; |
|
}, |
|
toString: function() { |
|
return this.toHex(); // decent default? |
|
}, |
|
blend: function(color, weight){ |
|
var rgb = null; |
|
if(dojo.lang.isArray(color)){ |
|
rgb = color; |
|
}else if(color instanceof dojo.gfx.color.Color){ |
|
rgb = color.toRgb(); |
|
}else{ |
|
rgb = new dojo.gfx.color.Color(color).toRgb(); |
|
} |
|
return dojo.gfx.color.blend(this.toRgb(), rgb, weight); |
|
} |
|
}); |
|
|
|
dojo.gfx.color.named = { |
|
white: [255,255,255], |
|
black: [0,0,0], |
|
red: [255,0,0], |
|
green: [0,255,0], |
|
lime: [0,255,0], |
|
blue: [0,0,255], |
|
navy: [0,0,128], |
|
gray: [128,128,128], |
|
silver: [192,192,192] |
|
}; |
|
|
|
dojo.gfx.color.blend = function(a, b, weight){ |
|
// summary: |
|
// blend colors a and b (both as RGB array or hex strings) with weight |
|
// from -1 to +1, 0 being a 50/50 blend |
|
if(typeof a == "string"){ |
|
return dojo.gfx.color.blendHex(a, b, weight); |
|
} |
|
if(!weight){ |
|
weight = 0; |
|
} |
|
weight = Math.min(Math.max(-1, weight), 1); |
|
|
|
// alex: this interface blows. |
|
// map -1 to 1 to the range 0 to 1 |
|
weight = ((weight + 1)/2); |
|
|
|
var c = []; |
|
|
|
// var stop = (1000*weight); |
|
for(var x = 0; x < 3; x++){ |
|
c[x] = parseInt( b[x] + ( (a[x] - b[x]) * weight) ); |
|
} |
|
return c; |
|
} |
|
|
|
// very convenient blend that takes and returns hex values |
|
// (will get called automatically by blend when blend gets strings) |
|
dojo.gfx.color.blendHex = function(a, b, weight) { |
|
return dojo.gfx.color.rgb2hex(dojo.gfx.color.blend(dojo.gfx.color.hex2rgb(a), dojo.gfx.color.hex2rgb(b), weight)); |
|
} |
|
|
|
// get RGB array from css-style color declarations |
|
dojo.gfx.color.extractRGB = function(color) { |
|
var hex = "0123456789abcdef"; |
|
color = color.toLowerCase(); |
|
if( color.indexOf("rgb") == 0 ) { |
|
var matches = color.match(/rgba*\((\d+), *(\d+), *(\d+)/i); |
|
var ret = matches.splice(1, 3); |
|
return ret; |
|
} else { |
|
var colors = dojo.gfx.color.hex2rgb(color); |
|
if(colors) { |
|
return colors; |
|
} else { |
|
// named color (how many do we support?) |
|
return dojo.gfx.color.named[color] || [255, 255, 255]; |
|
} |
|
} |
|
} |
|
|
|
dojo.gfx.color.hex2rgb = function(hex) { |
|
var hexNum = "0123456789ABCDEF"; |
|
var rgb = new Array(3); |
|
if( hex.indexOf("#") == 0 ) { hex = hex.substring(1); } |
|
hex = hex.toUpperCase(); |
|
if(hex.replace(new RegExp("["+hexNum+"]", "g"), "") != "") { |
|
return null; |
|
} |
|
if( hex.length == 3 ) { |
|
rgb[0] = hex.charAt(0) + hex.charAt(0) |
|
rgb[1] = hex.charAt(1) + hex.charAt(1) |
|
rgb[2] = hex.charAt(2) + hex.charAt(2); |
|
} else { |
|
rgb[0] = hex.substring(0, 2); |
|
rgb[1] = hex.substring(2, 4); |
|
rgb[2] = hex.substring(4); |
|
} |
|
for(var i = 0; i < rgb.length; i++) { |
|
rgb[i] = hexNum.indexOf(rgb[i].charAt(0)) * 16 + hexNum.indexOf(rgb[i].charAt(1)); |
|
} |
|
return rgb; |
|
} |
|
|
|
dojo.gfx.color.rgb2hex = function(r, g, b) { |
|
if(dojo.lang.isArray(r)) { |
|
g = r[1] || 0; |
|
b = r[2] || 0; |
|
r = r[0] || 0; |
|
} |
|
var ret = dojo.lang.map([r, g, b], function(x) { |
|
x = new Number(x); |
|
var s = x.toString(16); |
|
while(s.length < 2) { s = "0" + s; } |
|
return s; |
|
}); |
|
ret.unshift("#"); |
|
return ret.join(""); |
|
} |
|
|
|
dojo.provide("dojo.lfx.Animation"); |
|
|
|
|
|
|
|
/* |
|
Animation package based on Dan Pupius' work: http://pupius.co.uk/js/Toolkit.Drawing.js |
|
*/ |
|
dojo.lfx.Line = function(/*int*/ start, /*int*/ end){ |
|
// summary: dojo.lfx.Line is the object used to generate values |
|
// from a start value to an end value |
|
this.start = start; |
|
this.end = end; |
|
if(dojo.lang.isArray(start)){ |
|
/* start: Array |
|
end: Array |
|
pId: a */ |
|
var diff = []; |
|
dojo.lang.forEach(this.start, function(s,i){ |
|
diff[i] = this.end[i] - s; |
|
}, this); |
|
|
|
this.getValue = function(/*float*/ n){ |
|
var res = []; |
|
dojo.lang.forEach(this.start, function(s, i){ |
|
res[i] = (diff[i] * n) + s; |
|
}, this); |
|
return res; // Array |
|
} |
|
}else{ |
|
var diff = end - start; |
|
|
|
this.getValue = function(/*float*/ n){ |
|
// summary: returns the point on the line |
|
// n: a floating point number greater than 0 and less than 1 |
|
return (diff * n) + this.start; // Decimal |
|
} |
|
} |
|
} |
|
|
|
if((dojo.render.html.khtml)&&(!dojo.render.html.safari)){ |
|
// the cool kids are obviously not using konqueror... |
|
// found a very wierd bug in floats constants, 1.5 evals as 1 |
|
// seems somebody mixed up ints and floats in 3.5.4 ?? |
|
// FIXME: investigate more and post a KDE bug (Fredrik) |
|
dojo.lfx.easeDefault = function(/*Decimal?*/ n){ |
|
// summary: Returns the point for point n on a sin wave. |
|
return (parseFloat("0.5")+((Math.sin( (n+parseFloat("1.5")) * Math.PI))/2)); |
|
} |
|
}else{ |
|
dojo.lfx.easeDefault = function(/*Decimal?*/ n){ |
|
return (0.5+((Math.sin( (n+1.5) * Math.PI))/2)); |
|
} |
|
} |
|
|
|
dojo.lfx.easeIn = function(/*Decimal?*/ n){ |
|
// summary: returns the point on an easing curve |
|
// n: a floating point number greater than 0 and less than 1 |
|
return Math.pow(n, 3); |
|
} |
|
|
|
dojo.lfx.easeOut = function(/*Decimal?*/ n){ |
|
// summary: returns the point on the line |
|
// n: a floating point number greater than 0 and less than 1 |
|
return ( 1 - Math.pow(1 - n, 3) ); |
|
} |
|
|
|
dojo.lfx.easeInOut = function(/*Decimal?*/ n){ |
|
// summary: returns the point on the line |
|
// n: a floating point number greater than 0 and less than 1 |
|
return ( (3 * Math.pow(n, 2)) - (2 * Math.pow(n, 3)) ); |
|
} |
|
|
|
dojo.lfx.IAnimation = function(){ |
|
// summary: dojo.lfx.IAnimation is an interface that implements |
|
// commonly used functions of animation objects |
|
} |
|
dojo.lang.extend(dojo.lfx.IAnimation, { |
|
// public properties |
|
curve: null, |
|
duration: 1000, |
|
easing: null, |
|
repeatCount: 0, |
|
rate: 10, |
|
|
|
// events |
|
handler: null, |
|
beforeBegin: null, |
|
onBegin: null, |
|
onAnimate: null, |
|
onEnd: null, |
|
onPlay: null, |
|
onPause: null, |
|
onStop: null, |
|
|
|
// public methods |
|
play: null, |
|
pause: null, |
|
stop: null, |
|
|
|
connect: function(/*Event*/ evt, /*Object*/ scope, /*Function*/ newFunc){ |
|
// summary: Convenience function. Quickly connect to an event |
|
// of this object and save the old functions connected to it. |
|
// evt: The name of the event to connect to. |
|
// scope: the scope in which to run newFunc. |
|
// newFunc: the function to run when evt is fired. |
|
if(!newFunc){ |
|
/* scope: Function |
|
newFunc: null |
|
pId: f */ |
|
newFunc = scope; |
|
scope = this; |
|
} |
|
newFunc = dojo.lang.hitch(scope, newFunc); |
|
var oldFunc = this[evt]||function(){}; |
|
this[evt] = function(){ |
|
var ret = oldFunc.apply(this, arguments); |
|
newFunc.apply(this, arguments); |
|
return ret; |
|
} |
|
return this; // dojo.lfx.IAnimation |
|
}, |
|
|
|
fire: function(/*Event*/ evt, /*Array*/ args){ |
|
// summary: Convenience function. Fire event "evt" and pass it |
|
// the arguments specified in "args". |
|
// evt: The event to fire. |
|
// args: The arguments to pass to the event. |
|
if(this[evt]){ |
|
this[evt].apply(this, (args||[])); |
|
} |
|
return this; // dojo.lfx.IAnimation |
|
}, |
|
|
|
repeat: function(/*int*/ count){ |
|
// summary: Set the repeat count of this object. |
|
// count: How many times to repeat the animation. |
|
this.repeatCount = count; |
|
return this; // dojo.lfx.IAnimation |
|
}, |
|
|
|
// private properties |
|
_active: false, |
|
_paused: false |
|
}); |
|
|
|
dojo.lfx.Animation = function( /*Object*/ handlers, |
|
/*int*/ duration, |
|
/*dojo.lfx.Line*/ curve, |
|
/*function*/ easing, |
|
/*int*/ repeatCount, |
|
/*int*/ rate){ |
|
// summary |
|
// a generic animation object that fires callbacks into it's handlers |
|
// object at various states |
|
// handlers: { handler: Function?, onstart: Function?, onstop: Function?, onanimate: Function? } |
|
dojo.lfx.IAnimation.call(this); |
|
if(dojo.lang.isNumber(handlers)||(!handlers && duration.getValue)){ |
|
// no handlers argument: |
|
rate = repeatCount; |
|
repeatCount = easing; |
|
easing = curve; |
|
curve = duration; |
|
duration = handlers; |
|
handlers = null; |
|
}else if(handlers.getValue||dojo.lang.isArray(handlers)){ |
|
// no handlers or duration: |
|
rate = easing; |
|
repeatCount = curve; |
|
easing = duration; |
|
curve = handlers; |
|
duration = null; |
|
handlers = null; |
|
} |
|
if(dojo.lang.isArray(curve)){ |
|
/* curve: Array |
|
pId: a */ |
|
this.curve = new dojo.lfx.Line(curve[0], curve[1]); |
|
}else{ |
|
this.curve = curve; |
|
} |
|
if(duration != null && duration > 0){ this.duration = duration; } |
|
if(repeatCount){ this.repeatCount = repeatCount; } |
|
if(rate){ this.rate = rate; } |
|
if(handlers){ |
|
dojo.lang.forEach([ |
|
"handler", "beforeBegin", "onBegin", |
|
"onEnd", "onPlay", "onStop", "onAnimate" |
|
], function(item){ |
|
if(handlers[item]){ |
|
this.connect(item, handlers[item]); |
|
} |
|
}, this); |
|
} |
|
if(easing && dojo.lang.isFunction(easing)){ |
|
this.easing=easing; |
|
} |
|
} |
|
dojo.inherits(dojo.lfx.Animation, dojo.lfx.IAnimation); |
|
dojo.lang.extend(dojo.lfx.Animation, { |
|
// "private" properties |
|
_startTime: null, |
|
_endTime: null, |
|
_timer: null, |
|
_percent: 0, |
|
_startRepeatCount: 0, |
|
|
|
// public methods |
|
play: function(/*int?*/ delay, /*bool?*/ gotoStart){ |
|
// summary: Start the animation. |
|
// delay: How many milliseconds to delay before starting. |
|
// gotoStart: If true, starts the animation from the beginning; otherwise, |
|
// starts it from its current position. |
|
if(gotoStart){ |
|
clearTimeout(this._timer); |
|
this._active = false; |
|
this._paused = false; |
|
this._percent = 0; |
|
}else if(this._active && !this._paused){ |
|
return this; // dojo.lfx.Animation |
|
} |
|
|
|
this.fire("handler", ["beforeBegin"]); |
|
this.fire("beforeBegin"); |
|
|
|
if(delay > 0){ |
|
setTimeout(dojo.lang.hitch(this, function(){ this.play(null, gotoStart); }), delay); |
|
return this; // dojo.lfx.Animation |
|
} |
|
|
|
this._startTime = new Date().valueOf(); |
|
if(this._paused){ |
|
this._startTime -= (this.duration * this._percent / 100); |
|
} |
|
this._endTime = this._startTime + this.duration; |
|
|
|
this._active = true; |
|
this._paused = false; |
|
|
|
var step = this._percent / 100; |
|
var value = this.curve.getValue(step); |
|
if(this._percent == 0 ){ |
|
if(!this._startRepeatCount){ |
|
this._startRepeatCount = this.repeatCount; |
|
} |
|
this.fire("handler", ["begin", value]); |
|
this.fire("onBegin", [value]); |
|
} |
|
|
|
this.fire("handler", ["play", value]); |
|
this.fire("onPlay", [value]); |
|
|
|
this._cycle(); |
|
return this; // dojo.lfx.Animation |
|
}, |
|
|
|
pause: function(){ |
|
// summary: Pauses a running animation. |
|
clearTimeout(this._timer); |
|
if(!this._active){ return this; /*dojo.lfx.Animation*/} |
|
this._paused = true; |
|
var value = this.curve.getValue(this._percent / 100); |
|
this.fire("handler", ["pause", value]); |
|
this.fire("onPause", [value]); |
|
return this; // dojo.lfx.Animation |
|
}, |
|
|
|
gotoPercent: function(/*Decimal*/ pct, /*bool?*/ andPlay){ |
|
// summary: Sets the progress of the animation. |
|
// pct: A percentage in decimal notation (between and including 0.0 and 1.0). |
|
// andPlay: If true, play the animation after setting the progress. |
|
clearTimeout(this._timer); |
|
this._active = true; |
|
this._paused = true; |
|
this._percent = pct; |
|
if(andPlay){ this.play(); } |
|
return this; // dojo.lfx.Animation |
|
}, |
|
|
|
stop: function(/*bool?*/ gotoEnd){ |
|
// summary: Stops a running animation. |
|
// gotoEnd: If true, the animation will end. |
|
clearTimeout(this._timer); |
|
var step = this._percent / 100; |
|
if(gotoEnd){ |
|
step = 1; |
|
} |
|
var value = this.curve.getValue(step); |
|
this.fire("handler", ["stop", value]); |
|
this.fire("onStop", [value]); |
|
this._active = false; |
|
this._paused = false; |
|
return this; // dojo.lfx.Animation |
|
}, |
|
|
|
status: function(){ |
|
// summary: Returns a string representation of the status of |
|
// the animation. |
|
if(this._active){ |
|
return this._paused ? "paused" : "playing"; // String |
|
}else{ |
|
return "stopped"; // String |
|
} |
|
return this; |
|
}, |
|
|
|
// "private" methods |
|
_cycle: function(){ |
|
clearTimeout(this._timer); |
|
if(this._active){ |
|
var curr = new Date().valueOf(); |
|
var step = (curr - this._startTime) / (this._endTime - this._startTime); |
|
|
|
if(step >= 1){ |
|
step = 1; |
|
this._percent = 100; |
|
}else{ |
|
this._percent = step * 100; |
|
} |
|
|
|
// Perform easing |
|
if((this.easing)&&(dojo.lang.isFunction(this.easing))){ |
|
step = this.easing(step); |
|
} |
|
|
|
var value = this.curve.getValue(step); |
|
this.fire("handler", ["animate", value]); |
|
this.fire("onAnimate", [value]); |
|
|
|
if( step < 1 ){ |
|
this._timer = setTimeout(dojo.lang.hitch(this, "_cycle"), this.rate); |
|
}else{ |
|
this._active = false; |
|
this.fire("handler", ["end"]); |
|
this.fire("onEnd"); |
|
|
|
if(this.repeatCount > 0){ |
|
this.repeatCount--; |
|
this.play(null, true); |
|
}else if(this.repeatCount == -1){ |
|
this.play(null, true); |
|
}else{ |
|
if(this._startRepeatCount){ |
|
this.repeatCount = this._startRepeatCount; |
|
this._startRepeatCount = 0; |
|
} |
|
} |
|
} |
|
} |
|
return this; // dojo.lfx.Animation |
|
} |
|
}); |
|
|
|
dojo.lfx.Combine = function(/*dojo.lfx.IAnimation...*/ animations){ |
|
// summary: An animation object to play animations passed to it at the same time. |
|
dojo.lfx.IAnimation.call(this); |
|
this._anims = []; |
|
this._animsEnded = 0; |
|
|
|
var anims = arguments; |
|
if(anims.length == 1 && (dojo.lang.isArray(anims[0]) || dojo.lang.isArrayLike(anims[0]))){ |
|
/* animations: dojo.lfx.IAnimation[] |
|
pId: a */ |
|
anims = anims[0]; |
|
} |
|
|
|
dojo.lang.forEach(anims, function(anim){ |
|
this._anims.push(anim); |
|
anim.connect("onEnd", dojo.lang.hitch(this, "_onAnimsEnded")); |
|
}, this); |
|
} |
|
dojo.inherits(dojo.lfx.Combine, dojo.lfx.IAnimation); |
|
dojo.lang.extend(dojo.lfx.Combine, { |
|
// private members |
|
_animsEnded: 0, |
|
|
|
// public methods |
|
play: function(/*int?*/ delay, /*bool?*/ gotoStart){ |
|
// summary: Start the animations. |
|
// delay: How many milliseconds to delay before starting. |
|
// gotoStart: If true, starts the animations from the beginning; otherwise, |
|
// starts them from their current position. |
|
if( !this._anims.length ){ return this; /*dojo.lfx.Combine*/} |
|
|
|
this.fire("beforeBegin"); |
|
|
|
if(delay > 0){ |
|
setTimeout(dojo.lang.hitch(this, function(){ this.play(null, gotoStart); }), delay); |
|
return this; // dojo.lfx.Combine |
|
} |
|
|
|
if(gotoStart || this._anims[0].percent == 0){ |
|
this.fire("onBegin"); |
|
} |
|
this.fire("onPlay"); |
|
this._animsCall("play", null, gotoStart); |
|
return this; // dojo.lfx.Combine |
|
}, |
|
|
|
pause: function(){ |
|
// summary: Pauses the running animations. |
|
this.fire("onPause"); |
|
this._animsCall("pause"); |
|
return this; // dojo.lfx.Combine |
|
}, |
|
|
|
stop: function(/*bool?*/ gotoEnd){ |
|
// summary: Stops the running animations. |
|
// gotoEnd: If true, the animations will end. |
|
this.fire("onStop"); |
|
this._animsCall("stop", gotoEnd); |
|
return this; // dojo.lfx.Combine |
|
}, |
|
|
|
// private methods |
|
_onAnimsEnded: function(){ |
|
this._animsEnded++; |
|
if(this._animsEnded >= this._anims.length){ |
|
this.fire("onEnd"); |
|
} |
|
return this; // dojo.lfx.Combine |
|
}, |
|
|
|
_animsCall: function(/*String*/ funcName){ |
|
var args = []; |
|
if(arguments.length > 1){ |
|
for(var i = 1 ; i < arguments.length ; i++){ |
|
args.push(arguments[i]); |
|
} |
|
} |
|
var _this = this; |
|
dojo.lang.forEach(this._anims, function(anim){ |
|
anim[funcName](args); |
|
}, _this); |
|
return this; // dojo.lfx.Combine |
|
} |
|
}); |
|
|
|
dojo.lfx.Chain = function(/*dojo.lfx.IAnimation...*/ animations) { |
|
// summary: An animation object to play animations passed to it |
|
// one after another. |
|
dojo.lfx.IAnimation.call(this); |
|
this._anims = []; |
|
this._currAnim = -1; |
|
|
|
var anims = arguments; |
|
if(anims.length == 1 && (dojo.lang.isArray(anims[0]) || dojo.lang.isArrayLike(anims[0]))){ |
|
/* animations: dojo.lfx.IAnimation[] |
|
pId: a */ |
|
anims = anims[0]; |
|
} |
|
|
|
var _this = this; |
|
dojo.lang.forEach(anims, function(anim, i, anims_arr){ |
|
this._anims.push(anim); |
|
if(i < anims_arr.length - 1){ |
|
anim.connect("onEnd", dojo.lang.hitch(this, "_playNext") ); |
|
}else{ |
|
anim.connect("onEnd", dojo.lang.hitch(this, function(){ this.fire("onEnd"); }) ); |
|
} |
|
}, this); |
|
} |
|
dojo.inherits(dojo.lfx.Chain, dojo.lfx.IAnimation); |
|
dojo.lang.extend(dojo.lfx.Chain, { |
|
// private members |
|
_currAnim: -1, |
|
|
|
// public methods |
|
play: function(/*int?*/ delay, /*bool?*/ gotoStart){ |
|
// summary: Start the animation sequence. |
|
// delay: How many milliseconds to delay before starting. |
|
// gotoStart: If true, starts the sequence from the beginning; otherwise, |
|
// starts it from its current position. |
|
if( !this._anims.length ) { return this; /*dojo.lfx.Chain*/} |
|
if( gotoStart || !this._anims[this._currAnim] ) { |
|
this._currAnim = 0; |
|
} |
|
|
|
var currentAnimation = this._anims[this._currAnim]; |
|
|
|
this.fire("beforeBegin"); |
|
if(delay > 0){ |
|
setTimeout(dojo.lang.hitch(this, function(){ this.play(null, gotoStart); }), delay); |
|
return this; // dojo.lfx.Chain |
|
} |
|
|
|
if(currentAnimation){ |
|
if(this._currAnim == 0){ |
|
this.fire("handler", ["begin", this._currAnim]); |
|
this.fire("onBegin", [this._currAnim]); |
|
} |
|
this.fire("onPlay", [this._currAnim]); |
|
currentAnimation.play(null, gotoStart); |
|
} |
|
return this; // dojo.lfx.Chain |
|
}, |
|
|
|
pause: function(){ |
|
// summary: Pauses the running animation sequence. |
|
if( this._anims[this._currAnim] ) { |
|
this._anims[this._currAnim].pause(); |
|
this.fire("onPause", [this._currAnim]); |
|
} |
|
return this; // dojo.lfx.Chain |
|
}, |
|
|
|
playPause: function(){ |
|
// summary: If the animation sequence is playing, pause it; otherwise, |
|
// play it. |
|
if(this._anims.length == 0){ return this; } |
|
if(this._currAnim == -1){ this._currAnim = 0; } |
|
var currAnim = this._anims[this._currAnim]; |
|
if( currAnim ) { |
|
if( !currAnim._active || currAnim._paused ) { |
|
this.play(); |
|
} else { |
|
this.pause(); |
|
} |
|
} |
|
return this; // dojo.lfx.Chain |
|
}, |
|
|
|
stop: function(){ |
|
// summary: Stops the running animations. |
|
var currAnim = this._anims[this._currAnim]; |
|
if(currAnim){ |
|
currAnim.stop(); |
|
this.fire("onStop", [this._currAnim]); |
|
} |
|
return currAnim; // dojo.lfx.IAnimation |
|
}, |
|
|
|
// private methods |
|
_playNext: function(){ |
|
if( this._currAnim == -1 || this._anims.length == 0 ) { return this; } |
|
this._currAnim++; |
|
if( this._anims[this._currAnim] ){ |
|
this._anims[this._currAnim].play(null, true); |
|
} |
|
return this; // dojo.lfx.Chain |
|
} |
|
}); |
|
|
|
dojo.lfx.combine = function(/*dojo.lfx.IAnimation...*/ animations){ |
|
// summary: Convenience function. Returns a dojo.lfx.Combine created |
|
// using the animations passed in. |
|
var anims = arguments; |
|
if(dojo.lang.isArray(arguments[0])){ |
|
/* animations: dojo.lfx.IAnimation[] |
|
pId: a */ |
|
anims = arguments[0]; |
|
} |
|
if(anims.length == 1){ return anims[0]; } |
|
return new dojo.lfx.Combine(anims); // dojo.lfx.Combine |
|
} |
|
|
|
dojo.lfx.chain = function(/*dojo.lfx.IAnimation...*/ animations){ |
|
// summary: Convenience function. Returns a dojo.lfx.Chain created |
|
// using the animations passed in. |
|
var anims = arguments; |
|
if(dojo.lang.isArray(arguments[0])){ |
|
/* animations: dojo.lfx.IAnimation[] |
|
pId: a */ |
|
anims = arguments[0]; |
|
} |
|
if(anims.length == 1){ return anims[0]; } |
|
return new dojo.lfx.Chain(anims); // dojo.lfx.Combine |
|
} |
|
|
|
dojo.provide("dojo.html.common"); |
|
|
|
|
|
|
|
dojo.lang.mixin(dojo.html, dojo.dom); |
|
|
|
dojo.html.body = function(){ |
|
dojo.deprecated("dojo.html.body() moved to dojo.body()", "0.5"); |
|
return dojo.body(); |
|
} |
|
|
|
// FIXME: we are going to assume that we can throw any and every rendering |
|
// engine into the IE 5.x box model. In Mozilla, we do this w/ CSS. |
|
// Need to investigate for KHTML and Opera |
|
|
|
dojo.html.getEventTarget = function(/* DOMEvent */evt){ |
|
// summary |
|
// Returns the target of an event |
|
if(!evt) { evt = dojo.global().event || {} }; |
|
var t = (evt.srcElement ? evt.srcElement : (evt.target ? evt.target : null)); |
|
while((t)&&(t.nodeType!=1)){ t = t.parentNode; } |
|
return t; // HTMLElement |
|
} |
|
|
|
dojo.html.getViewport = function(){ |
|
// summary |
|
// Returns the dimensions of the viewable area of a browser window |
|
var _window = dojo.global(); |
|
var _document = dojo.doc(); |
|
var w = 0; |
|
var h = 0; |
|
|
|
if(dojo.render.html.mozilla){ |
|
// mozilla |
|
w = _document.documentElement.clientWidth; |
|
h = _window.innerHeight; |
|
}else if(!dojo.render.html.opera && _window.innerWidth){ |
|
//in opera9, dojo.body().clientWidth should be used, instead |
|
//of window.innerWidth/document.documentElement.clientWidth |
|
//so we have to check whether it is opera |
|
w = _window.innerWidth; |
|
h = _window.innerHeight; |
|
} else if (!dojo.render.html.opera && dojo.exists(_document, "documentElement.clientWidth")){ |
|
// IE6 Strict |
|
var w2 = _document.documentElement.clientWidth; |
|
// this lets us account for scrollbars |
|
if(!w || w2 && w2 < w) { |
|
w = w2; |
|
} |
|
h = _document.documentElement.clientHeight; |
|
} else if (dojo.body().clientWidth){ |
|
// IE, Opera |
|
w = dojo.body().clientWidth; |
|
h = dojo.body().clientHeight; |
|
} |
|
return { width: w, height: h }; // object |
|
} |
|
|
|
dojo.html.getScroll = function(){ |
|
// summary |
|
// Returns the scroll position of the document |
|
var _window = dojo.global(); |
|
var _document = dojo.doc(); |
|
var top = _window.pageYOffset || _document.documentElement.scrollTop || dojo.body().scrollTop || 0; |
|
var left = _window.pageXOffset || _document.documentElement.scrollLeft || dojo.body().scrollLeft || 0; |
|
return { |
|
top: top, |
|
left: left, |
|
offset:{ x: left, y: top } // note the change, NOT an Array with added properties. |
|
}; // object |
|
} |
|
|
|
dojo.html.getParentByType = function(/* HTMLElement */node, /* string */type) { |
|
// summary |
|
// Returns the first ancestor of node with tagName type. |
|
var _document = dojo.doc(); |
|
var parent = dojo.byId(node); |
|
type = type.toLowerCase(); |
|
while((parent)&&(parent.nodeName.toLowerCase()!=type)){ |
|
if(parent==(_document["body"]||_document["documentElement"])){ |
|
return null; |
|
} |
|
parent = parent.parentNode; |
|
} |
|
return parent; // HTMLElement |
|
} |
|
|
|
dojo.html.getAttribute = function(/* HTMLElement */node, /* string */attr){ |
|
// summary |
|
// Returns the value of attribute attr from node. |
|
node = dojo.byId(node); |
|
// FIXME: need to add support for attr-specific accessors |
|
if((!node)||(!node.getAttribute)){ |
|
// if(attr !== 'nwType'){ |
|
// alert("getAttr of '" + attr + "' with bad node"); |
|
// } |
|
return null; |
|
} |
|
var ta = typeof attr == 'string' ? attr : new String(attr); |
|
|
|
// first try the approach most likely to succeed |
|
var v = node.getAttribute(ta.toUpperCase()); |
|
if((v)&&(typeof v == 'string')&&(v!="")){ |
|
return v; // string |
|
} |
|
|
|
// try returning the attributes value, if we couldn't get it as a string |
|
if(v && v.value){ |
|
return v.value; // string |
|
} |
|
|
|
// this should work on Opera 7, but it's a little on the crashy side |
|
if((node.getAttributeNode)&&(node.getAttributeNode(ta))){ |
|
return (node.getAttributeNode(ta)).value; // string |
|
}else if(node.getAttribute(ta)){ |
|
return node.getAttribute(ta); // string |
|
}else if(node.getAttribute(ta.toLowerCase())){ |
|
return node.getAttribute(ta.toLowerCase()); // string |
|
} |
|
return null; // string |
|
} |
|
|
|
dojo.html.hasAttribute = function(/* HTMLElement */node, /* string */attr){ |
|
// summary |
|
// Determines whether or not the specified node carries a value for the attribute in question. |
|
return dojo.html.getAttribute(dojo.byId(node), attr) ? true : false; // boolean |
|
} |
|
|
|
dojo.html.getCursorPosition = function(/* DOMEvent */e){ |
|
// summary |
|
// Returns the mouse position relative to the document (not the viewport). |
|
// For example, if you have a document that is 10000px tall, |
|
// but your browser window is only 100px tall, |
|
// if you scroll to the bottom of the document and call this function it |
|
// will return {x: 0, y: 10000} |
|
// NOTE: for events delivered via dojo.event.connect() and/or dojoAttachEvent (for widgets), |
|
// you can just access evt.pageX and evt.pageY, rather than calling this function. |
|
e = e || dojo.global().event; |
|
var cursor = {x:0, y:0}; |
|
if(e.pageX || e.pageY){ |
|
cursor.x = e.pageX; |
|
cursor.y = e.pageY; |
|
}else{ |
|
var de = dojo.doc().documentElement; |
|
var db = dojo.body(); |
|
cursor.x = e.clientX + ((de||db)["scrollLeft"]) - ((de||db)["clientLeft"]); |
|
cursor.y = e.clientY + ((de||db)["scrollTop"]) - ((de||db)["clientTop"]); |
|
} |
|
return cursor; // object |
|
} |
|
|
|
dojo.html.isTag = function(/* HTMLElement */node) { |
|
// summary |
|
// Like dojo.dom.isTag, except case-insensitive |
|
node = dojo.byId(node); |
|
if(node && node.tagName) { |
|
for (var i=1; i<arguments.length; i++){ |
|
if (node.tagName.toLowerCase()==String(arguments[i]).toLowerCase()){ |
|
return String(arguments[i]).toLowerCase(); // string |
|
} |
|
} |
|
} |
|
return ""; // string |
|
} |
|
|
|
//define dojo.html.createExternalElement for IE to workaround the annoying activation "feature" in new IE |
|
//details: http://msdn.microsoft.com/library/default.asp?url=/workshop/author/dhtml/overview/activating_activex.asp |
|
if(dojo.render.html.ie && !dojo.render.html.ie70){ |
|
//only define createExternalElement for IE in none https to avoid "mixed content" warning dialog |
|
if(window.location.href.substr(0,6).toLowerCase() != "https:"){ |
|
(function(){ |
|
// FIXME: this seems not to work correctly on IE 7!! |
|
|
|
//The trick is to define a function in a script.src property: |
|
// <script src="javascript:'function createExternalElement(){...}'"></script>, |
|
//which will be treated as an external javascript file in IE |
|
var xscript = dojo.doc().createElement('script'); |
|
xscript.src = "javascript:'dojo.html.createExternalElement=function(doc, tag){ return doc.createElement(tag); }'"; |
|
dojo.doc().getElementsByTagName("head")[0].appendChild(xscript); |
|
})(); |
|
} |
|
}else{ |
|
//for other browsers, simply use document.createElement |
|
//is enough |
|
dojo.html.createExternalElement = function(/* HTMLDocument */doc, /* string */tag){ |
|
// summary |
|
// Creates an element in the HTML document, here for ActiveX activation workaround. |
|
return doc.createElement(tag); // HTMLElement |
|
} |
|
} |
|
|
|
dojo.html._callDeprecated = function(inFunc, replFunc, args, argName, retValue){ |
|
dojo.deprecated("dojo.html." + inFunc, |
|
"replaced by dojo.html." + replFunc + "(" + (argName ? "node, {"+ argName + ": " + argName + "}" : "" ) + ")" + (retValue ? "." + retValue : ""), "0.5"); |
|
var newArgs = []; |
|
if(argName){ var argsIn = {}; argsIn[argName] = args[1]; newArgs.push(args[0]); newArgs.push(argsIn); } |
|
else { newArgs = args } |
|
var ret = dojo.html[replFunc].apply(dojo.html, args); |
|
if(retValue){ return ret[retValue]; } |
|
else { return ret; } |
|
} |
|
|
|
dojo.html.getViewportWidth = function(){ |
|
return dojo.html._callDeprecated("getViewportWidth", "getViewport", arguments, null, "width"); |
|
} |
|
dojo.html.getViewportHeight = function(){ |
|
return dojo.html._callDeprecated("getViewportHeight", "getViewport", arguments, null, "height"); |
|
} |
|
dojo.html.getViewportSize = function(){ |
|
return dojo.html._callDeprecated("getViewportSize", "getViewport", arguments); |
|
} |
|
dojo.html.getScrollTop = function(){ |
|
return dojo.html._callDeprecated("getScrollTop", "getScroll", arguments, null, "top"); |
|
} |
|
dojo.html.getScrollLeft = function(){ |
|
return dojo.html._callDeprecated("getScrollLeft", "getScroll", arguments, null, "left"); |
|
} |
|
dojo.html.getScrollOffset = function(){ |
|
return dojo.html._callDeprecated("getScrollOffset", "getScroll", arguments, null, "offset"); |
|
} |
|
|
|
dojo.provide("dojo.uri.Uri"); |
|
|
|
dojo.uri = new function() { |
|
this.dojoUri = function (/*dojo.uri.Uri||String*/uri) { |
|
// summary: returns a Uri object resolved relative to the dojo root |
|
return new dojo.uri.Uri(dojo.hostenv.getBaseScriptUri(), uri); |
|
} |
|
|
|
this.moduleUri = function(/*String*/module, /*dojo.uri.Uri||String*/uri){ |
|
// summary: returns a Uri object relative to a module |
|
// description: Examples: dojo.uri.moduleUri("dojo.widget","templates/template.html"), or dojo.uri.moduleUri("acme","images/small.png") |
|
var loc = dojo.hostenv.getModuleSymbols(module).join('/'); |
|
if(!loc){ |
|
return null; |
|
} |
|
if(loc.lastIndexOf("/") != loc.length-1){ |
|
loc += "/"; |
|
} |
|
|
|
//If the path is an absolute path (starts with a / or is on another domain/xdomain) |
|
//then don't add the baseScriptUri. |
|
var colonIndex = loc.indexOf(":"); |
|
var slashIndex = loc.indexOf("/"); |
|
if(loc.charAt(0) != "/" && (colonIndex == -1 || colonIndex > slashIndex)){ |
|
loc = dojo.hostenv.getBaseScriptUri() + loc; |
|
} |
|
|
|
return new dojo.uri.Uri(loc,uri); |
|
} |
|
|
|
this.Uri = function (/*dojo.uri.Uri||String...*/) { |
|
// summary: Constructor to create an object representing a URI. |
|
// description: |
|
// Each argument is evaluated in order relative to the next until |
|
// a canonical uri is produced. To get an absolute Uri relative |
|
// to the current document use |
|
// new dojo.uri.Uri(document.baseURI, uri) |
|
|
|
// TODO: support for IPv6, see RFC 2732 |
|
|
|
// resolve uri components relative to each other |
|
var uri = arguments[0]; |
|
for (var i = 1; i < arguments.length; i++) { |
|
if(!arguments[i]) { continue; } |
|
|
|
// Safari doesn't support this.constructor so we have to be explicit |
|
var relobj = new dojo.uri.Uri(arguments[i].toString()); |
|
var uriobj = new dojo.uri.Uri(uri.toString()); |
|
|
|
if ((relobj.path=="")&&(relobj.scheme==null)&&(relobj.authority==null)&&(relobj.query==null)) { |
|
if (relobj.fragment != null) { uriobj.fragment = relobj.fragment; } |
|
relobj = uriobj; |
|
} else if (relobj.scheme == null) { |
|
relobj.scheme = uriobj.scheme; |
|
|
|
if (relobj.authority == null) { |
|
relobj.authority = uriobj.authority; |
|
|
|
if (relobj.path.charAt(0) != "/") { |
|
var path = uriobj.path.substring(0, |
|
uriobj.path.lastIndexOf("/") + 1) + relobj.path; |
|
|
|
var segs = path.split("/"); |
|
for (var j = 0; j < segs.length; j++) { |
|
if (segs[j] == ".") { |
|
if (j == segs.length - 1) { segs[j] = ""; } |
|
else { segs.splice(j, 1); j--; } |
|
} else if (j > 0 && !(j == 1 && segs[0] == "") && |
|
segs[j] == ".." && segs[j-1] != "..") { |
|
|
|
if (j == segs.length - 1) { segs.splice(j, 1); segs[j - 1] = ""; } |
|
else { segs.splice(j - 1, 2); j -= 2; } |
|
} |
|
} |
|
relobj.path = segs.join("/"); |
|
} |
|
} |
|
} |
|
|
|
uri = ""; |
|
if (relobj.scheme != null) { uri += relobj.scheme + ":"; } |
|
if (relobj.authority != null) { uri += "//" + relobj.authority; } |
|
uri += relobj.path; |
|
if (relobj.query != null) { uri += "?" + relobj.query; } |
|
if (relobj.fragment != null) { uri += "#" + relobj.fragment; } |
|
} |
|
|
|
this.uri = uri.toString(); |
|
|
|
// break the uri into its main components |
|
var regexp = "^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\\?([^#]*))?(#(.*))?$"; |
|
var r = this.uri.match(new RegExp(regexp)); |
|
|
|
this.scheme = r[2] || (r[1] ? "" : null); |
|
this.authority = r[4] || (r[3] ? "" : null); |
|
this.path = r[5]; // can never be undefined |
|
this.query = r[7] || (r[6] ? "" : null); |
|
this.fragment = r[9] || (r[8] ? "" : null); |
|
|
|
if (this.authority != null) { |
|
// server based naming authority |
|
regexp = "^((([^:]+:)?([^@]+))@)?([^:]*)(:([0-9]+))?$"; |
|
r = this.authority.match(new RegExp(regexp)); |
|
|
|
this.user = r[3] || null; |
|
this.password = r[4] || null; |
|
this.host = r[5]; |
|
this.port = r[7] || null; |
|
} |
|
|
|
this.toString = function(){ return this.uri; } |
|
} |
|
}; |
|
|
|
dojo.provide("dojo.html.style"); |
|
|
|
|
|
|
|
dojo.html.getClass = function(/* HTMLElement */node){ |
|
// summary |
|
// Returns the string value of the list of CSS classes currently assigned directly |
|
// to the node in question. Returns an empty string if no class attribute is found; |
|
node = dojo.byId(node); |
|
if(!node){ return ""; } |
|
var cs = ""; |
|
if(node.className){ |
|
cs = node.className; |
|
}else if(dojo.html.hasAttribute(node, "class")){ |
|
cs = dojo.html.getAttribute(node, "class"); |
|
} |
|
return cs.replace(/^\s+|\s+$/g, ""); // string |
|
} |
|
|
|
dojo.html.getClasses = function(/* HTMLElement */node) { |
|
// summary |
|
// Returns an array of CSS classes currently assigned directly to the node in question. |
|
// Returns an empty array if no classes are found; |
|
var c = dojo.html.getClass(node); |
|
return (c == "") ? [] : c.split(/\s+/g); // array |
|
} |
|
|
|
dojo.html.hasClass = function(/* HTMLElement */node, /* string */classname){ |
|
// summary |
|
// Returns whether or not the specified classname is a portion of the |
|
// class list currently applied to the node. Does not cover cascaded |
|
// styles, only classes directly applied to the node. |
|
return (new RegExp('(^|\\s+)'+classname+'(\\s+|$)')).test(dojo.html.getClass(node)) // boolean |
|
} |
|
|
|
dojo.html.prependClass = function(/* HTMLElement */node, /* string */classStr){ |
|
// summary |
|
// Adds the specified class to the beginning of the class list on the |
|
// passed node. This gives the specified class the highest precidence |
|
// when style cascading is calculated for the node. Returns true or |
|
// false; indicating success or failure of the operation, respectively. |
|
classStr += " " + dojo.html.getClass(node); |
|
return dojo.html.setClass(node, classStr); // boolean |
|
} |
|
|
|
dojo.html.addClass = function(/* HTMLElement */node, /* string */classStr){ |
|
// summary |
|
// Adds the specified class to the end of the class list on the |
|
// passed &node;. Returns &true; or &false; indicating success or failure. |
|
if (dojo.html.hasClass(node, classStr)) { |
|
return false; |
|
} |
|
classStr = (dojo.html.getClass(node) + " " + classStr).replace(/^\s+|\s+$/g,""); |
|
return dojo.html.setClass(node, classStr); // boolean |
|
} |
|
|
|
dojo.html.setClass = function(/* HTMLElement */node, /* string */classStr){ |
|
// summary |
|
// Clobbers the existing list of classes for the node, replacing it with |
|
// the list given in the 2nd argument. Returns true or false |
|
// indicating success or failure. |
|
node = dojo.byId(node); |
|
var cs = new String(classStr); |
|
try{ |
|
if(typeof node.className == "string"){ |
|
node.className = cs; |
|
}else if(node.setAttribute){ |
|
node.setAttribute("class", classStr); |
|
node.className = cs; |
|
}else{ |
|
return false; |
|
} |
|
}catch(e){ |
|
dojo.debug("dojo.html.setClass() failed", e); |
|
} |
|
return true; |
|
} |
|
|
|
dojo.html.removeClass = function(/* HTMLElement */node, /* string */classStr, /* boolean? */allowPartialMatches){ |
|
// summary |
|
// Removes the className from the node;. Returns true or false indicating success or failure. |
|
try{ |
|
if (!allowPartialMatches) { |
|
var newcs = dojo.html.getClass(node).replace(new RegExp('(^|\\s+)'+classStr+'(\\s+|$)'), "$1$2"); |
|
} else { |
|
var newcs = dojo.html.getClass(node).replace(classStr,''); |
|
} |
|
dojo.html.setClass(node, newcs); |
|
}catch(e){ |
|
dojo.debug("dojo.html.removeClass() failed", e); |
|
} |
|
return true; // boolean |
|
} |
|
|
|
dojo.html.replaceClass = function(/* HTMLElement */node, /* string */newClass, /* string */oldClass) { |
|
// summary |
|
// Replaces 'oldClass' and adds 'newClass' to node |
|
dojo.html.removeClass(node, oldClass); |
|
dojo.html.addClass(node, newClass); |
|
} |
|
|
|
// Enum type for getElementsByClass classMatchType arg: |
|
dojo.html.classMatchType = { |
|
ContainsAll : 0, // all of the classes are part of the node's class (default) |
|
ContainsAny : 1, // any of the classes are part of the node's class |
|
IsOnly : 2 // only all of the classes are part of the node's class |
|
} |
|
|
|
|
|
dojo.html.getElementsByClass = function( |
|
/* string */classStr, |
|
/* HTMLElement? */parent, |
|
/* string? */nodeType, |
|
/* integer? */classMatchType, |
|
/* boolean? */useNonXpath |
|
){ |
|
// summary |
|
// Returns an array of nodes for the given classStr, children of a |
|
// parent, and optionally of a certain nodeType |
|
// FIXME: temporarily set to false because of several dojo tickets related |
|
// to the xpath version not working consistently in firefox. |
|
useNonXpath = false; |
|
var _document = dojo.doc(); |
|
parent = dojo.byId(parent) || _document; |
|
var classes = classStr.split(/\s+/g); |
|
var nodes = []; |
|
if( classMatchType != 1 && classMatchType != 2 ) classMatchType = 0; // make it enum |
|
var reClass = new RegExp("(\\s|^)((" + classes.join(")|(") + "))(\\s|$)"); |
|
var srtLength = classes.join(" ").length; |
|
var candidateNodes = []; |
|
|
|
if(!useNonXpath && _document.evaluate) { // supports dom 3 xpath |
|
var xpath = ".//" + (nodeType || "*") + "[contains("; |
|
if(classMatchType != dojo.html.classMatchType.ContainsAny){ |
|
xpath += "concat(' ',@class,' '), ' " + |
|
classes.join(" ') and contains(concat(' ',@class,' '), ' ") + |
|
" ')"; |
|
if (classMatchType == 2) { |
|
xpath += " and string-length(@class)="+srtLength+"]"; |
|
}else{ |
|
xpath += "]"; |
|
} |
|
}else{ |
|
xpath += "concat(' ',@class,' '), ' " + |
|
classes.join(" ') or contains(concat(' ',@class,' '), ' ") + |
|
" ')]"; |
|
} |
|
var xpathResult = _document.evaluate(xpath, parent, null, XPathResult.ANY_TYPE, null); |
|
var result = xpathResult.iterateNext(); |
|
while(result){ |
|
try{ |
|
candidateNodes.push(result); |
|
result = xpathResult.iterateNext(); |
|
}catch(e){ break; } |
|
} |
|
return candidateNodes; // NodeList |
|
}else{ |
|
if(!nodeType){ |
|
nodeType = "*"; |
|
} |
|
candidateNodes = parent.getElementsByTagName(nodeType); |
|
|
|
var node, i = 0; |
|
outer: |
|
while(node = candidateNodes[i++]){ |
|
var nodeClasses = dojo.html.getClasses(node); |
|
if(nodeClasses.length == 0){ continue outer; } |
|
var matches = 0; |
|
|
|
for(var j = 0; j < nodeClasses.length; j++){ |
|
if(reClass.test(nodeClasses[j])){ |
|
if(classMatchType == dojo.html.classMatchType.ContainsAny){ |
|
nodes.push(node); |
|
continue outer; |
|
}else{ |
|
matches++; |
|
} |
|
}else{ |
|
if(classMatchType == dojo.html.classMatchType.IsOnly){ |
|
continue outer; |
|
} |
|
} |
|
} |
|
|
|
if(matches == classes.length){ |
|
if( (classMatchType == dojo.html.classMatchType.IsOnly)&& |
|
(matches == nodeClasses.length)){ |
|
nodes.push(node); |
|
}else if(classMatchType == dojo.html.classMatchType.ContainsAll){ |
|
nodes.push(node); |
|
} |
|
} |
|
} |
|
return nodes; // NodeList |
|
} |
|
} |
|
dojo.html.getElementsByClassName = dojo.html.getElementsByClass; |
|
|
|
dojo.html.toCamelCase = function(/* string */selector){ |
|
// summary |
|
// Translates a CSS selector string to a camel-cased one. |
|
var arr = selector.split('-'), cc = arr[0]; |
|
for(var i = 1; i < arr.length; i++) { |
|
cc += arr[i].charAt(0).toUpperCase() + arr[i].substring(1); |
|
} |
|
return cc; // string |
|
} |
|
|
|
dojo.html.toSelectorCase = function(/* string */selector){ |
|
// summary |
|
// Translates a camel cased string to a selector cased one. |
|
return selector.replace(/([A-Z])/g, "-$1" ).toLowerCase(); // string |
|
} |
|
|
|
if (dojo.render.html.ie) { |
|
// IE branch |
|
dojo.html.getComputedStyle = function(/*HTMLElement|String*/node, /*String*/property, /*String*/value) { |
|
// summary |
|
// Get the computed style value for style "property" on "node" (IE). |
|
node = dojo.byId(node); // FIXME: remove ability to access nodes by id for this time-critical function |
|
if(!node || !node.style){return value;} |
|
// FIXME: standardize on camel-case input to improve speed |
|
return node.currentStyle[dojo.html.toCamelCase(property)]; // String |
|
} |
|
// SJM: getComputedStyle should be abandoned and replaced with the below function. |
|
// All our supported browsers can return CSS2 compliant CssStyleDeclaration objects |
|
// which can be queried directly for multiple styles. |
|
dojo.html.getComputedStyles = function(/*HTMLElement*/node) { |
|
// summary |
|
// Get a style object containing computed styles for HTML Element node (IE). |
|
return node.currentStyle; // CSSStyleDeclaration |
|
} |
|
} else { |
|
// non-IE branch |
|
dojo.html.getComputedStyle = function(/*HTMLElement|String*/node, /*String*/property, /*Any*/value) { |
|
// summary |
|
// Get the computed style value for style "property" on "node" (non-IE). |
|
node = dojo.byId(node); |
|
if(!node || !node.style){return value;} |
|
var s = document.defaultView.getComputedStyle(node, null); |
|
// s may be null on Safari |
|
return (s&&s[dojo.html.toCamelCase(property)])||''; // String |
|
} |
|
// SJM: getComputedStyle should be abandoned and replaced with the below function. |
|
// All our supported browsers can return CSS2 compliant CssStyleDeclaration objects |
|
// which can be queried directly for multiple styles. |
|
dojo.html.getComputedStyles = function(node) { |
|
// summary |
|
// Get a style object containing computed styles for HTML Element node (non-IE). |
|
return document.defaultView.getComputedStyle(node, null); // CSSStyleDeclaration |
|
} |
|
} |
|
|
|
dojo.html.getStyleProperty = function(/* HTMLElement */node, /* string */cssSelector){ |
|
// summary |
|
// Returns the value of the passed style |
|
node = dojo.byId(node); |
|
return (node && node.style ? node.style[dojo.html.toCamelCase(cssSelector)] : undefined); // string |
|
} |
|
|
|
dojo.html.getStyle = function(/* HTMLElement */node, /* string */cssSelector){ |
|
// summary |
|
// Returns the computed value of the passed style |
|
var value = dojo.html.getStyleProperty(node, cssSelector); |
|
return (value ? value : dojo.html.getComputedStyle(node, cssSelector)); // string || integer |
|
} |
|
|
|
dojo.html.setStyle = function(/* HTMLElement */node, /* string */cssSelector, /* string */value){ |
|
// summary |
|
// Set the value of passed style on node |
|
node = dojo.byId(node); |
|
if(node && node.style){ |
|
var camelCased = dojo.html.toCamelCase(cssSelector); |
|
node.style[camelCased] = value; |
|
} |
|
} |
|
|
|
dojo.html.setStyleText = function (/* HTMLElement */target, /* string */text) { |
|
// summary |
|
// Try to set the entire cssText property of the passed target; equiv of setting style attribute. |
|
try { |
|
target.style.cssText = text; |
|
} catch (e) { |
|
target.setAttribute("style", text); |
|
} |
|
} |
|
|
|
dojo.html.copyStyle = function(/* HTMLElement */target, /* HTMLElement */source){ |
|
// summary |
|
// work around for opera which doesn't have cssText, and for IE which fails on setAttribute |
|
if(!source.style.cssText){ |
|
target.setAttribute("style", source.getAttribute("style")); |
|
}else{ |
|
target.style.cssText = source.style.cssText; |
|
} |
|
dojo.html.addClass(target, dojo.html.getClass(source)); |
|
} |
|
|
|
dojo.html.getUnitValue = function(/* HTMLElement */node, /* string */cssSelector, /* boolean? */autoIsZero){ |
|
// summary |
|
// Get the value of passed selector, with the specific units used |
|
var s = dojo.html.getComputedStyle(node, cssSelector); |
|
if((!s)||((s == 'auto')&&(autoIsZero))){ |
|
return { value: 0, units: 'px' }; // object |
|
} |
|
// FIXME: is regex inefficient vs. parseInt or some manual test? |
|
var match = s.match(/(\-?[\d.]+)([a-z%]*)/i); |
|
if (!match){return dojo.html.getUnitValue.bad;} |
|
return { value: Number(match[1]), units: match[2].toLowerCase() }; // object |
|
} |
|
dojo.html.getUnitValue.bad = { value: NaN, units: '' }; |
|
|
|
if (dojo.render.html.ie) { |
|
// IE branch |
|
dojo.html.toPixelValue = function(/* HTMLElement */element, /* String */styleValue){ |
|
// summary |
|
// Extract value in pixels from styleValue (IE version). |
|
// If a value cannot be extracted, zero is returned. |
|
if(!styleValue){return 0;} |
|
if(styleValue.slice(-2) == 'px'){return parseFloat(styleValue);} |
|
var pixelValue = 0; |
|
with(element){ |
|
var sLeft = style.left; |
|
var rsLeft = runtimeStyle.left; |
|
runtimeStyle.left = currentStyle.left; |
|
try { |
|
style.left = styleValue || 0; |
|
pixelValue = style.pixelLeft; |
|
style.left = sLeft; |
|
runtimeStyle.left = rsLeft; |
|
}catch(e){ |
|
// FIXME: it's possible for styleValue to be incompatible with |
|
// style.left. In particular, border width values of |
|
// "thick", "medium", or "thin" will provoke an exception. |
|
} |
|
} |
|
return pixelValue; // Number |
|
} |
|
} else { |
|
// non-IE branch |
|
dojo.html.toPixelValue = function(/* HTMLElement */element, /* String */styleValue){ |
|
// summary |
|
// Extract value in pixels from styleValue (non-IE version). |
|
// If a value cannot be extracted, zero is returned. |
|
return (styleValue && (styleValue.slice(-2)=='px') ? parseFloat(styleValue) : 0); // Number |
|
} |
|
} |
|
|
|
dojo.html.getPixelValue = function(/* HTMLElement */node, /* string */styleProperty, /* boolean? */autoIsZero){ |
|
// summary |
|
// Get a computed style value, in pixels. |
|
// node: HTMLElement |
|
// Node to interrogate |
|
// styleProperty: String |
|
// Style property to query, in either css-selector or camelCase (property) format. |
|
// autoIsZero: Boolean |
|
// Deprecated. Any value that cannot be converted to pixels is returned as zero. |
|
// |
|
// summary |
|
// Get the value of passed selector in pixels. |
|
// |
|
return dojo.html.toPixelValue(node, dojo.html.getComputedStyle(node, styleProperty)); |
|
} |
|
|
|
dojo.html.setPositivePixelValue = function(/* HTMLElement */node, /* string */selector, /* integer */value){ |
|
// summary |
|
// Attempt to set the value of selector on node as a positive pixel value. |
|
if(isNaN(value)){return false;} |
|
node.style[selector] = Math.max(0, value) + 'px'; |
|
return true; // boolean |
|
} |
|
|
|
dojo.html.styleSheet = null; |
|
|
|
// FIXME: this is a really basic stub for adding and removing cssRules, but |
|
// it assumes that you know the index of the cssRule that you want to add |
|
// or remove, making it less than useful. So we need something that can |
|
// search for the selector that you you want to remove. |
|
dojo.html.insertCssRule = function(/* string */selector, /* string */declaration, /* integer? */index) { |
|
// summary |
|
// Attempt to insert declaration as selector on the internal stylesheet; if index try to set it there. |
|
if (!dojo.html.styleSheet) { |
|
if (document.createStyleSheet) { // IE |
|
dojo.html.styleSheet = document.createStyleSheet(); |
|
} else if (document.styleSheets[0]) { // rest |
|
// FIXME: should create a new style sheet here |
|
// fall back on an exsiting style sheet |
|
dojo.html.styleSheet = document.styleSheets[0]; |
|
} else { |
|
return null; // integer |
|
} // fail |
|
} |
|
|
|
if (arguments.length < 3) { // index may == 0 |
|
if (dojo.html.styleSheet.cssRules) { // W3 |
|
index = dojo.html.styleSheet.cssRules.length; |
|
} else if (dojo.html.styleSheet.rules) { // IE |
|
index = dojo.html.styleSheet.rules.length; |
|
} else { |
|
return null; // integer |
|
} // fail |
|
} |
|
|
|
if (dojo.html.styleSheet.insertRule) { // W3 |
|
var rule = selector + " { " + declaration + " }"; |
|
return dojo.html.styleSheet.insertRule(rule, index); // integer |
|
} else if (dojo.html.styleSheet.addRule) { // IE |
|
return dojo.html.styleSheet.addRule(selector, declaration, index); // integer |
|
} else { |
|
return null; // integer |
|
} // fail |
|
} |
|
|
|
dojo.html.removeCssRule = function(/* integer? */index){ |
|
// summary |
|
// Attempt to remove the rule at index. |
|
if(!dojo.html.styleSheet){ |
|
dojo.debug("no stylesheet defined for removing rules"); |
|
return false; |
|
} |
|
if(dojo.render.html.ie){ |
|
if(!index){ |
|
index = dojo.html.styleSheet.rules.length; |
|
dojo.html.styleSheet.removeRule(index); |
|
} |
|
}else if(document.styleSheets[0]){ |
|
if(!index){ |
|
index = dojo.html.styleSheet.cssRules.length; |
|
} |
|
dojo.html.styleSheet.deleteRule(index); |
|
} |
|
return true; // boolean |
|
} |
|
|
|
dojo.html._insertedCssFiles = []; // cache container needed because IE reformats cssText when added to DOM |
|
dojo.html.insertCssFile = function(/* string */URI, /* HTMLDocument? */doc, /* boolean? */checkDuplicates, /* boolean */fail_ok){ |
|
// summary |
|
// calls css by XmlHTTP and inserts it into DOM as <style [widgetType="widgetType"]> *downloaded cssText*</style> |
|
if(!URI){ return; } |
|
if(!doc){ doc = document; } |
|
var cssStr = dojo.hostenv.getText(URI, false, fail_ok); |
|
if(cssStr===null){ return; } |
|
cssStr = dojo.html.fixPathsInCssText(cssStr, URI); |
|
|
|
if(checkDuplicates){ |
|
var idx = -1, node, ent = dojo.html._insertedCssFiles; |
|
for(var i = 0; i < ent.length; i++){ |
|
if((ent[i].doc == doc) && (ent[i].cssText == cssStr)){ |
|
idx = i; node = ent[i].nodeRef; |
|
break; |
|
} |
|
} |
|
// make sure we havent deleted our node |
|
if(node){ |
|
var styles = doc.getElementsByTagName("style"); |
|
for(var i = 0; i < styles.length; i++){ |
|
if(styles[i] == node){ |
|
return; |
|
} |
|
} |
|
// delete this entry |
|
dojo.html._insertedCssFiles.shift(idx, 1); |
|
} |
|
} |
|
|
|
var style = dojo.html.insertCssText(cssStr, doc); |
|
dojo.html._insertedCssFiles.push({'doc': doc, 'cssText': cssStr, 'nodeRef': style}); |
|
|
|
// insert custom attribute ex dbgHref="../foo.css" usefull when debugging in DOM inspectors, no? |
|
if(style && djConfig.isDebug){ |
|
style.setAttribute("dbgHref", URI); |
|
} |
|
return style; // HTMLStyleElement |
|
} |
|
|
|
dojo.html.insertCssText = function(/* string */cssStr, /* HTMLDocument? */doc, /* string? */URI){ |
|
// summary |
|
// Attempt to insert CSS rules into the document through inserting a style element |
|
// DomNode Style = insertCssText(String ".dojoMenu {color: green;}"[, DomDoc document, dojo.uri.Uri Url ]) |
|
if(!cssStr){ |
|
return; // HTMLStyleElement |
|
} |
|
if(!doc){ doc = document; } |
|
if(URI){// fix paths in cssStr |
|
cssStr = dojo.html.fixPathsInCssText(cssStr, URI); |
|
} |
|
var style = doc.createElement("style"); |
|
style.setAttribute("type", "text/css"); |
|
// IE is b0rken enough to require that we add the element to the doc |
|
// before changing it's properties |
|
var head = doc.getElementsByTagName("head")[0]; |
|
if(!head){ // must have a head tag |
|
dojo.debug("No head tag in document, aborting styles"); |
|
return; // HTMLStyleElement |
|
}else{ |
|
head.appendChild(style); |
|
} |
|
if(style.styleSheet){// IE |
|
var setFunc = function(){ |
|
try{ |
|
style.styleSheet.cssText = cssStr; |
|
}catch(e){ dojo.debug(e); } |
|
}; |
|
if(style.styleSheet.disabled){ |
|
setTimeout(setFunc, 10); |
|
}else{ |
|
setFunc(); |
|
} |
|
}else{ // w3c |
|
var cssText = doc.createTextNode(cssStr); |
|
style.appendChild(cssText); |
|
} |
|
return style; // HTMLStyleElement |
|
} |
|
|
|
dojo.html.fixPathsInCssText = function(/* string */cssStr, /* string */URI){ |
|
// summary |
|
// usage: cssText comes from dojoroot/src/widget/templates/Foobar.css |
|
// it has .dojoFoo { background-image: url(images/bar.png);} then uri should point to dojoroot/src/widget/templates/ |
|
if(!cssStr || !URI){ return; } |
|
var match, str = "", url = "", urlChrs = "[\\t\\s\\w\\(\\)\\/\\.\\\\'\"-:#=&?~]+"; |
|
var regex = new RegExp('url\\(\\s*('+urlChrs+')\\s*\\)'); |
|
var regexProtocol = /(file|https?|ftps?):\/\//; |
|
regexTrim = new RegExp("^[\\s]*(['\"]?)("+urlChrs+")\\1[\\s]*?$"); |
|
if(dojo.render.html.ie55 || dojo.render.html.ie60){ |
|
var regexIe = new RegExp("AlphaImageLoader\\((.*)src\=['\"]("+urlChrs+")['\"]"); |
|
// TODO: need to decide how to handle relative paths and AlphaImageLoader see #1441 |
|
// current implementation breaks on build with intern_strings |
|
while(match = regexIe.exec(cssStr)){ |
|
url = match[2].replace(regexTrim, "$2"); |
|
if(!regexProtocol.exec(url)){ |
|
url = (new dojo.uri.Uri(URI, url).toString()); |
|
} |
|
str += cssStr.substring(0, match.index) + "AlphaImageLoader(" + match[1] + "src='" + url + "'"; |
|
cssStr = cssStr.substr(match.index + match[0].length); |
|
} |
|
cssStr = str + cssStr; |
|
str = ""; |
|
} |
|
|
|
while(match = regex.exec(cssStr)){ |
|
url = match[1].replace(regexTrim, "$2"); |
|
if(!regexProtocol.exec(url)){ |
|
url = (new dojo.uri.Uri(URI, url).toString()); |
|
} |
|
str += cssStr.substring(0, match.index) + "url(" + url + ")"; |
|
cssStr = cssStr.substr(match.index + match[0].length); |
|
} |
|
return str + cssStr; // string |
|
} |
|
|
|
dojo.html.setActiveStyleSheet = function(/* string */title){ |
|
// summary |
|
// Activate style sheet with specified title. |
|
var i = 0, a, els = dojo.doc().getElementsByTagName("link"); |
|
while (a = els[i++]) { |
|
if(a.getAttribute("rel").indexOf("style") != -1 && a.getAttribute("title")){ |
|
a.disabled = true; |
|
if (a.getAttribute("title") == title) { a.disabled = false; } |
|
} |
|
} |
|
} |
|
|
|
dojo.html.getActiveStyleSheet = function(){ |
|
// summary |
|
// return the title of the currently active stylesheet |
|
var i = 0, a, els = dojo.doc().getElementsByTagName("link"); |
|
while (a = els[i++]) { |
|
if (a.getAttribute("rel").indexOf("style") != -1 |
|
&& a.getAttribute("title") |
|
&& !a.disabled |
|
){ |
|
return a.getAttribute("title"); // string |
|
} |
|
} |
|
return null; // string |
|
} |
|
|
|
dojo.html.getPreferredStyleSheet = function(){ |
|
// summary |
|
// Return the preferred stylesheet title (i.e. link without alt attribute) |
|
var i = 0, a, els = dojo.doc().getElementsByTagName("link"); |
|
while (a = els[i++]) { |
|
if(a.getAttribute("rel").indexOf("style") != -1 |
|
&& a.getAttribute("rel").indexOf("alt") == -1 |
|
&& a.getAttribute("title") |
|
){ |
|
return a.getAttribute("title"); // string |
|
} |
|
} |
|
return null; // string |
|
} |
|
|
|
dojo.html.applyBrowserClass = function(/* HTMLElement */node){ |
|
// summary |
|
// Applies pre-set class names based on browser & version to the passed node. |
|
// Modified version of Morris' CSS hack. |
|
var drh=dojo.render.html; |
|
var classes = { |
|
dj_ie: drh.ie, |
|
dj_ie55: drh.ie55, |
|
dj_ie6: drh.ie60, |
|
dj_ie7: drh.ie70, |
|
dj_iequirks: drh.ie && drh.quirks, |
|
dj_opera: drh.opera, |
|
dj_opera8: drh.opera && (Math.floor(dojo.render.version)==8), |
|
dj_opera9: drh.opera && (Math.floor(dojo.render.version)==9), |
|
dj_khtml: drh.khtml, |
|
dj_safari: drh.safari, |
|
dj_gecko: drh.mozilla |
|
}; // no dojo unsupported browsers |
|
for(var p in classes){ |
|
if(classes[p]){ |
|
dojo.html.addClass(node, p); |
|
} |
|
} |
|
}; |
|
|
|
dojo.provide("dojo.html.display"); |
|
|
|
|
|
dojo.html._toggle = function(node, tester, setter){ |
|
node = dojo.byId(node); |
|
setter(node, !tester(node)); |
|
return tester(node); |
|
} |
|
|
|
dojo.html.show = function(/* HTMLElement */node){ |
|
// summary |
|
// Show the passed element by reverting display property set by dojo.html.hide |
|
node = dojo.byId(node); |
|
if(dojo.html.getStyleProperty(node, 'display')=='none'){ |
|
dojo.html.setStyle(node, 'display', (node.dojoDisplayCache||'')); |
|
node.dojoDisplayCache = undefined; // cannot use delete on a node in IE6 |
|
} |
|
} |
|
|
|
dojo.html.hide = function(/* HTMLElement */node){ |
|
// summary |
|
// Hide the passed element by setting display:none |
|
node = dojo.byId(node); |
|
if(typeof node["dojoDisplayCache"] == "undefined"){ // it could == '', so we cannot say !node.dojoDisplayCount |
|
var d = dojo.html.getStyleProperty(node, 'display') |
|
if(d!='none'){ |
|
node.dojoDisplayCache = d; |
|
} |
|
} |
|
dojo.html.setStyle(node, 'display', 'none'); |
|
} |
|
|
|
dojo.html.setShowing = function(/* HTMLElement */node, /* boolean? */showing){ |
|
// summary |
|
// Calls show() if showing is true, hide() otherwise |
|
dojo.html[(showing ? 'show' : 'hide')](node); |
|
} |
|
|
|
dojo.html.isShowing = function(/* HTMLElement */node){ |
|
// summary |
|
// Returns whether the element is displayed or not. |
|
// FIXME: returns true if node is bad, isHidden would be easier to make correct |
|
return (dojo.html.getStyleProperty(node, 'display') != 'none'); // boolean |
|
} |
|
|
|
dojo.html.toggleShowing = function(/* HTMLElement */node){ |
|
// summary |
|
// Call setShowing() on node with the complement of isShowing(), then return the new value of isShowing() |
|
return dojo.html._toggle(node, dojo.html.isShowing, dojo.html.setShowing); // boolean |
|
} |
|
|
|
// Simple mapping of tag names to display values |
|
// FIXME: simplistic |
|
dojo.html.displayMap = { tr: '', td: '', th: '', img: 'inline', span: 'inline', input: 'inline', button: 'inline' }; |
|
|
|
dojo.html.suggestDisplayByTagName = function(/* HTMLElement */node){ |
|
// summary |
|
// Suggest a value for the display property that will show 'node' based on it's tag |
|
node = dojo.byId(node); |
|
if(node && node.tagName){ |
|
var tag = node.tagName.toLowerCase(); |
|
return (tag in dojo.html.displayMap ? dojo.html.displayMap[tag] : 'block'); // string |
|
} |
|
} |
|
|
|
dojo.html.setDisplay = function(/* HTMLElement */node, /* string */display){ |
|
// summary |
|
// Sets the value of style.display to value of 'display' parameter if it is a string. |
|
// Otherwise, if 'display' is false, set style.display to 'none'. |
|
// Finally, set 'display' to a suggested display value based on the node's tag |
|
dojo.html.setStyle(node, 'display', ((display instanceof String || typeof display == "string") ? display : (display ? dojo.html.suggestDisplayByTagName(node) : 'none'))); |
|
} |
|
|
|
dojo.html.isDisplayed = function(/* HTMLElement */node){ |
|
// summary |
|
// Is true if the the computed display style for node is not 'none' |
|
// FIXME: returns true if node is bad, isNotDisplayed would be easier to make correct |
|
return (dojo.html.getComputedStyle(node, 'display') != 'none'); // boolean |
|
} |
|
|
|
dojo.html.toggleDisplay = function(/* HTMLElement */node){ |
|
// summary |
|
// Call setDisplay() on node with the complement of isDisplayed(), then |
|
// return the new value of isDisplayed() |
|
return dojo.html._toggle(node, dojo.html.isDisplayed, dojo.html.setDisplay); // boolean |
|
} |
|
|
|
dojo.html.setVisibility = function(/* HTMLElement */node, /* string */visibility){ |
|
// summary |
|
// Sets the value of style.visibility to value of 'visibility' parameter if it is a string. |
|
// Otherwise, if 'visibility' is false, set style.visibility to 'hidden'. Finally, set style.visibility to 'visible'. |
|
dojo.html.setStyle(node, 'visibility', ((visibility instanceof String || typeof visibility == "string") ? visibility : (visibility ? 'visible' : 'hidden'))); |
|
} |
|
|
|
dojo.html.isVisible = function(/* HTMLElement */node){ |
|
// summary |
|
// Returns true if the the computed visibility style for node is not 'hidden' |
|
// FIXME: returns true if node is bad, isInvisible would be easier to make correct |
|
return (dojo.html.getComputedStyle(node, 'visibility') != 'hidden'); // boolean |
|
} |
|
|
|
dojo.html.toggleVisibility = function(node){ |
|
// summary |
|
// Call setVisibility() on node with the complement of isVisible(), then return the new value of isVisible() |
|
return dojo.html._toggle(node, dojo.html.isVisible, dojo.html.setVisibility); // boolean |
|
} |
|
|
|
dojo.html.setOpacity = function(/* HTMLElement */node, /* float */opacity, /* boolean? */dontFixOpacity){ |
|
// summary |
|
// Sets the opacity of node in a cross-browser way. |
|
// float between 0.0 (transparent) and 1.0 (opaque) |
|
node = dojo.byId(node); |
|
var h = dojo.render.html; |
|
if(!dontFixOpacity){ |
|
if( opacity >= 1.0){ |
|
if(h.ie){ |
|
dojo.html.clearOpacity(node); |
|
return; |
|
}else{ |
|
opacity = 0.999999; |
|
} |
|
}else if( opacity < 0.0){ opacity = 0; } |
|
} |
|
if(h.ie){ |
|
if(node.nodeName.toLowerCase() == "tr"){ |
|
// FIXME: is this too naive? will we get more than we want? |
|
var tds = node.getElementsByTagName("td"); |
|
for(var x=0; x<tds.length; x++){ |
|
tds[x].style.filter = "Alpha(Opacity="+opacity*100+")"; |
|
} |
|
} |
|
node.style.filter = "Alpha(Opacity="+opacity*100+")"; |
|
}else if(h.moz){ |
|
node.style.opacity = opacity; // ffox 1.0 directly supports "opacity" |
|
node.style.MozOpacity = opacity; |
|
}else if(h.safari){ |
|
node.style.opacity = opacity; // 1.3 directly supports "opacity" |
|
node.style.KhtmlOpacity = opacity; |
|
}else{ |
|
node.style.opacity = opacity; |
|
} |
|
} |
|
|
|
dojo.html.clearOpacity = function(/* HTMLElement */node){ |
|
// summary |
|
// Clears any opacity setting on the passed element. |
|
node = dojo.byId(node); |
|
var ns = node.style; |
|
var h = dojo.render.html; |
|
if(h.ie){ |
|
try { |
|
if( node.filters && node.filters.alpha ){ |
|
ns.filter = ""; // FIXME: may get rid of other filter effects |
|
} |
|
} catch(e) { |
|
/* |
|
* IE7 gives error if node.filters not set; |
|
* don't know why or how to workaround (other than this) |
|
*/ |
|
} |
|
}else if(h.moz){ |
|
ns.opacity = 1; |
|
ns.MozOpacity = 1; |
|
}else if(h.safari){ |
|
ns.opacity = 1; |
|
ns.KhtmlOpacity = 1; |
|
}else{ |
|
ns.opacity = 1; |
|
} |
|
} |
|
|
|
dojo.html.getOpacity = function(/* HTMLElement */node){ |
|
// summary |
|
// Returns the opacity of the passed element |
|
node = dojo.byId(node); |
|
var h = dojo.render.html; |
|
if(h.ie){ |
|
var opac = (node.filters && node.filters.alpha && |
|
typeof node.filters.alpha.opacity == "number" |
|
? node.filters.alpha.opacity : 100) / 100; |
|
}else{ |
|
var opac = node.style.opacity || node.style.MozOpacity || |
|
node.style.KhtmlOpacity || 1; |
|
} |
|
return opac >= 0.999999 ? 1.0 : Number(opac); // float |
|
} |
|
|
|
|
|
dojo.provide("dojo.html.color"); |
|
|
|
|
|
|
|
|
|
dojo.html.getBackgroundColor = function(/* HTMLElement */node){ |
|
// summary |
|
// returns the background color of the passed node as a 32-bit color (RGBA) |
|
node = dojo.byId(node); |
|
var color; |
|
do{ |
|
color = dojo.html.getStyle(node, "background-color"); |
|
// Safari doesn't say "transparent" |
|
if(color.toLowerCase() == "rgba(0, 0, 0, 0)") { color = "transparent"; } |
|
if(node == document.getElementsByTagName("body")[0]) { node = null; break; } |
|
node = node.parentNode; |
|
}while(node && dojo.lang.inArray(["transparent", ""], color)); |
|
if(color == "transparent"){ |
|
color = [255, 255, 255, 0]; |
|
}else{ |
|
color = dojo.gfx.color.extractRGB(color); |
|
} |
|
return color; // array |
|
} |
|
|
|
dojo.provide("dojo.html.layout"); |
|
|
|
|
|
|
|
|
|
|
|
dojo.html.sumAncestorProperties = function(/* HTMLElement */node, /* string */prop){ |
|
// summary |
|
// Returns the sum of the passed property on all ancestors of node. |
|
node = dojo.byId(node); |
|
if(!node){ return 0; } // FIXME: throw an error? |
|
|
|
var retVal = 0; |
|
while(node){ |
|
if(dojo.html.getComputedStyle(node, 'position') == 'fixed'){ |
|
return 0; |
|
} |
|
var val = node[prop]; |
|
if(val){ |
|
retVal += val - 0; |
|
if(node==dojo.body()){ break; }// opera and khtml #body & #html has the same values, we only need one value |
|
} |
|
node = node.parentNode; |
|
} |
|
return retVal; // integer |
|
} |
|
|
|
dojo.html.setStyleAttributes = function(/* HTMLElement */node, /* string */attributes) { |
|
// summary |
|
// allows a dev to pass a string similar to what you'd pass in style="", and apply it to a node. |
|
node = dojo.byId(node); |
|
var splittedAttribs=attributes.replace(/(;)?\s*$/, "").split(";"); |
|
for(var i=0; i<splittedAttribs.length; i++){ |
|
var nameValue=splittedAttribs[i].split(":"); |
|
var name=nameValue[0].replace(/\s*$/, "").replace(/^\s*/, "").toLowerCase(); |
|
var value=nameValue[1].replace(/\s*$/, "").replace(/^\s*/, ""); |
|
switch(name){ |
|
case "opacity": |
|
dojo.html.setOpacity(node, value); |
|
break; |
|
case "content-height": |
|
dojo.html.setContentBox(node, {height: value}); |
|
break; |
|
case "content-width": |
|
dojo.html.setContentBox(node, {width: value}); |
|
break; |
|
case "outer-height": |
|
dojo.html.setMarginBox(node, {height: value}); |
|
break; |
|
case "outer-width": |
|
dojo.html.setMarginBox(node, {width: value}); |
|
break; |
|
default: |
|
node.style[dojo.html.toCamelCase(name)]=value; |
|
} |
|
} |
|
} |
|
|
|
dojo.html.boxSizing = { |
|
MARGIN_BOX: "margin-box", |
|
BORDER_BOX: "border-box", |
|
PADDING_BOX: "padding-box", |
|
CONTENT_BOX: "content-box" |
|
}; |
|
|
|
dojo.html.getAbsolutePosition = dojo.html.abs = function(/* HTMLElement */node, /* boolean? */includeScroll, /* string? */boxType){ |
|
// summary |
|
// Gets the absolute position of the passed element based on the document itself. |
|
node = dojo.byId(node, node.ownerDocument); |
|
var ret = { |
|
x: 0, |
|
y: 0 |
|
}; |
|
|
|
var bs = dojo.html.boxSizing; |
|
if(!boxType) { boxType = bs.CONTENT_BOX; } |
|
var nativeBoxType = 2; //BORDER box |
|
var targetBoxType; |
|
switch(boxType){ |
|
case bs.MARGIN_BOX: |
|
targetBoxType = 3; |
|
break; |
|
case bs.BORDER_BOX: |
|
targetBoxType = 2; |
|
break; |
|
case bs.PADDING_BOX: |
|
default: |
|
targetBoxType = 1; |
|
break; |
|
case bs.CONTENT_BOX: |
|
targetBoxType = 0; |
|
break; |
|
} |
|
|
|
var h = dojo.render.html; |
|
var db = document["body"]||document["documentElement"]; |
|
|
|
if(h.ie){ |
|
with(node.getBoundingClientRect()){ |
|
ret.x = left-2; |
|
ret.y = top-2; |
|
} |
|
}else if(document.getBoxObjectFor){ |
|
// mozilla |
|
nativeBoxType = 1; //getBoxObjectFor return padding box coordinate |
|
try{ |
|
var bo = document.getBoxObjectFor(node); |
|
ret.x = bo.x - dojo.html.sumAncestorProperties(node, "scrollLeft"); |
|
ret.y = bo.y - dojo.html.sumAncestorProperties(node, "scrollTop"); |
|
}catch(e){ |
|
// squelch |
|
} |
|
}else{ |
|
if(node["offsetParent"]){ |
|
var endNode; |
|
// in Safari, if the node is an absolutely positioned child of |
|
// the body and the body has a margin the offset of the child |
|
// and the body contain the body's margins, so we need to end |
|
// at the body |
|
if( (h.safari)&& |
|
(node.style.getPropertyValue("position") == "absolute")&& |
|
(node.parentNode == db)){ |
|
endNode = db; |
|
}else{ |
|
endNode = db.parentNode; |
|
} |
|
|
|
//TODO: set correct nativeBoxType for safari/konqueror |
|
|
|
if(node.parentNode != db){ |
|
var nd = node; |
|
if(dojo.render.html.opera){ nd = db; } |
|
ret.x -= dojo.html.sumAncestorProperties(nd, "scrollLeft"); |
|
ret.y -= dojo.html.sumAncestorProperties(nd, "scrollTop"); |
|
} |
|
var curnode = node; |
|
do{ |
|
var n = curnode["offsetLeft"]; |
|
//FIXME: ugly hack to workaround the submenu in |
|
//popupmenu2 does not shown up correctly in opera. |
|
//Someone have a better workaround? |
|
if(!h.opera || n>0){ |
|
ret.x += isNaN(n) ? 0 : n; |
|
} |
|
var m = curnode["offsetTop"]; |
|
ret.y += isNaN(m) ? 0 : m; |
|
curnode = curnode.offsetParent; |
|
}while((curnode != endNode)&&(curnode != null)); |
|
}else if(node["x"]&&node["y"]){ |
|
ret.x += isNaN(node.x) ? 0 : node.x; |
|
ret.y += isNaN(node.y) ? 0 : node.y; |
|
} |
|
} |
|
|
|
// account for document scrolling! |
|
if(includeScroll){ |
|
var scroll = dojo.html.getScroll(); |
|
ret.y += scroll.top; |
|
ret.x += scroll.left; |
|
} |
|
|
|
var extentFuncArray=[dojo.html.getPaddingExtent, dojo.html.getBorderExtent, dojo.html.getMarginExtent]; |
|
if(nativeBoxType > targetBoxType){ |
|
for(var i=targetBoxType;i<nativeBoxType;++i){ |
|
ret.y += extentFuncArray[i](node, 'top'); |
|
ret.x += extentFuncArray[i](node, 'left'); |
|
} |
|
}else if(nativeBoxType < targetBoxType){ |
|
for(var i=targetBoxType;i>nativeBoxType;--i){ |
|
ret.y -= extentFuncArray[i-1](node, 'top'); |
|
ret.x -= extentFuncArray[i-1](node, 'left'); |
|
} |
|
} |
|
ret.top = ret.y; |
|
ret.left = ret.x; |
|
return ret; // object |
|
} |
|
|
|
dojo.html.isPositionAbsolute = function(/* HTMLElement */node){ |
|
// summary |
|
// Returns true if the element is absolutely positioned. |
|
return (dojo.html.getComputedStyle(node, 'position') == 'absolute'); // boolean |
|
} |
|
|
|
dojo.html._sumPixelValues = function(/* HTMLElement */node, selectors, autoIsZero){ |
|
var total = 0; |
|
for(var x=0; x<selectors.length; x++){ |
|
total += dojo.html.getPixelValue(node, selectors[x], autoIsZero); |
|
} |
|
return total; |
|
} |
|
|
|
dojo.html.getMargin = function(/* HTMLElement */node){ |
|
// summary |
|
// Returns the width and height of the passed node's margin |
|
return { |
|
width: dojo.html._sumPixelValues(node, ["margin-left", "margin-right"], (dojo.html.getComputedStyle(node, 'position') == 'absolute')), |
|
height: dojo.html._sumPixelValues(node, ["margin-top", "margin-bottom"], (dojo.html.getComputedStyle(node, 'position') == 'absolute')) |
|
}; // object |
|
} |
|
|
|
dojo.html.getBorder = function(/* HTMLElement */node){ |
|
// summary |
|
// Returns the width and height of the passed node's border |
|
return { |
|
width: dojo.html.getBorderExtent(node, 'left') + dojo.html.getBorderExtent(node, 'right'), |
|
height: dojo.html.getBorderExtent(node, 'top') + dojo.html.getBorderExtent(node, 'bottom') |
|
}; // object |
|
} |
|
|
|
dojo.html.getBorderExtent = function(/* HTMLElement */node, /* string */side){ |
|
// summary |
|
// returns the width of the requested border |
|
return (dojo.html.getStyle(node, 'border-' + side + '-style') == 'none' ? 0 : dojo.html.getPixelValue(node, 'border-' + side + '-width')); // integer |
|
} |
|
|
|
dojo.html.getMarginExtent = function(/* HTMLElement */node, /* string */side){ |
|
// summary |
|
// returns the width of the requested margin |
|
return dojo.html._sumPixelValues(node, ["margin-" + side], dojo.html.isPositionAbsolute(node)); // integer |
|
} |
|
|
|
dojo.html.getPaddingExtent = function(/* HTMLElement */node, /* string */side){ |
|
// summary |
|
// Returns the width of the requested padding |
|
return dojo.html._sumPixelValues(node, ["padding-" + side], true); // integer |
|
} |
|
|
|
dojo.html.getPadding = function(/* HTMLElement */node){ |
|
// summary |
|
// Returns the width and height of the passed node's padding |
|
return { |
|
width: dojo.html._sumPixelValues(node, ["padding-left", "padding-right"], true), |
|
height: dojo.html._sumPixelValues(node, ["padding-top", "padding-bottom"], true) |
|
}; // object |
|
} |
|
|
|
dojo.html.getPadBorder = function(/* HTMLElement */node){ |
|
// summary |
|
// Returns the width and height of the passed node's padding and border |
|
var pad = dojo.html.getPadding(node); |
|
var border = dojo.html.getBorder(node); |
|
return { width: pad.width + border.width, height: pad.height + border.height }; // object |
|
} |
|
|
|
dojo.html.getBoxSizing = function(/* HTMLElement */node){ |
|
// summary |
|
// Returns which box model the passed element is working with |
|
var h = dojo.render.html; |
|
var bs = dojo.html.boxSizing; |
|
if(((h.ie)||(h.opera)) && node.nodeName.toLowerCase() != "img"){ |
|
var cm = document["compatMode"]; |
|
if((cm == "BackCompat")||(cm == "QuirksMode")){ |
|
return bs.BORDER_BOX; // string |
|
}else{ |
|
return bs.CONTENT_BOX; // string |
|
} |
|
}else{ |
|
if(arguments.length == 0){ node = document.documentElement; } |
|
var sizing; |
|
if(!h.ie){ |
|
sizing = dojo.html.getStyle(node, "-moz-box-sizing"); |
|
if(!sizing){ |
|
sizing = dojo.html.getStyle(node, "box-sizing"); |
|
} |
|
} |
|
return (sizing ? sizing : bs.CONTENT_BOX); // string |
|
} |
|
} |
|
|
|
dojo.html.isBorderBox = function(/* HTMLElement */node){ |
|
// summary |
|
// returns whether the passed element is using border box sizing or not. |
|
return (dojo.html.getBoxSizing(node) == dojo.html.boxSizing.BORDER_BOX); // boolean |
|
} |
|
|
|
dojo.html.getBorderBox = function(/* HTMLElement */node){ |
|
// summary |
|
// Returns the dimensions of the passed element based on border-box sizing. |
|
node = dojo.byId(node); |
|
return { width: node.offsetWidth, height: node.offsetHeight }; // object |
|
} |
|
|
|
dojo.html.getPaddingBox = function(/* HTMLElement */node){ |
|
// summary |
|
// Returns the dimensions of the padding box (see http://www.w3.org/TR/CSS21/box.html) |
|
var box = dojo.html.getBorderBox(node); |
|
var border = dojo.html.getBorder(node); |
|
return { |
|
width: box.width - border.width, |
|
height:box.height - border.height |
|
}; // object |
|
} |
|
|
|
dojo.html.getContentBox = function(/* HTMLElement */node){ |
|
// summary |
|
// Returns the dimensions of the content box (see http://www.w3.org/TR/CSS21/box.html) |
|
node = dojo.byId(node); |
|
var padborder = dojo.html.getPadBorder(node); |
|
return { |
|
width: node.offsetWidth - padborder.width, |
|
height: node.offsetHeight - padborder.height |
|
}; // object |
|
} |
|
|
|
dojo.html.setContentBox = function(/* HTMLElement */node, /* object */args){ |
|
// summary |
|
// Sets the dimensions of the passed node according to content sizing. |
|
node = dojo.byId(node); |
|
var width = 0; var height = 0; |
|
var isbb = dojo.html.isBorderBox(node); |
|
var padborder = (isbb ? dojo.html.getPadBorder(node) : { width: 0, height: 0}); |
|
var ret = {}; |
|
if(typeof args.width != "undefined"){ |
|
width = args.width + padborder.width; |
|
ret.width = dojo.html.setPositivePixelValue(node, "width", width); |
|
} |
|
if(typeof args.height != "undefined"){ |
|
height = args.height + padborder.height; |
|
ret.height = dojo.html.setPositivePixelValue(node, "height", height); |
|
} |
|
return ret; // object |
|
} |
|
|
|
dojo.html.getMarginBox = function(/* HTMLElement */node){ |
|
// summary |
|
// returns the dimensions of the passed node including any margins. |
|
var borderbox = dojo.html.getBorderBox(node); |
|
var margin = dojo.html.getMargin(node); |
|
return { width: borderbox.width + margin.width, height: borderbox.height + margin.height }; // object |
|
} |
|
|
|
dojo.html.setMarginBox = function(/* HTMLElement */node, /* object */args){ |
|
// summary |
|
// Sets the dimensions of the passed node using margin box calcs. |
|
node = dojo.byId(node); |
|
var width = 0; var height = 0; |
|
var isbb = dojo.html.isBorderBox(node); |
|
var padborder = (!isbb ? dojo.html.getPadBorder(node) : { width: 0, height: 0 }); |
|
var margin = dojo.html.getMargin(node); |
|
var ret = {}; |
|
if(typeof args.width != "undefined"){ |
|
width = args.width - padborder.width; |
|
width -= margin.width; |
|
ret.width = dojo.html.setPositivePixelValue(node, "width", width); |
|
} |
|
if(typeof args.height != "undefined"){ |
|
height = args.height - padborder.height; |
|
height -= margin.height; |
|
ret.height = dojo.html.setPositivePixelValue(node, "height", height); |
|
} |
|
return ret; // object |
|
} |
|
|
|
dojo.html.getElementBox = function(/* HTMLElement */node, /* string */type){ |
|
// summary |
|
// return dimesions of a node based on the passed box model type. |
|
var bs = dojo.html.boxSizing; |
|
switch(type){ |
|
case bs.MARGIN_BOX: |
|
return dojo.html.getMarginBox(node); // object |
|
case bs.BORDER_BOX: |
|
return dojo.html.getBorderBox(node); // object |
|
case bs.PADDING_BOX: |
|
return dojo.html.getPaddingBox(node); // object |
|
case bs.CONTENT_BOX: |
|
default: |
|
return dojo.html.getContentBox(node); // object |
|
} |
|
} |
|
// in: coordinate array [x,y,w,h] or dom node |
|
// return: coordinate object |
|
dojo.html.toCoordinateObject = dojo.html.toCoordinateArray = function(/* array */coords, /* boolean? */includeScroll, /* string? */boxtype) { |
|
// summary |
|
// Converts an array of coordinates into an object of named arguments. |
|
if(coords instanceof Array || typeof coords == "array"){ |
|
dojo.deprecated("dojo.html.toCoordinateArray", "use dojo.html.toCoordinateObject({left: , top: , width: , height: }) instead", "0.5"); |
|
// coords is already an array (of format [x,y,w,h]), just return it |
|
while ( coords.length < 4 ) { coords.push(0); } |
|
while ( coords.length > 4 ) { coords.pop(); } |
|
var ret = { |
|
left: coords[0], |
|
top: coords[1], |
|
width: coords[2], |
|
height: coords[3] |
|
}; |
|
}else if(!coords.nodeType && !(coords instanceof String || typeof coords == "string") && |
|
('width' in coords || 'height' in coords || 'left' in coords || |
|
'x' in coords || 'top' in coords || 'y' in coords)){ |
|
// coords is a coordinate object or at least part of one |
|
var ret = { |
|
left: coords.left||coords.x||0, |
|
top: coords.top||coords.y||0, |
|
width: coords.width||0, |
|
height: coords.height||0 |
|
}; |
|
}else{ |
|
// coords is an dom object (or dom object id); return it's coordinates |
|
var node = dojo.byId(coords); |
|
var pos = dojo.html.abs(node, includeScroll, boxtype); |
|
var marginbox = dojo.html.getMarginBox(node); |
|
var ret = { |
|
left: pos.left, |
|
top: pos.top, |
|
width: marginbox.width, |
|
height: marginbox.height |
|
}; |
|
} |
|
ret.x = ret.left; |
|
ret.y = ret.top; |
|
return ret; // object |
|
} |
|
|
|
dojo.html.setMarginBoxWidth = dojo.html.setOuterWidth = function(node, width){ |
|
return dojo.html._callDeprecated("setMarginBoxWidth", "setMarginBox", arguments, "width"); |
|
} |
|
dojo.html.setMarginBoxHeight = dojo.html.setOuterHeight = function(){ |
|
return dojo.html._callDeprecated("setMarginBoxHeight", "setMarginBox", arguments, "height"); |
|
} |
|
dojo.html.getMarginBoxWidth = dojo.html.getOuterWidth = function(){ |
|
return dojo.html._callDeprecated("getMarginBoxWidth", "getMarginBox", arguments, null, "width"); |
|
} |
|
dojo.html.getMarginBoxHeight = dojo.html.getOuterHeight = function(){ |
|
return dojo.html._callDeprecated("getMarginBoxHeight", "getMarginBox", arguments, null, "height"); |
|
} |
|
dojo.html.getTotalOffset = function(node, type, includeScroll){ |
|
return dojo.html._callDeprecated("getTotalOffset", "getAbsolutePosition", arguments, null, type); |
|
} |
|
dojo.html.getAbsoluteX = function(node, includeScroll){ |
|
return dojo.html._callDeprecated("getAbsoluteX", "getAbsolutePosition", arguments, null, "x"); |
|
} |
|
dojo.html.getAbsoluteY = function(node, includeScroll){ |
|
return dojo.html._callDeprecated("getAbsoluteY", "getAbsolutePosition", arguments, null, "y"); |
|
} |
|
dojo.html.totalOffsetLeft = function(node, includeScroll){ |
|
return dojo.html._callDeprecated("totalOffsetLeft", "getAbsolutePosition", arguments, null, "left"); |
|
} |
|
dojo.html.totalOffsetTop = function(node, includeScroll){ |
|
return dojo.html._callDeprecated("totalOffsetTop", "getAbsolutePosition", arguments, null, "top"); |
|
} |
|
dojo.html.getMarginWidth = function(node){ |
|
return dojo.html._callDeprecated("getMarginWidth", "getMargin", arguments, null, "width"); |
|
} |
|
dojo.html.getMarginHeight = function(node){ |
|
return dojo.html._callDeprecated("getMarginHeight", "getMargin", arguments, null, "height"); |
|
} |
|
dojo.html.getBorderWidth = function(node){ |
|
return dojo.html._callDeprecated("getBorderWidth", "getBorder", arguments, null, "width"); |
|
} |
|
dojo.html.getBorderHeight = function(node){ |
|
return dojo.html._callDeprecated("getBorderHeight", "getBorder", arguments, null, "height"); |
|
} |
|
dojo.html.getPaddingWidth = function(node){ |
|
return dojo.html._callDeprecated("getPaddingWidth", "getPadding", arguments, null, "width"); |
|
} |
|
dojo.html.getPaddingHeight = function(node){ |
|
return dojo.html._callDeprecated("getPaddingHeight", "getPadding", arguments, null, "height"); |
|
} |
|
dojo.html.getPadBorderWidth = function(node){ |
|
return dojo.html._callDeprecated("getPadBorderWidth", "getPadBorder", arguments, null, "width"); |
|
} |
|
dojo.html.getPadBorderHeight = function(node){ |
|
return dojo.html._callDeprecated("getPadBorderHeight", "getPadBorder", arguments, null, "height"); |
|
} |
|
dojo.html.getBorderBoxWidth = dojo.html.getInnerWidth = function(){ |
|
return dojo.html._callDeprecated("getBorderBoxWidth", "getBorderBox", arguments, null, "width"); |
|
} |
|
dojo.html.getBorderBoxHeight = dojo.html.getInnerHeight = function(){ |
|
return dojo.html._callDeprecated("getBorderBoxHeight", "getBorderBox", arguments, null, "height"); |
|
} |
|
dojo.html.getContentBoxWidth = dojo.html.getContentWidth = function(){ |
|
return dojo.html._callDeprecated("getContentBoxWidth", "getContentBox", arguments, null, "width"); |
|
} |
|
dojo.html.getContentBoxHeight = dojo.html.getContentHeight = function(){ |
|
return dojo.html._callDeprecated("getContentBoxHeight", "getContentBox", arguments, null, "height"); |
|
} |
|
dojo.html.setContentBoxWidth = dojo.html.setContentWidth = function(node, width){ |
|
return dojo.html._callDeprecated("setContentBoxWidth", "setContentBox", arguments, "width"); |
|
} |
|
dojo.html.setContentBoxHeight = dojo.html.setContentHeight = function(node, height){ |
|
return dojo.html._callDeprecated("setContentBoxHeight", "setContentBox", arguments, "height"); |
|
} |
|
|
|
dojo.provide("dojo.lfx.html"); |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
dojo.lfx.html._byId = function(nodes){ |
|
if(!nodes){ return []; } |
|
if(dojo.lang.isArrayLike(nodes)){ |
|
if(!nodes.alreadyChecked){ |
|
var n = []; |
|
dojo.lang.forEach(nodes, function(node){ |
|
n.push(dojo.byId(node)); |
|
}); |
|
n.alreadyChecked = true; |
|
return n; |
|
}else{ |
|
return nodes; |
|
} |
|
}else{ |
|
var n = []; |
|
n.push(dojo.byId(nodes)); |
|
n.alreadyChecked = true; |
|
return n; |
|
} |
|
} |
|
|
|
dojo.lfx.html.propertyAnimation = function( /*DOMNode[]*/ nodes, |
|
/*Object[]*/ propertyMap, |
|
/*int*/ duration, |
|
/*function*/ easing, |
|
/*Object*/ handlers){ |
|
// summary: Returns an animation that will transition the properties of "nodes" |
|
// depending how they are defined in "propertyMap". |
|
// nodes: An array of DOMNodes or one DOMNode. |
|
// propertyMap: { property: String, start: Decimal?, end: Decimal?, units: String? } |
|
// An array of objects defining properties to change. |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// handlers: { handler: Function?, onstart: Function?, onstop: Function?, onanimate: Function? } |
|
nodes = dojo.lfx.html._byId(nodes); |
|
|
|
var targs = { |
|
"propertyMap": propertyMap, |
|
"nodes": nodes, |
|
"duration": duration, |
|
"easing": easing||dojo.lfx.easeDefault |
|
}; |
|
|
|
var setEmUp = function(args){ |
|
if(args.nodes.length==1){ |
|
// FIXME: we're only supporting start-value filling when one node is |
|
// passed |
|
|
|
var pm = args.propertyMap; |
|
if(!dojo.lang.isArray(args.propertyMap)){ |
|
// it's stupid to have to pack an array with a set of objects |
|
// when you can just pass in an object list |
|
var parr = []; |
|
for(var pname in pm){ |
|
pm[pname].property = pname; |
|
parr.push(pm[pname]); |
|
} |
|
pm = args.propertyMap = parr; |
|
} |
|
dojo.lang.forEach(pm, function(prop){ |
|
if(dj_undef("start", prop)){ |
|
if(prop.property != "opacity"){ |
|
prop.start = parseInt(dojo.html.getComputedStyle(args.nodes[0], prop.property)); |
|
}else{ |
|
prop.start = dojo.html.getOpacity(args.nodes[0]); |
|
} |
|
} |
|
}); |
|
} |
|
} |
|
|
|
var coordsAsInts = function(coords){ |
|
var cints = []; |
|
dojo.lang.forEach(coords, function(c){ |
|
cints.push(Math.round(c)); |
|
}); |
|
return cints; |
|
} |
|
|
|
var setStyle = function(n, style){ |
|
n = dojo.byId(n); |
|
if(!n || !n.style){ return; } |
|
for(var s in style){ |
|
try{ |
|
if(s == "opacity"){ |
|
dojo.html.setOpacity(n, style[s]); |
|
}else{ |
|
n.style[s] = style[s]; |
|
} |
|
}catch(e){ dojo.debug(e); } |
|
} |
|
} |
|
|
|
var propLine = function(properties){ |
|
this._properties = properties; |
|
this.diffs = new Array(properties.length); |
|
dojo.lang.forEach(properties, function(prop, i){ |
|
// calculate the end - start to optimize a bit |
|
if(dojo.lang.isFunction(prop.start)){ |
|
prop.start = prop.start(prop, i); |
|
} |
|
if(dojo.lang.isFunction(prop.end)){ |
|
prop.end = prop.end(prop, i); |
|
} |
|
if(dojo.lang.isArray(prop.start)){ |
|
// don't loop through the arrays |
|
this.diffs[i] = null; |
|
}else if(prop.start instanceof dojo.gfx.color.Color){ |
|
// save these so we don't have to call toRgb() every getValue() call |
|
prop.startRgb = prop.start.toRgb(); |
|
prop.endRgb = prop.end.toRgb(); |
|
}else{ |
|
this.diffs[i] = prop.end - prop.start; |
|
} |
|
}, this); |
|
|
|
this.getValue = function(n){ |
|
var ret = {}; |
|
dojo.lang.forEach(this._properties, function(prop, i){ |
|
var value = null; |
|
if(dojo.lang.isArray(prop.start)){ |
|
// FIXME: what to do here? |
|
}else if(prop.start instanceof dojo.gfx.color.Color){ |
|
value = (prop.units||"rgb") + "("; |
|
for(var j = 0 ; j < prop.startRgb.length ; j++){ |
|
value += Math.round(((prop.endRgb[j] - prop.startRgb[j]) * n) + prop.startRgb[j]) + (j < prop.startRgb.length - 1 ? "," : ""); |
|
} |
|
value += ")"; |
|
}else{ |
|
value = ((this.diffs[i]) * n) + prop.start + (prop.property != "opacity" ? prop.units||"px" : ""); |
|
} |
|
ret[dojo.html.toCamelCase(prop.property)] = value; |
|
}, this); |
|
return ret; |
|
} |
|
} |
|
|
|
var anim = new dojo.lfx.Animation({ |
|
beforeBegin: function(){ |
|
setEmUp(targs); |
|
anim.curve = new propLine(targs.propertyMap); |
|
}, |
|
onAnimate: function(propValues){ |
|
dojo.lang.forEach(targs.nodes, function(node){ |
|
setStyle(node, propValues); |
|
}); |
|
} |
|
}, |
|
targs.duration, |
|
null, |
|
targs.easing |
|
); |
|
if(handlers){ |
|
for(var x in handlers){ |
|
if(dojo.lang.isFunction(handlers[x])){ |
|
anim.connect(x, anim, handlers[x]); |
|
} |
|
} |
|
} |
|
|
|
return anim; // dojo.lfx.Animation |
|
} |
|
|
|
dojo.lfx.html._makeFadeable = function(nodes){ |
|
var makeFade = function(node){ |
|
if(dojo.render.html.ie){ |
|
// only set the zoom if the "tickle" value would be the same as the |
|
// default |
|
if( (node.style.zoom.length == 0) && |
|
(dojo.html.getStyle(node, "zoom") == "normal") ){ |
|
// make sure the node "hasLayout" |
|
// NOTE: this has been tested with larger and smaller user-set text |
|
// sizes and works fine |
|
node.style.zoom = "1"; |
|
// node.style.zoom = "normal"; |
|
} |
|
// don't set the width to auto if it didn't already cascade that way. |
|
// We don't want to f anyones designs |
|
if( (node.style.width.length == 0) && |
|
(dojo.html.getStyle(node, "width") == "auto") ){ |
|
node.style.width = "auto"; |
|
} |
|
} |
|
} |
|
if(dojo.lang.isArrayLike(nodes)){ |
|
dojo.lang.forEach(nodes, makeFade); |
|
}else{ |
|
makeFade(nodes); |
|
} |
|
} |
|
|
|
dojo.lfx.html.fade = function(/*DOMNode[]*/ nodes, |
|
/*Object*/values, |
|
/*int?*/ duration, |
|
/*Function?*/ easing, |
|
/*Function?*/ callback){ |
|
// summary:Returns an animation that will fade the "nodes" from the start to end values passed. |
|
// nodes: An array of DOMNodes or one DOMNode. |
|
// values: { start: Decimal?, end: Decimal? } |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// callback: Function to run at the end of the animation. |
|
nodes = dojo.lfx.html._byId(nodes); |
|
var props = { property: "opacity" }; |
|
if(!dj_undef("start", values)){ |
|
props.start = values.start; |
|
}else{ |
|
props.start = function(){ return dojo.html.getOpacity(nodes[0]); }; |
|
} |
|
|
|
if(!dj_undef("end", values)){ |
|
props.end = values.end; |
|
}else{ |
|
dojo.raise("dojo.lfx.html.fade needs an end value"); |
|
} |
|
|
|
var anim = dojo.lfx.propertyAnimation(nodes, [ props ], duration, easing); |
|
anim.connect("beforeBegin", function(){ |
|
dojo.lfx.html._makeFadeable(nodes); |
|
}); |
|
if(callback){ |
|
anim.connect("onEnd", function(){ callback(nodes, anim); }); |
|
} |
|
|
|
return anim; // dojo.lfx.Animation |
|
} |
|
|
|
dojo.lfx.html.fadeIn = function(/*DOMNode[]*/ nodes, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){ |
|
// summary: Returns an animation that will fade "nodes" from its current opacity to fully opaque. |
|
// nodes: An array of DOMNodes or one DOMNode. |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// callback: Function to run at the end of the animation. |
|
return dojo.lfx.html.fade(nodes, { end: 1 }, duration, easing, callback); // dojo.lfx.Animation |
|
} |
|
|
|
dojo.lfx.html.fadeOut = function(/*DOMNode[]*/ nodes, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){ |
|
// summary: Returns an animation that will fade "nodes" from its current opacity to fully transparent. |
|
// nodes: An array of DOMNodes or one DOMNode. |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// callback: Function to run at the end of the animation. |
|
return dojo.lfx.html.fade(nodes, { end: 0 }, duration, easing, callback); // dojo.lfx.Animation |
|
} |
|
|
|
dojo.lfx.html.fadeShow = function(/*DOMNode[]*/ nodes, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){ |
|
// summary: Returns an animation that will fade "nodes" from transparent to opaque and shows |
|
// "nodes" at the end if it is hidden. |
|
// nodes: An array of DOMNodes or one DOMNode. |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// callback: Function to run at the end of the animation. |
|
nodes=dojo.lfx.html._byId(nodes); |
|
dojo.lang.forEach(nodes, function(node){ |
|
dojo.html.setOpacity(node, 0.0); |
|
}); |
|
|
|
var anim = dojo.lfx.html.fadeIn(nodes, duration, easing, callback); |
|
anim.connect("beforeBegin", function(){ |
|
if(dojo.lang.isArrayLike(nodes)){ |
|
dojo.lang.forEach(nodes, dojo.html.show); |
|
}else{ |
|
dojo.html.show(nodes); |
|
} |
|
}); |
|
|
|
return anim; // dojo.lfx.Animation |
|
} |
|
|
|
dojo.lfx.html.fadeHide = function(/*DOMNode[]*/ nodes, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){ |
|
// summary: Returns an animation that will fade "nodes" from its current opacity to opaque and hides |
|
// "nodes" at the end. |
|
// nodes: An array of DOMNodes or one DOMNode. |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// callback: Function to run at the end of the animation. |
|
var anim = dojo.lfx.html.fadeOut(nodes, duration, easing, function(){ |
|
if(dojo.lang.isArrayLike(nodes)){ |
|
dojo.lang.forEach(nodes, dojo.html.hide); |
|
}else{ |
|
dojo.html.hide(nodes); |
|
} |
|
if(callback){ callback(nodes, anim); } |
|
}); |
|
|
|
return anim; // dojo.lfx.Animation |
|
} |
|
|
|
dojo.lfx.html.wipeIn = function(/*DOMNode[]*/ nodes, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){ |
|
// summary: Returns an animation that will show and wipe in "nodes". |
|
// nodes: An array of DOMNodes or one DOMNode. |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// callback: Function to run at the end of the animation. |
|
nodes = dojo.lfx.html._byId(nodes); |
|
var anims = []; |
|
|
|
dojo.lang.forEach(nodes, function(node){ |
|
var oprop = { }; // old properties of node (before we mucked w/them) |
|
|
|
// get node height, either it's natural height or it's height specified via style or class attributes |
|
// (for FF, the node has to be (temporarily) rendered to measure height) |
|
// TODO: should this offscreen code be part of dojo.html, so that getBorderBox() works on hidden nodes? |
|
var origTop, origLeft, origPosition; |
|
with(node.style){ |
|
origTop=top; origLeft=left; origPosition=position; |
|
top="-9999px"; left="-9999px"; position="absolute"; |
|
display=""; |
|
} |
|
var nodeHeight = dojo.html.getBorderBox(node).height; |
|
with(node.style){ |
|
top=origTop; left=origLeft; position=origPosition; |
|
display="none"; |
|
} |
|
|
|
var anim = dojo.lfx.propertyAnimation(node, |
|
{ "height": { |
|
start: 1, // 0 causes IE to display the whole panel |
|
end: function(){ return nodeHeight; } |
|
} |
|
}, |
|
duration, |
|
easing); |
|
|
|
anim.connect("beforeBegin", function(){ |
|
oprop.overflow = node.style.overflow; |
|
oprop.height = node.style.height; |
|
with(node.style){ |
|
overflow = "hidden"; |
|
height = "1px"; // 0 causes IE to display the whole panel |
|
} |
|
dojo.html.show(node); |
|
}); |
|
|
|
anim.connect("onEnd", function(){ |
|
with(node.style){ |
|
overflow = oprop.overflow; |
|
height = oprop.height; |
|
} |
|
if(callback){ callback(node, anim); } |
|
}); |
|
anims.push(anim); |
|
}); |
|
|
|
return dojo.lfx.combine(anims); // dojo.lfx.Combine |
|
} |
|
|
|
dojo.lfx.html.wipeOut = function(/*DOMNode[]*/ nodes, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){ |
|
// summary: Returns an animation that will wipe out and hide "nodes". |
|
// nodes: An array of DOMNodes or one DOMNode. |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// callback: Function to run at the end of the animation. |
|
nodes = dojo.lfx.html._byId(nodes); |
|
var anims = []; |
|
|
|
dojo.lang.forEach(nodes, function(node){ |
|
var oprop = { }; // old properties of node (before we mucked w/them) |
|
var anim = dojo.lfx.propertyAnimation(node, |
|
{ "height": { |
|
start: function(){ return dojo.html.getContentBox(node).height; }, |
|
end: 1 // 0 causes IE to display the whole panel |
|
} |
|
}, |
|
duration, |
|
easing, |
|
{ |
|
"beforeBegin": function(){ |
|
oprop.overflow = node.style.overflow; |
|
oprop.height = node.style.height; |
|
with(node.style){ |
|
overflow = "hidden"; |
|
} |
|
dojo.html.show(node); |
|
}, |
|
|
|
"onEnd": function(){ |
|
dojo.html.hide(node); |
|
with(node.style){ |
|
overflow = oprop.overflow; |
|
height = oprop.height; |
|
} |
|
if(callback){ callback(node, anim); } |
|
} |
|
} |
|
); |
|
anims.push(anim); |
|
}); |
|
|
|
return dojo.lfx.combine(anims); // dojo.lfx.Combine |
|
} |
|
|
|
dojo.lfx.html.slideTo = function(/*DOMNode*/ nodes, |
|
/*Object*/ coords, |
|
/*int?*/ duration, |
|
/*Function?*/ easing, |
|
/*Function?*/ callback){ |
|
// summary: Returns an animation that will slide "nodes" from its current position to |
|
// the position defined in "coords". |
|
// nodes: An array of DOMNodes or one DOMNode. |
|
// coords: { top: Decimal?, left: Decimal? } |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// callback: Function to run at the end of the animation. |
|
nodes = dojo.lfx.html._byId(nodes); |
|
var anims = []; |
|
var compute = dojo.html.getComputedStyle; |
|
|
|
if(dojo.lang.isArray(coords)){ |
|
/* coords: Array |
|
pId: a */ |
|
dojo.deprecated('dojo.lfx.html.slideTo(node, array)', 'use dojo.lfx.html.slideTo(node, {top: value, left: value});', '0.5'); |
|
coords = { top: coords[0], left: coords[1] }; |
|
} |
|
dojo.lang.forEach(nodes, function(node){ |
|
var top = null; |
|
var left = null; |
|
|
|
var init = (function(){ |
|
var innerNode = node; |
|
return function(){ |
|
var pos = compute(innerNode, 'position'); |
|
top = (pos == 'absolute' ? node.offsetTop : parseInt(compute(node, 'top')) || 0); |
|
left = (pos == 'absolute' ? node.offsetLeft : parseInt(compute(node, 'left')) || 0); |
|
|
|
if (!dojo.lang.inArray(['absolute', 'relative'], pos)) { |
|
var ret = dojo.html.abs(innerNode, true); |
|
dojo.html.setStyleAttributes(innerNode, "position:absolute;top:"+ret.y+"px;left:"+ret.x+"px;"); |
|
top = ret.y; |
|
left = ret.x; |
|
} |
|
} |
|
})(); |
|
init(); |
|
|
|
var anim = dojo.lfx.propertyAnimation(node, |
|
{ "top": { start: top, end: (coords.top||0) }, |
|
"left": { start: left, end: (coords.left||0) } |
|
}, |
|
duration, |
|
easing, |
|
{ "beforeBegin": init } |
|
); |
|
|
|
if(callback){ |
|
anim.connect("onEnd", function(){ callback(nodes, anim); }); |
|
} |
|
|
|
anims.push(anim); |
|
}); |
|
|
|
return dojo.lfx.combine(anims); // dojo.lfx.Combine |
|
} |
|
|
|
dojo.lfx.html.slideBy = function(/*DOMNode*/ nodes, /*Object*/ coords, /*int?*/ duration, /*Function?*/ easing, /*Function?*/ callback){ |
|
// summary: Returns an animation that will slide "nodes" from its current position |
|
// to its current position plus the numbers defined in "coords". |
|
// nodes: An array of DOMNodes or one DOMNode. |
|
// coords: { top: Decimal?, left: Decimal? } |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// callback: Function to run at the end of the animation. |
|
nodes = dojo.lfx.html._byId(nodes); |
|
var anims = []; |
|
var compute = dojo.html.getComputedStyle; |
|
|
|
if(dojo.lang.isArray(coords)){ |
|
/* coords: Array |
|
pId: a */ |
|
dojo.deprecated('dojo.lfx.html.slideBy(node, array)', 'use dojo.lfx.html.slideBy(node, {top: value, left: value});', '0.5'); |
|
coords = { top: coords[0], left: coords[1] }; |
|
} |
|
|
|
dojo.lang.forEach(nodes, function(node){ |
|
var top = null; |
|
var left = null; |
|
|
|
var init = (function(){ |
|
var innerNode = node; |
|
return function(){ |
|
var pos = compute(innerNode, 'position'); |
|
top = (pos == 'absolute' ? node.offsetTop : parseInt(compute(node, 'top')) || 0); |
|
left = (pos == 'absolute' ? node.offsetLeft : parseInt(compute(node, 'left')) || 0); |
|
|
|
if (!dojo.lang.inArray(['absolute', 'relative'], pos)) { |
|
var ret = dojo.html.abs(innerNode, true); |
|
dojo.html.setStyleAttributes(innerNode, "position:absolute;top:"+ret.y+"px;left:"+ret.x+"px;"); |
|
top = ret.y; |
|
left = ret.x; |
|
} |
|
} |
|
})(); |
|
init(); |
|
|
|
var anim = dojo.lfx.propertyAnimation(node, |
|
{ |
|
"top": { start: top, end: top+(coords.top||0) }, |
|
"left": { start: left, end: left+(coords.left||0) } |
|
}, |
|
duration, |
|
easing).connect("beforeBegin", init); |
|
|
|
if(callback){ |
|
anim.connect("onEnd", function(){ callback(nodes, anim); }); |
|
} |
|
|
|
anims.push(anim); |
|
}); |
|
|
|
return dojo.lfx.combine(anims); // dojo.lfx.Combine |
|
} |
|
|
|
dojo.lfx.html.explode = function(/*DOMNode*/ start, |
|
/*DOMNode*/ endNode, |
|
/*int?*/ duration, |
|
/*Function?*/ easing, |
|
/*Function?*/ callback){ |
|
// summary: Returns an animation that will |
|
// start: |
|
// endNode: |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// callback: Function to run at the end of the animation. |
|
var h = dojo.html; |
|
start = dojo.byId(start); |
|
endNode = dojo.byId(endNode); |
|
var startCoords = h.toCoordinateObject(start, true); |
|
var outline = document.createElement("div"); |
|
h.copyStyle(outline, endNode); |
|
if(endNode.explodeClassName){ outline.className = endNode.explodeClassName; } |
|
with(outline.style){ |
|
position = "absolute"; |
|
display = "none"; |
|
// border = "1px solid black"; |
|
var backgroundStyle = h.getStyle(start, "background-color"); |
|
backgroundColor = backgroundStyle ? backgroundStyle.toLowerCase() : "transparent"; |
|
backgroundColor = (backgroundColor == "transparent") ? "rgb(221, 221, 221)" : backgroundColor; |
|
} |
|
dojo.body().appendChild(outline); |
|
|
|
with(endNode.style){ |
|
visibility = "hidden"; |
|
display = "block"; |
|
} |
|
var endCoords = h.toCoordinateObject(endNode, true); |
|
with(endNode.style){ |
|
display = "none"; |
|
visibility = "visible"; |
|
} |
|
|
|
var props = { opacity: { start: 0.5, end: 1.0 } }; |
|
dojo.lang.forEach(["height", "width", "top", "left"], function(type){ |
|
props[type] = { start: startCoords[type], end: endCoords[type] } |
|
}); |
|
|
|
var anim = new dojo.lfx.propertyAnimation(outline, |
|
props, |
|
duration, |
|
easing, |
|
{ |
|
"beforeBegin": function(){ |
|
h.setDisplay(outline, "block"); |
|
}, |
|
"onEnd": function(){ |
|
h.setDisplay(endNode, "block"); |
|
outline.parentNode.removeChild(outline); |
|
} |
|
} |
|
); |
|
|
|
if(callback){ |
|
anim.connect("onEnd", function(){ callback(endNode, anim); }); |
|
} |
|
return anim; // dojo.lfx.Animation |
|
} |
|
|
|
dojo.lfx.html.implode = function(/*DOMNode*/ startNode, |
|
/*DOMNode*/ end, |
|
/*int?*/ duration, |
|
/*Function?*/ easing, |
|
/*Function?*/ callback){ |
|
// summary: Returns an animation that will |
|
// startNode: |
|
// end: |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// callback: Function to run at the end of the animation. |
|
var h = dojo.html; |
|
startNode = dojo.byId(startNode); |
|
end = dojo.byId(end); |
|
var startCoords = dojo.html.toCoordinateObject(startNode, true); |
|
var endCoords = dojo.html.toCoordinateObject(end, true); |
|
|
|
var outline = document.createElement("div"); |
|
dojo.html.copyStyle(outline, startNode); |
|
if (startNode.explodeClassName) { outline.className = startNode.explodeClassName; } |
|
dojo.html.setOpacity(outline, 0.3); |
|
with(outline.style){ |
|
position = "absolute"; |
|
display = "none"; |
|
backgroundColor = h.getStyle(startNode, "background-color").toLowerCase(); |
|
} |
|
dojo.body().appendChild(outline); |
|
|
|
var props = { opacity: { start: 1.0, end: 0.5 } }; |
|
dojo.lang.forEach(["height", "width", "top", "left"], function(type){ |
|
props[type] = { start: startCoords[type], end: endCoords[type] } |
|
}); |
|
|
|
var anim = new dojo.lfx.propertyAnimation(outline, |
|
props, |
|
duration, |
|
easing, |
|
{ |
|
"beforeBegin": function(){ |
|
dojo.html.hide(startNode); |
|
dojo.html.show(outline); |
|
}, |
|
"onEnd": function(){ |
|
outline.parentNode.removeChild(outline); |
|
} |
|
} |
|
); |
|
|
|
if(callback){ |
|
anim.connect("onEnd", function(){ callback(startNode, anim); }); |
|
} |
|
return anim; // dojo.lfx.Animation |
|
} |
|
|
|
dojo.lfx.html.highlight = function(/*DOMNode[]*/ nodes, |
|
/*dojo.gfx.color.Color*/ startColor, |
|
/*int?*/ duration, |
|
/*Function?*/ easing, |
|
/*Function?*/ callback){ |
|
// summary: Returns an animation that will set the background color |
|
// of "nodes" to startColor and transition it to "nodes" |
|
// original color. |
|
// startColor: Color to transition from. |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// callback: Function to run at the end of the animation. |
|
nodes = dojo.lfx.html._byId(nodes); |
|
var anims = []; |
|
|
|
dojo.lang.forEach(nodes, function(node){ |
|
var color = dojo.html.getBackgroundColor(node); |
|
var bg = dojo.html.getStyle(node, "background-color").toLowerCase(); |
|
var bgImage = dojo.html.getStyle(node, "background-image"); |
|
var wasTransparent = (bg == "transparent" || bg == "rgba(0, 0, 0, 0)"); |
|
while(color.length > 3) { color.pop(); } |
|
|
|
var rgb = new dojo.gfx.color.Color(startColor); |
|
var endRgb = new dojo.gfx.color.Color(color); |
|
|
|
var anim = dojo.lfx.propertyAnimation(node, |
|
{ "background-color": { start: rgb, end: endRgb } }, |
|
duration, |
|
easing, |
|
{ |
|
"beforeBegin": function(){ |
|
if(bgImage){ |
|
node.style.backgroundImage = "none"; |
|
} |
|
node.style.backgroundColor = "rgb(" + rgb.toRgb().join(",") + ")"; |
|
}, |
|
"onEnd": function(){ |
|
if(bgImage){ |
|
node.style.backgroundImage = bgImage; |
|
} |
|
if(wasTransparent){ |
|
node.style.backgroundColor = "transparent"; |
|
} |
|
if(callback){ |
|
callback(node, anim); |
|
} |
|
} |
|
} |
|
); |
|
|
|
anims.push(anim); |
|
}); |
|
return dojo.lfx.combine(anims); // dojo.lfx.Combine |
|
} |
|
|
|
dojo.lfx.html.unhighlight = function(/*DOMNode[]*/ nodes, |
|
/*dojo.gfx.color.Color*/ endColor, |
|
/*int?*/ duration, |
|
/*Function?*/ easing, |
|
/*Function?*/ callback){ |
|
// summary: Returns an animation that will transition "nodes" background color |
|
// from its current color to "endColor". |
|
// endColor: Color to transition to. |
|
// duration: Duration of the animation in milliseconds. |
|
// easing: An easing function. |
|
// callback: Function to run at the end of the animation. |
|
nodes = dojo.lfx.html._byId(nodes); |
|
var anims = []; |
|
|
|
dojo.lang.forEach(nodes, function(node){ |
|
var color = new dojo.gfx.color.Color(dojo.html.getBackgroundColor(node)); |
|
var rgb = new dojo.gfx.color.Color(endColor); |
|
|
|
var bgImage = dojo.html.getStyle(node, "background-image"); |
|
|
|
var anim = dojo.lfx.propertyAnimation(node, |
|
{ "background-color": { start: color, end: rgb } }, |
|
duration, |
|
easing, |
|
{ |
|
"beforeBegin": function(){ |
|
if(bgImage){ |
|
node.style.backgroundImage = "none"; |
|
} |
|
node.style.backgroundColor = "rgb(" + color.toRgb().join(",") + ")"; |
|
}, |
|
"onEnd": function(){ |
|
if(callback){ |
|
callback(node, anim); |
|
} |
|
} |
|
} |
|
); |
|
anims.push(anim); |
|
}); |
|
return dojo.lfx.combine(anims); // dojo.lfx.Combine |
|
} |
|
|
|
dojo.lang.mixin(dojo.lfx, dojo.lfx.html); |
|
|
|
dojo.kwCompoundRequire({ |
|
browser: ["dojo.lfx.html"], |
|
dashboard: ["dojo.lfx.html"] |
|
}); |
|
dojo.provide("dojo.lfx.*"); |
|
|
|
|