/*!
- * Ext JS Library 3.0.0
- * Copyright(c) 2006-2009 Ext JS, LLC
+ * Ext JS Library 3.3.0
+ * Copyright(c) 2006-2010 Ext JS, Inc.
* licensing@extjs.com
* http://www.extjs.com/license
*/
-\r
-// for old browsers\r
-window.undefined = window.undefined;\r
-\r
-/**\r
- * @class Ext\r
- * Ext core utilities and functions.\r
- * @singleton\r
- */\r
-\r
-Ext = {\r
- /**\r
- * The version of the framework\r
- * @type String\r
- */\r
- version : '3.0'\r
-};\r
-\r
-/**\r
- * Copies all the properties of config to obj.\r
- * @param {Object} obj The receiver of the properties\r
- * @param {Object} config The source of the properties\r
- * @param {Object} defaults A different object that will also be applied for default values\r
- * @return {Object} returns obj\r
- * @member Ext apply\r
- */\r
-Ext.apply = function(o, c, defaults){\r
- // no "this" reference for friendly out of scope calls\r
- if(defaults){\r
- Ext.apply(o, defaults);\r
- }\r
- if(o && c && typeof c == 'object'){\r
- for(var p in c){\r
- o[p] = c[p];\r
- }\r
- }\r
- return o;\r
-};\r
-\r
-(function(){\r
- var idSeed = 0,\r
- toString = Object.prototype.toString,\r
- //assume it's not null and not an array\r
- isIterable = function(v){\r
- //check for array or arguments\r
- if(Ext.isArray(v) || v.callee){\r
- return true;\r
- }\r
- //check for node list type\r
- if(/NodeList|HTMLCollection/.test(toString.call(v))){\r
- return true;\r
- }\r
- //NodeList has an item and length property\r
- //IXMLDOMNodeList has nextNode method, needs to be checked first.\r
- return ((v.nextNode || v.item) && Ext.isNumber(v.length));\r
- },\r
- ua = navigator.userAgent.toLowerCase(),\r
- check = function(r){\r
- return r.test(ua);\r
- },\r
- DOC = document,\r
- isStrict = DOC.compatMode == "CSS1Compat",\r
- isOpera = check(/opera/),\r
- isChrome = check(/chrome/),\r
- isWebKit = check(/webkit/),\r
- isSafari = !isChrome && check(/safari/),\r
- isSafari2 = isSafari && check(/applewebkit\/4/), // unique to Safari 2\r
- isSafari3 = isSafari && check(/version\/3/),\r
- isSafari4 = isSafari && check(/version\/4/),\r
- isIE = !isOpera && check(/msie/),\r
- isIE7 = isIE && check(/msie 7/),\r
- isIE8 = isIE && check(/msie 8/),\r
- isIE6 = isIE && !isIE7 && !isIE8,\r
- isGecko = !isWebKit && check(/gecko/),\r
- isGecko2 = isGecko && check(/rv:1\.8/),\r
- isGecko3 = isGecko && check(/rv:1\.9/),\r
- isBorderBox = isIE && !isStrict,\r
- isWindows = check(/windows|win32/),\r
- isMac = check(/macintosh|mac os x/),\r
- isAir = check(/adobeair/),\r
- isLinux = check(/linux/),\r
- isSecure = /^https/i.test(window.location.protocol);\r
-\r
- // remove css image flicker\r
- if(isIE6){\r
- try{\r
- DOC.execCommand("BackgroundImageCache", false, true);\r
- }catch(e){}\r
- }\r
-\r
- Ext.apply(Ext, {\r
- /**\r
- * URL to a blank file used by Ext when in secure mode for iframe src and onReady src to prevent\r
- * the IE insecure content warning (defaults to javascript:false).\r
- * @type String\r
- */\r
- SSL_SECURE_URL : 'javascript:false',\r
- /**\r
- * True if the browser is in strict (standards-compliant) mode, as opposed to quirks mode\r
- * @type Boolean\r
- */\r
- isStrict : isStrict,\r
- /**\r
- * True if the page is running over SSL\r
- * @type Boolean\r
- */\r
- isSecure : isSecure,\r
- /**\r
- * True when the document is fully initialized and ready for action\r
- * @type Boolean\r
- */\r
- isReady : false,\r
-\r
- /**\r
- * True if the {@link Ext.Fx} Class is available\r
- * @type Boolean\r
- * @property enableFx\r
- */\r
-\r
- /**\r
- * True to automatically uncache orphaned Ext.Elements periodically (defaults to true)\r
- * @type Boolean\r
- */\r
- enableGarbageCollector : true,\r
-\r
- /**\r
- * True to automatically purge event listeners after uncaching an element (defaults to false).\r
- * Note: this only happens if {@link #enableGarbageCollector} is true.\r
- * @type Boolean\r
- */\r
- enableListenerCollection : false,\r
-\r
- /**\r
- * Indicates whether to use native browser parsing for JSON methods.\r
- * This option is ignored if the browser does not support native JSON methods.\r
- * <b>Note: Native JSON methods will not work with objects that have functions.\r
- * Also, property names must be quoted, otherwise the data will not parse.</b> (Defaults to false)\r
- * @type Boolean\r
- */\r
- USE_NATIVE_JSON : false,\r
-\r
- /**\r
- * Copies all the properties of config to obj if they don't already exist.\r
- * @param {Object} obj The receiver of the properties\r
- * @param {Object} config The source of the properties\r
- * @return {Object} returns obj\r
- */\r
- applyIf : function(o, c){\r
- if(o){\r
- for(var p in c){\r
- if(Ext.isEmpty(o[p])){\r
- o[p] = c[p];\r
- }\r
- }\r
- }\r
- return o;\r
- },\r
-\r
- /**\r
- * Generates unique ids. If the element already has an id, it is unchanged\r
- * @param {Mixed} el (optional) The element to generate an id for\r
- * @param {String} prefix (optional) Id prefix (defaults "ext-gen")\r
- * @return {String} The generated Id.\r
- */\r
- id : function(el, prefix){\r
- return (el = Ext.getDom(el) || {}).id = el.id || (prefix || "ext-gen") + (++idSeed);\r
- },\r
-\r
- /**\r
- * Extends one class with another class and optionally overrides members with the passed literal. This class\r
- * also adds the function "override()" to the class that can be used to override\r
- * members on an instance.\r
- * * <p>\r
- * This function also supports a 2-argument call in which the subclass's constructor is\r
- * not passed as an argument. In this form, the parameters are as follows:</p><p>\r
- * <div class="mdetail-params"><ul>\r
- * <li><code>superclass</code>\r
- * <div class="sub-desc">The class being extended</div></li>\r
- * <li><code>overrides</code>\r
- * <div class="sub-desc">A literal with members which are copied into the subclass's\r
- * prototype, and are therefore shared among all instances of the new class.<p>\r
- * This may contain a special member named <tt><b>constructor</b></tt>. This is used\r
- * to define the constructor of the new class, and is returned. If this property is\r
- * <i>not</i> specified, a constructor is generated and returned which just calls the\r
- * superclass's constructor passing on its parameters.</p></div></li>\r
- * </ul></div></p><p>\r
- * For example, to create a subclass of the Ext GridPanel:\r
- * <pre><code>\r
-MyGridPanel = Ext.extend(Ext.grid.GridPanel, {\r
- constructor: function(config) {\r
- // Your preprocessing here\r
- MyGridPanel.superclass.constructor.apply(this, arguments);\r
- // Your postprocessing here\r
- },\r
-\r
- yourMethod: function() {\r
- // etc.\r
- }\r
-});\r
-</code></pre>\r
- * </p>\r
- * @param {Function} subclass The class inheriting the functionality\r
- * @param {Function} superclass The class being extended\r
- * @param {Object} overrides (optional) A literal with members which are copied into the subclass's\r
- * prototype, and are therefore shared between all instances of the new class.\r
- * @return {Function} The subclass constructor.\r
- * @method extend\r
- */\r
- extend : function(){\r
- // inline overrides\r
- var io = function(o){\r
- for(var m in o){\r
- this[m] = o[m];\r
- }\r
- };\r
- var oc = Object.prototype.constructor;\r
-\r
- return function(sb, sp, overrides){\r
- if(Ext.isObject(sp)){\r
- overrides = sp;\r
- sp = sb;\r
- sb = overrides.constructor != oc ? overrides.constructor : function(){sp.apply(this, arguments);};\r
- }\r
- var F = function(){},\r
- sbp,\r
- spp = sp.prototype;\r
-\r
- F.prototype = spp;\r
- sbp = sb.prototype = new F();\r
- sbp.constructor=sb;\r
- sb.superclass=spp;\r
- if(spp.constructor == oc){\r
- spp.constructor=sp;\r
- }\r
- sb.override = function(o){\r
- Ext.override(sb, o);\r
- };\r
- sbp.superclass = sbp.supr = (function(){\r
- return spp;\r
- });\r
- sbp.override = io;\r
- Ext.override(sb, overrides);\r
- sb.extend = function(o){Ext.extend(sb, o);};\r
- return sb;\r
- };\r
- }(),\r
-\r
- /**\r
- * Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name.\r
- * Usage:<pre><code>\r
-Ext.override(MyClass, {\r
- newMethod1: function(){\r
- // etc.\r
- },\r
- newMethod2: function(foo){\r
- // etc.\r
- }\r
-});\r
-</code></pre>\r
- * @param {Object} origclass The class to override\r
- * @param {Object} overrides The list of functions to add to origClass. This should be specified as an object literal\r
- * containing one or more methods.\r
- * @method override\r
- */\r
- override : function(origclass, overrides){\r
- if(overrides){\r
- var p = origclass.prototype;\r
- Ext.apply(p, overrides);\r
- if(Ext.isIE && overrides.toString != origclass.toString){\r
- p.toString = overrides.toString;\r
- }\r
- }\r
- },\r
-\r
- /**\r
- * Creates namespaces to be used for scoping variables and classes so that they are not global.\r
- * Specifying the last node of a namespace implicitly creates all other nodes. Usage:\r
- * <pre><code>\r
-Ext.namespace('Company', 'Company.data');\r
-Ext.namespace('Company.data'); // equivalent and preferable to above syntax\r
-Company.Widget = function() { ... }\r
-Company.data.CustomStore = function(config) { ... }\r
-</code></pre>\r
- * @param {String} namespace1\r
- * @param {String} namespace2\r
- * @param {String} etc\r
- * @method namespace\r
- */\r
- namespace : function(){\r
- var o, d;\r
- Ext.each(arguments, function(v) {\r
- d = v.split(".");\r
- o = window[d[0]] = window[d[0]] || {};\r
- Ext.each(d.slice(1), function(v2){\r
- o = o[v2] = o[v2] || {};\r
- });\r
- });\r
- return o;\r
- },\r
-\r
- /**\r
- * Takes an object and converts it to an encoded URL. e.g. Ext.urlEncode({foo: 1, bar: 2}); would return "foo=1&bar=2". Optionally, property values can be arrays, instead of keys and the resulting string that's returned will contain a name/value pair for each array value.\r
- * @param {Object} o\r
- * @param {String} pre (optional) A prefix to add to the url encoded string\r
- * @return {String}\r
- */\r
- urlEncode: function(o, pre){\r
- var undef, buf = [], key, e = encodeURIComponent;\r
-\r
- for(key in o){\r
- undef = !Ext.isDefined(o[key]);\r
- Ext.each(undef ? key : o[key], function(val, i){\r
- buf.push("&", e(key), "=", (val != key || !undef) ? e(val) : "");\r
- });\r
- }\r
- if(!pre){\r
- buf.shift();\r
- pre = "";\r
- }\r
- return pre + buf.join('');\r
- },\r
-\r
- /**\r
- * Takes an encoded URL and and converts it to an object. Example: <pre><code>\r
-Ext.urlDecode("foo=1&bar=2"); // returns {foo: "1", bar: "2"}\r
-Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2", "3", "4"]}\r
-</code></pre>\r
- * @param {String} string\r
- * @param {Boolean} overwrite (optional) Items of the same name will overwrite previous values instead of creating an an array (Defaults to false).\r
- * @return {Object} A literal with members\r
- */\r
- urlDecode : function(string, overwrite){\r
- var obj = {},\r
- pairs = string.split('&'),\r
- d = decodeURIComponent,\r
- name,\r
- value;\r
- Ext.each(pairs, function(pair) {\r
- pair = pair.split('=');\r
- name = d(pair[0]);\r
- value = d(pair[1]);\r
- obj[name] = overwrite || !obj[name] ? value :\r
- [].concat(obj[name]).concat(value);\r
- });\r
- return obj;\r
- },\r
-\r
- /**\r
- * Appends content to the query string of a URL, which handles logic for whether to place\r
- * a question mark or ampersand.\r
- * @param {String} url The url to append to.\r
- * @@param {String} s The content to append to the url.\r
- * @return (String) The appended string\r
- */\r
- urlAppend : function(url, s){\r
- if(!Ext.isEmpty(s)){\r
- return url + (url.indexOf('?') === -1 ? '?' : '&') + s;\r
- }\r
- return url;\r
- },\r
-\r
- /**\r
- * Converts any iterable (numeric indices and a length property) into a true array\r
- * Don't use this on strings. IE doesn't support "abc"[0] which this implementation depends on.\r
- * For strings, use this instead: "abc".match(/./g) => [a,b,c];\r
- * @param {Iterable} the iterable object to be turned into a true Array.\r
- * @return (Array) array\r
- */\r
- toArray : function(){\r
- return isIE ?\r
- function(a, i, j, res){\r
- res = [];\r
- Ext.each(a, function(v) {\r
- res.push(v);\r
- });\r
- return res.slice(i || 0, j || res.length);\r
- } :\r
- function(a, i, j){\r
- return Array.prototype.slice.call(a, i || 0, j || a.length);\r
- }\r
- }(),\r
-\r
- /**\r
- * Iterates an array calling the passed function with each item, stopping if your function returns false. If the\r
- * passed array is not really an array, your function is called once with it.\r
- * The supplied function is called with (Object item, Number index, Array allItems).\r
- * @param {Array/NodeList/Mixed} array\r
- * @param {Function} fn\r
- * @param {Object} scope\r
- */\r
- each: function(array, fn, scope){\r
- if(Ext.isEmpty(array, true)){\r
- return;\r
- }\r
- if(!isIterable(array) || Ext.isPrimitive(array)){\r
- array = [array];\r
- }\r
- for(var i = 0, len = array.length; i < len; i++){\r
- if(fn.call(scope || array[i], array[i], i, array) === false){\r
- return i;\r
- };\r
- }\r
- },\r
-\r
- /**\r
- * Iterates either the elements in an array, or each of the properties in an object.\r
- * <b>Note</b>: If you are only iterating arrays, it is better to call {@link #each}.\r
- * @param {Object/Array} object The object or array to be iterated\r
- * @param {Function} fn The function to be called for each iteration.\r
- * The iteration will stop if the supplied function returns false, or\r
- * all array elements / object properties have been covered. The signature\r
- * varies depending on the type of object being interated:\r
- * <div class="mdetail-params"><ul>\r
- * <li>Arrays : <tt>(Object item, Number index, Array allItems)</tt>\r
- * <div class="sub-desc">\r
- * When iterating an array, the supplied function is called with each item.</div></li>\r
- * <li>Objects : <tt>(String key, Object value)</tt>\r
- * <div class="sub-desc">\r
- * When iterating an object, the supplied function is called with each key-value pair in\r
- * the object.</div></li>\r
- * </ul></div>\r
- * @param {Object} scope The scope to call the supplied function with, defaults to\r
- * the specified <tt>object</tt>\r
- */\r
- iterate : function(obj, fn, scope){\r
- if(isIterable(obj)){\r
- Ext.each(obj, fn, scope);\r
- return;\r
- }else if(Ext.isObject(obj)){\r
- for(var prop in obj){\r
- if(obj.hasOwnProperty(prop)){\r
- if(fn.call(scope || obj, prop, obj[prop]) === false){\r
- return;\r
- };\r
- }\r
- }\r
- }\r
- },\r
-\r
- /**\r
- * Return the dom node for the passed String (id), dom node, or Ext.Element.\r
- * Here are some examples:\r
- * <pre><code>\r
-// gets dom node based on id\r
-var elDom = Ext.getDom('elId');\r
-// gets dom node based on the dom node\r
-var elDom1 = Ext.getDom(elDom);\r
-\r
-// If we don't know if we are working with an\r
-// Ext.Element or a dom node use Ext.getDom\r
-function(el){\r
- var dom = Ext.getDom(el);\r
- // do something with the dom node\r
-}\r
- * </code></pre>\r
- * <b>Note</b>: the dom node to be found actually needs to exist (be rendered, etc)\r
- * when this method is called to be successful.\r
- * @param {Mixed} el\r
- * @return HTMLElement\r
- */\r
- getDom : function(el){\r
- if(!el || !DOC){\r
- return null;\r
- }\r
- return el.dom ? el.dom : (Ext.isString(el) ? DOC.getElementById(el) : el);\r
- },\r
-\r
- /**\r
- * Returns the current document body as an {@link Ext.Element}.\r
- * @return Ext.Element The document body\r
- */\r
- getBody : function(){\r
- return Ext.get(DOC.body || DOC.documentElement);\r
- },\r
-\r
- /**\r
- * Removes a DOM node from the document. The body node will be ignored if passed in.\r
- * @param {HTMLElement} node The node to remove\r
- */\r
- removeNode : isIE ? function(){\r
- var d;\r
- return function(n){\r
- if(n && n.tagName != 'BODY'){\r
- d = d || DOC.createElement('div');\r
- d.appendChild(n);\r
- d.innerHTML = '';\r
- }\r
- }\r
- }() : function(n){\r
- if(n && n.parentNode && n.tagName != 'BODY'){\r
- n.parentNode.removeChild(n);\r
- }\r
- },\r
-\r
- /**\r
- * <p>Returns true if the passed value is empty.</p>\r
- * <p>The value is deemed to be empty if it is<div class="mdetail-params"><ul>\r
- * <li>null</li>\r
- * <li>undefined</li>\r
- * <li>an empty array</li>\r
- * <li>a zero length string (Unless the <tt>allowBlank</tt> parameter is <tt>true</tt>)</li>\r
- * </ul></div>\r
- * @param {Mixed} value The value to test\r
- * @param {Boolean} allowBlank (optional) true to allow empty strings (defaults to false)\r
- * @return {Boolean}\r
- */\r
- isEmpty : function(v, allowBlank){\r
- return v === null || v === undefined || ((Ext.isArray(v) && !v.length)) || (!allowBlank ? v === '' : false);\r
- },\r
-\r
- /**\r
- * Returns true if the passed object is a JavaScript array, otherwise false.\r
- * @param {Object} object The object to test\r
- * @return {Boolean}\r
- */\r
- isArray : function(v){\r
- return toString.apply(v) === '[object Array]';\r
- },\r
-\r
- /**\r
- * Returns true if the passed object is a JavaScript Object, otherwise false.\r
- * @param {Object} object The object to test\r
- * @return {Boolean}\r
- */\r
- isObject : function(v){\r
- return v && typeof v == "object";\r
- },\r
-\r
- /**\r
- * Returns true if the passed object is a JavaScript 'primitive', a string, number or boolean.\r
- * @param {Mixed} value The value to test\r
- * @return {Boolean}\r
- */\r
- isPrimitive : function(v){\r
- return Ext.isString(v) || Ext.isNumber(v) || Ext.isBoolean(v);\r
- },\r
-\r
- /**\r
- * Returns true if the passed object is a JavaScript Function, otherwise false.\r
- * @param {Object} object The object to test\r
- * @return {Boolean}\r
- */\r
- isFunction : function(v){\r
- return toString.apply(v) === '[object Function]';\r
- },\r
-\r
- /**\r
- * Returns true if the passed object is a number. Returns false for non-finite numbers.\r
- * @param {Object} v The object to test\r
- * @return {Boolean}\r
- */\r
- isNumber: function(v){\r
- return typeof v === 'number' && isFinite(v);\r
- },\r
-\r
- /**\r
- * Returns true if the passed object is a string.\r
- * @param {Object} v The object to test\r
- * @return {Boolean}\r
- */\r
- isString: function(v){\r
- return typeof v === 'string';\r
- },\r
-\r
- /**\r
- * Returns true if the passed object is a boolean.\r
- * @param {Object} v The object to test\r
- * @return {Boolean}\r
- */\r
- isBoolean: function(v){\r
- return typeof v === 'boolean';\r
- },\r
-\r
- /**\r
- * Returns true if the passed object is not undefined.\r
- * @param {Object} v The object to test\r
- * @return {Boolean}\r
- */\r
- isDefined: function(v){\r
- return typeof v !== 'undefined';\r
- },\r
-\r
- /**\r
- * True if the detected browser is Opera.\r
- * @type Boolean\r
- */\r
- isOpera : isOpera,\r
- /**\r
- * True if the detected browser uses WebKit.\r
- * @type Boolean\r
- */\r
- isWebKit: isWebKit,\r
- /**\r
- * True if the detected browser is Chrome.\r
- * @type Boolean\r
- */\r
- isChrome : isChrome,\r
- /**\r
- * True if the detected browser is Safari.\r
- * @type Boolean\r
- */\r
- isSafari : isSafari,\r
- /**\r
- * True if the detected browser is Safari 3.x.\r
- * @type Boolean\r
- */\r
- isSafari3 : isSafari3,\r
- /**\r
- * True if the detected browser is Safari 4.x.\r
- * @type Boolean\r
- */\r
- isSafari4 : isSafari4,\r
- /**\r
- * True if the detected browser is Safari 2.x.\r
- * @type Boolean\r
- */\r
- isSafari2 : isSafari2,\r
- /**\r
- * True if the detected browser is Internet Explorer.\r
- * @type Boolean\r
- */\r
- isIE : isIE,\r
- /**\r
- * True if the detected browser is Internet Explorer 6.x.\r
- * @type Boolean\r
- */\r
- isIE6 : isIE6,\r
- /**\r
- * True if the detected browser is Internet Explorer 7.x.\r
- * @type Boolean\r
- */\r
- isIE7 : isIE7,\r
- /**\r
- * True if the detected browser is Internet Explorer 8.x.\r
- * @type Boolean\r
- */\r
- isIE8 : isIE8,\r
- /**\r
- * True if the detected browser uses the Gecko layout engine (e.g. Mozilla, Firefox).\r
- * @type Boolean\r
- */\r
- isGecko : isGecko,\r
- /**\r
- * True if the detected browser uses a pre-Gecko 1.9 layout engine (e.g. Firefox 2.x).\r
- * @type Boolean\r
- */\r
- isGecko2 : isGecko2,\r
- /**\r
- * True if the detected browser uses a Gecko 1.9+ layout engine (e.g. Firefox 3.x).\r
- * @type Boolean\r
- */\r
- isGecko3 : isGecko3,\r
- /**\r
- * True if the detected browser is Internet Explorer running in non-strict mode.\r
- * @type Boolean\r
- */\r
- isBorderBox : isBorderBox,\r
- /**\r
- * True if the detected platform is Linux.\r
- * @type Boolean\r
- */\r
- isLinux : isLinux,\r
- /**\r
- * True if the detected platform is Windows.\r
- * @type Boolean\r
- */\r
- isWindows : isWindows,\r
- /**\r
- * True if the detected platform is Mac OS.\r
- * @type Boolean\r
- */\r
- isMac : isMac,\r
- /**\r
- * True if the detected platform is Adobe Air.\r
- * @type Boolean\r
- */\r
- isAir : isAir\r
- });\r
-\r
- /**\r
- * Creates namespaces to be used for scoping variables and classes so that they are not global.\r
- * Specifying the last node of a namespace implicitly creates all other nodes. Usage:\r
- * <pre><code>\r
-Ext.namespace('Company', 'Company.data');\r
-Ext.namespace('Company.data'); // equivalent and preferable to above syntax\r
-Company.Widget = function() { ... }\r
-Company.data.CustomStore = function(config) { ... }\r
-</code></pre>\r
- * @param {String} namespace1\r
- * @param {String} namespace2\r
- * @param {String} etc\r
- * @method namespace\r
- */\r
- Ext.ns = Ext.namespace;\r
-})();\r
-\r
-Ext.ns("Ext", "Ext.util", "Ext.lib", "Ext.data");\r
-\r
-\r
-/**\r
- * @class Function\r
- * These functions are available on every Function object (any JavaScript function).\r
- */\r
-Ext.apply(Function.prototype, {\r
- /**\r
- * Creates an interceptor function. The passed fcn is called before the original one. If it returns false,\r
- * the original one is not called. The resulting function returns the results of the original function.\r
- * The passed fcn is called with the parameters of the original function. Example usage:\r
- * <pre><code>\r
-var sayHi = function(name){\r
- alert('Hi, ' + name);\r
-}\r
-\r
-sayHi('Fred'); // alerts "Hi, Fred"\r
-\r
-// create a new function that validates input without\r
-// directly modifying the original function:\r
-var sayHiToFriend = sayHi.createInterceptor(function(name){\r
- return name == 'Brian';\r
-});\r
-\r
-sayHiToFriend('Fred'); // no alert\r
-sayHiToFriend('Brian'); // alerts "Hi, Brian"\r
-</code></pre>\r
- * @param {Function} fcn The function to call before the original\r
- * @param {Object} scope (optional) The scope of the passed fcn (Defaults to scope of original function or window)\r
- * @return {Function} The new function\r
- */\r
- createInterceptor : function(fcn, scope){\r
- var method = this;\r
- return !Ext.isFunction(fcn) ?\r
- this :\r
- function() {\r
- var me = this,\r
- args = arguments;\r
- fcn.target = me;\r
- fcn.method = method;\r
- return (fcn.apply(scope || me || window, args) !== false) ?\r
- method.apply(me || window, args) :\r
- null;\r
- };\r
- },\r
-\r
- /**\r
- * Creates a callback that passes arguments[0], arguments[1], arguments[2], ...\r
- * Call directly on any function. Example: <code>myFunction.createCallback(arg1, arg2)</code>\r
- * Will create a function that is bound to those 2 args. <b>If a specific scope is required in the\r
- * callback, use {@link #createDelegate} instead.</b> The function returned by createCallback always\r
- * executes in the window scope.\r
- * <p>This method is required when you want to pass arguments to a callback function. If no arguments\r
- * are needed, you can simply pass a reference to the function as a callback (e.g., callback: myFn).\r
- * However, if you tried to pass a function with arguments (e.g., callback: myFn(arg1, arg2)) the function\r
- * would simply execute immediately when the code is parsed. Example usage:\r
- * <pre><code>\r
-var sayHi = function(name){\r
- alert('Hi, ' + name);\r
-}\r
-\r
-// clicking the button alerts "Hi, Fred"\r
-new Ext.Button({\r
- text: 'Say Hi',\r
- renderTo: Ext.getBody(),\r
- handler: sayHi.createCallback('Fred')\r
-});\r
-</code></pre>\r
- * @return {Function} The new function\r
- */\r
- createCallback : function(/*args...*/){\r
- // make args available, in function below\r
- var args = arguments,\r
- method = this;\r
- return function() {\r
- return method.apply(window, args);\r
- };\r
- },\r
-\r
- /**\r
- * Creates a delegate (callback) that sets the scope to obj.\r
- * Call directly on any function. Example: <code>this.myFunction.createDelegate(this, [arg1, arg2])</code>\r
- * Will create a function that is automatically scoped to obj so that the <tt>this</tt> variable inside the\r
- * callback points to obj. Example usage:\r
- * <pre><code>\r
-var sayHi = function(name){\r
- // Note this use of "this.text" here. This function expects to\r
- // execute within a scope that contains a text property. In this\r
- // example, the "this" variable is pointing to the btn object that\r
- // was passed in createDelegate below.\r
- alert('Hi, ' + name + '. You clicked the "' + this.text + '" button.');\r
-}\r
-\r
-var btn = new Ext.Button({\r
- text: 'Say Hi',\r
- renderTo: Ext.getBody()\r
-});\r
-\r
-// This callback will execute in the scope of the\r
-// button instance. Clicking the button alerts\r
-// "Hi, Fred. You clicked the "Say Hi" button."\r
-btn.on('click', sayHi.createDelegate(btn, ['Fred']));\r
-</code></pre>\r
- * @param {Object} obj (optional) The object for which the scope is set\r
- * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)\r
- * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,\r
- * if a number the args are inserted at the specified position\r
- * @return {Function} The new function\r
- */\r
- createDelegate : function(obj, args, appendArgs){\r
- var method = this;\r
- return function() {\r
- var callArgs = args || arguments;\r
- if (appendArgs === true){\r
- callArgs = Array.prototype.slice.call(arguments, 0);\r
- callArgs = callArgs.concat(args);\r
- }else if (Ext.isNumber(appendArgs)){\r
- callArgs = Array.prototype.slice.call(arguments, 0); // copy arguments first\r
- var applyArgs = [appendArgs, 0].concat(args); // create method call params\r
- Array.prototype.splice.apply(callArgs, applyArgs); // splice them in\r
- }\r
- return method.apply(obj || window, callArgs);\r
- };\r
- },\r
-\r
- /**\r
- * Calls this function after the number of millseconds specified, optionally in a specific scope. Example usage:\r
- * <pre><code>\r
-var sayHi = function(name){\r
- alert('Hi, ' + name);\r
-}\r
-\r
-// executes immediately:\r
-sayHi('Fred');\r
-\r
-// executes after 2 seconds:\r
-sayHi.defer(2000, this, ['Fred']);\r
-\r
-// this syntax is sometimes useful for deferring\r
-// execution of an anonymous function:\r
-(function(){\r
- alert('Anonymous');\r
-}).defer(100);\r
-</code></pre>\r
- * @param {Number} millis The number of milliseconds for the setTimeout call (if less than or equal to 0 the function is executed immediately)\r
- * @param {Object} obj (optional) The object for which the scope is set\r
- * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)\r
- * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,\r
- * if a number the args are inserted at the specified position\r
- * @return {Number} The timeout id that can be used with clearTimeout\r
- */\r
- defer : function(millis, obj, args, appendArgs){\r
- var fn = this.createDelegate(obj, args, appendArgs);\r
- if(millis > 0){\r
- return setTimeout(fn, millis);\r
- }\r
- fn();\r
- return 0;\r
- }\r
-});\r
-\r
-/**\r
- * @class String\r
- * These functions are available on every String object.\r
- */\r
-Ext.applyIf(String, {\r
- /**\r
- * Allows you to define a tokenized string and pass an arbitrary number of arguments to replace the tokens. Each\r
- * token must be unique, and must increment in the format {0}, {1}, etc. Example usage:\r
- * <pre><code>\r
-var cls = 'my-class', text = 'Some text';\r
-var s = String.format('<div class="{0}">{1}</div>', cls, text);\r
-// s now contains the string: '<div class="my-class">Some text</div>'\r
- * </code></pre>\r
- * @param {String} string The tokenized string to be formatted\r
- * @param {String} value1 The value to replace token {0}\r
- * @param {String} value2 Etc...\r
- * @return {String} The formatted string\r
- * @static\r
- */\r
- format : function(format){\r
- var args = Ext.toArray(arguments, 1);\r
- return format.replace(/\{(\d+)\}/g, function(m, i){\r
- return args[i];\r
- });\r
- }\r
-});\r
-\r
-/**\r
- * @class Array\r
- */\r
-Ext.applyIf(Array.prototype, {\r
- /**\r
- * Checks whether or not the specified object exists in the array.\r
- * @param {Object} o The object to check for\r
- * @return {Number} The index of o in the array (or -1 if it is not found)\r
- */\r
- indexOf : function(o){\r
- for (var i = 0, len = this.length; i < len; i++){\r
- if(this[i] == o){\r
- return i;\r
- }\r
- }\r
- return -1;\r
- },\r
-\r
- /**\r
- * Removes the specified object from the array. If the object is not found nothing happens.\r
- * @param {Object} o The object to remove\r
- * @return {Array} this array\r
- */\r
- remove : function(o){\r
- var index = this.indexOf(o);\r
- if(index != -1){\r
- this.splice(index, 1);\r
- }\r
- return this;\r
- }\r
-});\r
+// for old browsers
+window.undefined = window.undefined;
+
/**
* @class Ext
+ * Ext core utilities and functions.
+ * @singleton
*/
-Ext.ns("Ext.grid", "Ext.dd", "Ext.tree", "Ext.form", "Ext.menu",
- "Ext.state", "Ext.layout", "Ext.app", "Ext.ux", "Ext.chart", "Ext.direct");
+Ext = {
/**
- * Namespace alloted for extensions to the framework.
- * @property ux
- * @type Object
+ * The version of the framework
+ * @type String
*/
+ version : '3.3.0',
+ versionDetail : {
+ major : 3,
+ minor : 3,
+ patch : 0
+ }
+};
-Ext.apply(Ext, function(){
- var E = Ext, idSeed = 0;
+/**
+ * Copies all the properties of config to obj.
+ * @param {Object} obj The receiver of the properties
+ * @param {Object} config The source of the properties
+ * @param {Object} defaults A different object that will also be applied for default values
+ * @return {Object} returns obj
+ * @member Ext apply
+ */
+Ext.apply = function(o, c, defaults){
+ // no "this" reference for friendly out of scope calls
+ if(defaults){
+ Ext.apply(o, defaults);
+ }
+ if(o && c && typeof c == 'object'){
+ for(var p in c){
+ o[p] = c[p];
+ }
+ }
+ return o;
+};
- return {
- /**
- * A reusable empty function
- * @property
- * @type Function
- */
- emptyFn : function(){},
+(function(){
+ var idSeed = 0,
+ toString = Object.prototype.toString,
+ ua = navigator.userAgent.toLowerCase(),
+ check = function(r){
+ return r.test(ua);
+ },
+ DOC = document,
+ docMode = DOC.documentMode,
+ isStrict = DOC.compatMode == "CSS1Compat",
+ isOpera = check(/opera/),
+ isChrome = check(/\bchrome\b/),
+ isWebKit = check(/webkit/),
+ isSafari = !isChrome && check(/safari/),
+ isSafari2 = isSafari && check(/applewebkit\/4/), // unique to Safari 2
+ isSafari3 = isSafari && check(/version\/3/),
+ isSafari4 = isSafari && check(/version\/4/),
+ isIE = !isOpera && check(/msie/),
+ isIE7 = isIE && (check(/msie 7/) || docMode == 7),
+ isIE8 = isIE && (check(/msie 8/) && docMode != 7),
+ isIE6 = isIE && !isIE7 && !isIE8,
+ isGecko = !isWebKit && check(/gecko/),
+ isGecko2 = isGecko && check(/rv:1\.8/),
+ isGecko3 = isGecko && check(/rv:1\.9/),
+ isBorderBox = isIE && !isStrict,
+ isWindows = check(/windows|win32/),
+ isMac = check(/macintosh|mac os x/),
+ isAir = check(/adobeair/),
+ isLinux = check(/linux/),
+ isSecure = /^https/i.test(window.location.protocol);
+
+ // remove css image flicker
+ if(isIE6){
+ try{
+ DOC.execCommand("BackgroundImageCache", false, true);
+ }catch(e){}
+ }
+ Ext.apply(Ext, {
/**
- * URL to a 1x1 transparent gif image used by Ext to create inline icons with CSS background images.
- * In older versions of IE, this defaults to "http://extjs.com/s.gif" and you should change this to a URL on your server.
- * For other browsers it uses an inline data URL.
+ * URL to a blank file used by Ext when in secure mode for iframe src and onReady src to prevent
+ * the IE insecure content warning (<tt>'about:blank'</tt>, except for IE in secure mode, which is <tt>'javascript:""'</tt>).
* @type String
*/
- BLANK_IMAGE_URL : Ext.isIE6 || Ext.isIE7 ?
- 'http:/' + '/extjs.com/s.gif' :
- 'data:image/gif;base64,R0lGODlhAQABAID/AMDAwAAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==',
+ SSL_SECURE_URL : isSecure && isIE ? 'javascript:""' : 'about:blank',
+ /**
+ * True if the browser is in strict (standards-compliant) mode, as opposed to quirks mode
+ * @type Boolean
+ */
+ isStrict : isStrict,
+ /**
+ * True if the page is running over SSL
+ * @type Boolean
+ */
+ isSecure : isSecure,
+ /**
+ * True when the document is fully initialized and ready for action
+ * @type Boolean
+ */
+ isReady : false,
- extendX : function(supr, fn){
- return Ext.extend(supr, fn(supr.prototype));
- },
+ /**
+ * True if the {@link Ext.Fx} Class is available
+ * @type Boolean
+ * @property enableFx
+ */
/**
- * Returns the current HTML document object as an {@link Ext.Element}.
- * @return Ext.Element The document
+ * HIGHLY EXPERIMENTAL
+ * True to force css based border-box model override and turning off javascript based adjustments. This is a
+ * runtime configuration and must be set before onReady.
+ * @type Boolean
*/
- getDoc : function(){
- return Ext.get(document);
- },
+ enableForcedBoxModel : false,
/**
- * Returns true if the passed object is a JavaScript date object, otherwise false.
- * @param {Object} object The object to test
- * @return {Boolean}
+ * True to automatically uncache orphaned Ext.Elements periodically (defaults to true)
+ * @type Boolean
*/
- isDate : function(v){
- return Object.prototype.toString.apply(v) === '[object Date]';
- },
+ enableGarbageCollector : true,
/**
- * Utility method for validating that a value is numeric, returning the specified default value if it is not.
- * @param {Mixed} value Should be a number, but any type will be handled appropriately
- * @param {Number} defaultValue The value to return if the original value is non-numeric
- * @return {Number} Value, if numeric, else defaultValue
+ * True to automatically purge event listeners during garbageCollection (defaults to false).
+ * @type Boolean
*/
- num : function(v, defaultValue){
- v = Number(v === null || typeof v == 'boolean'? NaN : v);
- return isNaN(v)? defaultValue : v;
- },
+ enableListenerCollection : false,
/**
- * <p>Utility method for returning a default value if the passed value is empty.</p>
- * <p>The value is deemed to be empty if it is<div class="mdetail-params"><ul>
- * <li>null</li>
- * <li>undefined</li>
- * <li>an empty array</li>
- * <li>a zero length string (Unless the <tt>allowBlank</tt> parameter is <tt>true</tt>)</li>
- * </ul></div>
- * @param {Mixed} value The value to test
- * @param {Mixed} defaultValue The value to return if the original value is empty
- * @param {Boolean} allowBlank (optional) true to allow zero length strings to qualify as non-empty (defaults to false)
- * @return {Mixed} value, if non-empty, else defaultValue
+ * EXPERIMENTAL - True to cascade listener removal to child elements when an element is removed.
+ * Currently not optimized for performance.
+ * @type Boolean
*/
- value : function(v, defaultValue, allowBlank){
- return Ext.isEmpty(v, allowBlank) ? defaultValue : v;
- },
+ enableNestedListenerRemoval : false,
/**
- * Escapes the passed string for use in a regular expression
- * @param {String} str
- * @return {String}
+ * Indicates whether to use native browser parsing for JSON methods.
+ * This option is ignored if the browser does not support native JSON methods.
+ * <b>Note: Native JSON methods will not work with objects that have functions.
+ * Also, property names must be quoted, otherwise the data will not parse.</b> (Defaults to false)
+ * @type Boolean
+ */
+ USE_NATIVE_JSON : false,
+
+ /**
+ * Copies all the properties of config to obj if they don't already exist.
+ * @param {Object} obj The receiver of the properties
+ * @param {Object} config The source of the properties
+ * @return {Object} returns obj
*/
- escapeRe : function(s) {
- return s.replace(/([.*+?^${}()|[\]\/\\])/g, "\\$1");
+ applyIf : function(o, c){
+ if(o){
+ for(var p in c){
+ if(!Ext.isDefined(o[p])){
+ o[p] = c[p];
+ }
+ }
+ }
+ return o;
},
- sequence : function(o, name, fn, scope){
- o[name] = o[name].createSequence(fn, scope);
+ /**
+ * Generates unique ids. If the element already has an id, it is unchanged
+ * @param {Mixed} el (optional) The element to generate an id for
+ * @param {String} prefix (optional) Id prefix (defaults "ext-gen")
+ * @return {String} The generated Id.
+ */
+ id : function(el, prefix){
+ el = Ext.getDom(el, true) || {};
+ if (!el.id) {
+ el.id = (prefix || "ext-gen") + (++idSeed);
+ }
+ return el.id;
},
/**
- * Applies event listeners to elements by selectors when the document is ready.
- * The event name is specified with an <tt>@</tt> suffix.
+ * <p>Extends one class to create a subclass and optionally overrides members with the passed literal. This method
+ * also adds the function "override()" to the subclass that can be used to override members of the class.</p>
+ * For example, to create a subclass of Ext GridPanel:
* <pre><code>
-Ext.addBehaviors({
- // add a listener for click on all anchors in element with id foo
- '#foo a@click' : function(e, t){
- // do something
+MyGridPanel = Ext.extend(Ext.grid.GridPanel, {
+ constructor: function(config) {
+
+// Create configuration for this Grid.
+ var store = new Ext.data.Store({...});
+ var colModel = new Ext.grid.ColumnModel({...});
+
+// Create a new config object containing our computed properties
+// *plus* whatever was in the config parameter.
+ config = Ext.apply({
+ store: store,
+ colModel: colModel
+ }, config);
+
+ MyGridPanel.superclass.constructor.call(this, config);
+
+// Your postprocessing here
},
-
- // add the same listener to multiple selectors (separated by comma BEFORE the @)
- '#foo a, #bar span.some-class@mouseover' : function(){
- // do something
+
+ yourMethod: function() {
+ // etc.
}
});
- * </code></pre>
- * @param {Object} obj The list of behaviors to apply
+</code></pre>
+ *
+ * <p>This function also supports a 3-argument call in which the subclass's constructor is
+ * passed as an argument. In this form, the parameters are as follows:</p>
+ * <div class="mdetail-params"><ul>
+ * <li><code>subclass</code> : Function <div class="sub-desc">The subclass constructor.</div></li>
+ * <li><code>superclass</code> : Function <div class="sub-desc">The constructor of class being extended</div></li>
+ * <li><code>overrides</code> : Object <div class="sub-desc">A literal with members which are copied into the subclass's
+ * prototype, and are therefore shared among all instances of the new class.</div></li>
+ * </ul></div>
+ *
+ * @param {Function} superclass The constructor of class being extended.
+ * @param {Object} overrides <p>A literal with members which are copied into the subclass's
+ * prototype, and are therefore shared between all instances of the new class.</p>
+ * <p>This may contain a special member named <tt><b>constructor</b></tt>. This is used
+ * to define the constructor of the new class, and is returned. If this property is
+ * <i>not</i> specified, a constructor is generated and returned which just calls the
+ * superclass's constructor passing on its parameters.</p>
+ * <p><b>It is essential that you call the superclass constructor in any provided constructor. See example code.</b></p>
+ * @return {Function} The subclass constructor from the <code>overrides</code> parameter, or a generated one if not provided.
*/
- addBehaviors : function(o){
- if(!Ext.isReady){
- Ext.onReady(function(){
- Ext.addBehaviors(o);
+ extend : function(){
+ // inline overrides
+ var io = function(o){
+ for(var m in o){
+ this[m] = o[m];
+ }
+ };
+ var oc = Object.prototype.constructor;
+
+ return function(sb, sp, overrides){
+ if(typeof sp == 'object'){
+ overrides = sp;
+ sp = sb;
+ sb = overrides.constructor != oc ? overrides.constructor : function(){sp.apply(this, arguments);};
+ }
+ var F = function(){},
+ sbp,
+ spp = sp.prototype;
+
+ F.prototype = spp;
+ sbp = sb.prototype = new F();
+ sbp.constructor=sb;
+ sb.superclass=spp;
+ if(spp.constructor == oc){
+ spp.constructor=sp;
+ }
+ sb.override = function(o){
+ Ext.override(sb, o);
+ };
+ sbp.superclass = sbp.supr = (function(){
+ return spp;
});
- } else {
- var cache = {}, // simple cache for applying multiple behaviors to same selector does query multiple times
- parts,
- b,
- s;
- for (b in o) {
- if ((parts = b.split('@'))[1]) { // for Object prototype breakers
- s = parts[0];
- if(!cache[s]){
- cache[s] = Ext.select(s);
- }
- cache[s].on(parts[1], o[b]);
- }
+ sbp.override = io;
+ Ext.override(sb, overrides);
+ sb.extend = function(o){return Ext.extend(sb, o);};
+ return sb;
+ };
+ }(),
+
+ /**
+ * Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name.
+ * Usage:<pre><code>
+Ext.override(MyClass, {
+ newMethod1: function(){
+ // etc.
+ },
+ newMethod2: function(foo){
+ // etc.
+ }
+});
+</code></pre>
+ * @param {Object} origclass The class to override
+ * @param {Object} overrides The list of functions to add to origClass. This should be specified as an object literal
+ * containing one or more methods.
+ * @method override
+ */
+ override : function(origclass, overrides){
+ if(overrides){
+ var p = origclass.prototype;
+ Ext.apply(p, overrides);
+ if(Ext.isIE && overrides.hasOwnProperty('toString')){
+ p.toString = overrides.toString;
}
- cache = null;
}
},
+ /**
+ * Creates namespaces to be used for scoping variables and classes so that they are not global.
+ * Specifying the last node of a namespace implicitly creates all other nodes. Usage:
+ * <pre><code>
+Ext.namespace('Company', 'Company.data');
+Ext.namespace('Company.data'); // equivalent and preferable to above syntax
+Company.Widget = function() { ... }
+Company.data.CustomStore = function(config) { ... }
+</code></pre>
+ * @param {String} namespace1
+ * @param {String} namespace2
+ * @param {String} etc
+ * @return {Object} The namespace object. (If multiple arguments are passed, this will be the last namespace created)
+ * @method namespace
+ */
+ namespace : function(){
+ var o, d;
+ Ext.each(arguments, function(v) {
+ d = v.split(".");
+ o = window[d[0]] = window[d[0]] || {};
+ Ext.each(d.slice(1), function(v2){
+ o = o[v2] = o[v2] || {};
+ });
+ });
+ return o;
+ },
- // deprecated
- combine : function(){
- var as = arguments, l = as.length, r = [];
- for(var i = 0; i < l; i++){
- var a = as[i];
- if(Ext.isArray(a)){
- r = r.concat(a);
- }else if(a.length !== undefined && !a.substr){
- r = r.concat(Array.prototype.slice.call(a, 0));
- }else{
- r.push(a);
- }
+ /**
+ * Takes an object and converts it to an encoded URL. e.g. Ext.urlEncode({foo: 1, bar: 2}); would return "foo=1&bar=2". Optionally, property values can be arrays, instead of keys and the resulting string that's returned will contain a name/value pair for each array value.
+ * @param {Object} o
+ * @param {String} pre (optional) A prefix to add to the url encoded string
+ * @return {String}
+ */
+ urlEncode : function(o, pre){
+ var empty,
+ buf = [],
+ e = encodeURIComponent;
+
+ Ext.iterate(o, function(key, item){
+ empty = Ext.isEmpty(item);
+ Ext.each(empty ? key : item, function(val){
+ buf.push('&', e(key), '=', (!Ext.isEmpty(val) && (val != key || !empty)) ? (Ext.isDate(val) ? Ext.encode(val).replace(/"/g, '') : e(val)) : '');
+ });
+ });
+ if(!pre){
+ buf.shift();
+ pre = '';
}
- return r;
+ return pre + buf.join('');
},
/**
- * Copies a set of named properties fom the source object to the destination object.
- * <p>example:<pre><code>
-ImageComponent = Ext.extend(Ext.BoxComponent, {
- initComponent: function() {
- this.autoEl = { tag: 'img' };
- MyComponent.superclass.initComponent.apply(this, arguments);
- this.initialBox = Ext.copyTo({}, this.initialConfig, 'x,y,width,height');
- }
-});
- * </code></pre>
- * @param {Object} The destination object.
- * @param {Object} The source object.
- * @param {Array/String} Either an Array of property names, or a comma-delimited list
- * of property names to copy.
- * @return {Object} The modified object.
- */
- copyTo : function(dest, source, names){
- if(typeof names == 'string'){
- names = names.split(/[,;\s]/);
+ * Takes an encoded URL and and converts it to an object. Example: <pre><code>
+Ext.urlDecode("foo=1&bar=2"); // returns {foo: "1", bar: "2"}
+Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2", "3", "4"]}
+</code></pre>
+ * @param {String} string
+ * @param {Boolean} overwrite (optional) Items of the same name will overwrite previous values instead of creating an an array (Defaults to false).
+ * @return {Object} A literal with members
+ */
+ urlDecode : function(string, overwrite){
+ if(Ext.isEmpty(string)){
+ return {};
}
- Ext.each(names, function(name){
- if(source.hasOwnProperty(name)){
- dest[name] = source[name];
- }
- }, this);
- return dest;
+ var obj = {},
+ pairs = string.split('&'),
+ d = decodeURIComponent,
+ name,
+ value;
+ Ext.each(pairs, function(pair) {
+ pair = pair.split('=');
+ name = d(pair[0]);
+ value = d(pair[1]);
+ obj[name] = overwrite || !obj[name] ? value :
+ [].concat(obj[name]).concat(value);
+ });
+ return obj;
},
/**
- * Attempts to destroy any objects passed to it by removing all event listeners, removing them from the
- * DOM (if applicable) and calling their destroy functions (if available). This method is primarily
- * intended for arguments of type {@link Ext.Element} and {@link Ext.Component}, but any subclass of
- * {@link Ext.util.Observable} can be passed in. Any number of elements and/or components can be
- * passed into this function in a single call as separate arguments.
- * @param {Mixed} arg1 An {@link Ext.Element}, {@link Ext.Component}, or an Array of either of these to destroy
- * @param {Mixed} arg2 (optional)
- * @param {Mixed} etc... (optional)
+ * Appends content to the query string of a URL, handling logic for whether to place
+ * a question mark or ampersand.
+ * @param {String} url The URL to append to.
+ * @param {String} s The content to append to the URL.
+ * @return (String) The resulting URL
*/
- destroy : function(){
- Ext.each(arguments, function(arg){
- if(arg){
- if(Ext.isArray(arg)){
- this.destroy.apply(this, arg);
- }else if(Ext.isFunction(arg.destroy)){
- arg.destroy();
- }else if(arg.dom){
- arg.remove();
- }
- }
- }, this);
+ urlAppend : function(url, s){
+ if(!Ext.isEmpty(s)){
+ return url + (url.indexOf('?') === -1 ? '?' : '&') + s;
+ }
+ return url;
},
/**
- * Attempts to destroy and then remove a set of named properties of the passed object.
- * @param {Object} o The object (most likely a Component) who's properties you wish to destroy.
- * @param {Mixed} arg1 The name of the property to destroy and remove from the object.
- * @param {Mixed} etc... More property names to destroy and remove.
+ * Converts any iterable (numeric indices and a length property) into a true array
+ * Don't use this on strings. IE doesn't support "abc"[0] which this implementation depends on.
+ * For strings, use this instead: "abc".match(/./g) => [a,b,c];
+ * @param {Iterable} the iterable object to be turned into a true Array.
+ * @return (Array) array
*/
- destroyMembers : function(o, arg1, arg2, etc){
- for(var i = 1, a = arguments, len = a.length; i < len; i++) {
- Ext.destroy(o[a[i]]);
- delete o[a[i]];
+ toArray : function(){
+ return isIE ?
+ function(a, i, j, res){
+ res = [];
+ for(var x = 0, len = a.length; x < len; x++) {
+ res.push(a[x]);
+ }
+ return res.slice(i || 0, j || res.length);
+ } :
+ function(a, i, j){
+ return Array.prototype.slice.call(a, i || 0, j || a.length);
+ };
+ }(),
+
+ isIterable : function(v){
+ //check for array or arguments
+ if(Ext.isArray(v) || v.callee){
+ return true;
}
+ //check for node list type
+ if(/NodeList|HTMLCollection/.test(toString.call(v))){
+ return true;
+ }
+ //NodeList has an item and length property
+ //IXMLDOMNodeList has nextNode method, needs to be checked first.
+ return ((typeof v.nextNode != 'undefined' || v.item) && Ext.isNumber(v.length));
},
/**
- * Creates a copy of the passed Array with falsy values removed.
- * @param {Array/NodeList} arr The Array from which to remove falsy values.
- * @return {Array} The new, compressed Array.
+ * Iterates an array calling the supplied function.
+ * @param {Array/NodeList/Mixed} array The array to be iterated. If this
+ * argument is not really an array, the supplied function is called once.
+ * @param {Function} fn The function to be called with each item. If the
+ * supplied function returns false, iteration stops and this method returns
+ * the current <code>index</code>. This function is called with
+ * the following arguments:
+ * <div class="mdetail-params"><ul>
+ * <li><code>item</code> : <i>Mixed</i>
+ * <div class="sub-desc">The item at the current <code>index</code>
+ * in the passed <code>array</code></div></li>
+ * <li><code>index</code> : <i>Number</i>
+ * <div class="sub-desc">The current index within the array</div></li>
+ * <li><code>allItems</code> : <i>Array</i>
+ * <div class="sub-desc">The <code>array</code> passed as the first
+ * argument to <code>Ext.each</code>.</div></li>
+ * </ul></div>
+ * @param {Object} scope The scope (<code>this</code> reference) in which the specified function is executed.
+ * Defaults to the <code>item</code> at the current <code>index</code>
+ * within the passed <code>array</code>.
+ * @return See description for the fn parameter.
*/
- clean : function(arr){
- var ret = [];
- Ext.each(arr, function(v){
- if(!!v){
- ret.push(v);
- }
- });
- return ret;
+ each : function(array, fn, scope){
+ if(Ext.isEmpty(array, true)){
+ return;
+ }
+ if(!Ext.isIterable(array) || Ext.isPrimitive(array)){
+ array = [array];
+ }
+ for(var i = 0, len = array.length; i < len; i++){
+ if(fn.call(scope || array[i], array[i], i, array) === false){
+ return i;
+ };
+ }
},
/**
- * Creates a copy of the passed Array, filtered to contain only unique values.
- * @param {Array} arr The Array to filter
- * @return {Array} The new Array containing unique values.
+ * Iterates either the elements in an array, or each of the properties in an object.
+ * <b>Note</b>: If you are only iterating arrays, it is better to call {@link #each}.
+ * @param {Object/Array} object The object or array to be iterated
+ * @param {Function} fn The function to be called for each iteration.
+ * The iteration will stop if the supplied function returns false, or
+ * all array elements / object properties have been covered. The signature
+ * varies depending on the type of object being interated:
+ * <div class="mdetail-params"><ul>
+ * <li>Arrays : <tt>(Object item, Number index, Array allItems)</tt>
+ * <div class="sub-desc">
+ * When iterating an array, the supplied function is called with each item.</div></li>
+ * <li>Objects : <tt>(String key, Object value, Object)</tt>
+ * <div class="sub-desc">
+ * When iterating an object, the supplied function is called with each key-value pair in
+ * the object, and the iterated object</div></li>
+ * </ul></div>
+ * @param {Object} scope The scope (<code>this</code> reference) in which the specified function is executed. Defaults to
+ * the <code>object</code> being iterated.
*/
- unique : function(arr){
- var ret = [],
- collect = {};
-
- Ext.each(arr, function(v) {
- if(!collect[v]){
- ret.push(v);
+ iterate : function(obj, fn, scope){
+ if(Ext.isEmpty(obj)){
+ return;
+ }
+ if(Ext.isIterable(obj)){
+ Ext.each(obj, fn, scope);
+ return;
+ }else if(typeof obj == 'object'){
+ for(var prop in obj){
+ if(obj.hasOwnProperty(prop)){
+ if(fn.call(scope || obj, prop, obj[prop], obj) === false){
+ return;
+ };
+ }
}
- collect[v] = true;
- });
- return ret;
+ }
},
/**
- * Recursively flattens into 1-d Array. Injects Arrays inline.
- * @param {Array} arr The array to flatten
- * @return {Array} The new, flattened array.
+ * Return the dom node for the passed String (id), dom node, or Ext.Element.
+ * Optional 'strict' flag is needed for IE since it can return 'name' and
+ * 'id' elements by using getElementById.
+ * Here are some examples:
+ * <pre><code>
+// gets dom node based on id
+var elDom = Ext.getDom('elId');
+// gets dom node based on the dom node
+var elDom1 = Ext.getDom(elDom);
+
+// If we don't know if we are working with an
+// Ext.Element or a dom node use Ext.getDom
+function(el){
+ var dom = Ext.getDom(el);
+ // do something with the dom node
+}
+ * </code></pre>
+ * <b>Note</b>: the dom node to be found actually needs to exist (be rendered, etc)
+ * when this method is called to be successful.
+ * @param {Mixed} el
+ * @return HTMLElement
*/
- flatten : function(arr){
- var worker = [];
- function rFlatten(a) {
- Ext.each(a, function(v) {
- if(Ext.isArray(v)){
- rFlatten(v);
- }else{
- worker.push(v);
+ getDom : function(el, strict){
+ if(!el || !DOC){
+ return null;
+ }
+ if (el.dom){
+ return el.dom;
+ } else {
+ if (typeof el == 'string') {
+ var e = DOC.getElementById(el);
+ // IE returns elements with the 'name' and 'id' attribute.
+ // we do a strict check to return the element with only the id attribute
+ if (e && isIE && strict) {
+ if (el == e.getAttribute('id')) {
+ return e;
+ } else {
+ return null;
+ }
}
- });
- return worker;
+ return e;
+ } else {
+ return el;
+ }
}
- return rFlatten(arr);
},
/**
- * Returns the minimum value in the Array.
- * @param {Array|NodeList} arr The Array from which to select the minimum value.
- * @param {Function} comp (optional) a function to perform the comparision which determines minimization.
- * If omitted the "<" operator will be used. Note: gt = 1; eq = 0; lt = -1
- * @return {Object} The minimum value in the Array.
+ * Returns the current document body as an {@link Ext.Element}.
+ * @return Ext.Element The document body
*/
- min : function(arr, comp){
- var ret = arr[0];
- comp = comp || function(a,b){ return a < b ? -1 : 1; };
- Ext.each(arr, function(v) {
- ret = comp(ret, v) == -1 ? ret : v;
- });
- return ret;
+ getBody : function(){
+ return Ext.get(DOC.body || DOC.documentElement);
},
+
+ /**
+ * Returns the current document body as an {@link Ext.Element}.
+ * @return Ext.Element The document body
+ */
+ getHead : function() {
+ var head;
+
+ return function() {
+ if (head == undefined) {
+ head = Ext.get(DOC.getElementsByTagName("head")[0]);
+ }
+
+ return head;
+ };
+ }(),
/**
- * Returns the maximum value in the Array
- * @param {Array|NodeList} arr The Array from which to select the maximum value.
- * @param {Function} comp (optional) a function to perform the comparision which determines maximization.
- * If omitted the ">" operator will be used. Note: gt = 1; eq = 0; lt = -1
- * @return {Object} The maximum value in the Array.
+ * Removes a DOM node from the document.
*/
- max : function(arr, comp){
- var ret = arr[0];
- comp = comp || function(a,b){ return a > b ? 1 : -1; };
- Ext.each(arr, function(v) {
- ret = comp(ret, v) == 1 ? ret : v;
- });
- return ret;
+ /**
+ * <p>Removes this element from the document, removes all DOM event listeners, and deletes the cache reference.
+ * All DOM event listeners are removed from this element. If {@link Ext#enableNestedListenerRemoval} is
+ * <code>true</code>, then DOM event listeners are also removed from all child nodes. The body node
+ * will be ignored if passed in.</p>
+ * @param {HTMLElement} node The node to remove
+ */
+ removeNode : isIE && !isIE8 ? function(){
+ var d;
+ return function(n){
+ if(n && n.tagName != 'BODY'){
+ (Ext.enableNestedListenerRemoval) ? Ext.EventManager.purgeElement(n, true) : Ext.EventManager.removeAll(n);
+ d = d || DOC.createElement('div');
+ d.appendChild(n);
+ d.innerHTML = '';
+ delete Ext.elCache[n.id];
+ }
+ };
+ }() : function(n){
+ if(n && n.parentNode && n.tagName != 'BODY'){
+ (Ext.enableNestedListenerRemoval) ? Ext.EventManager.purgeElement(n, true) : Ext.EventManager.removeAll(n);
+ n.parentNode.removeChild(n);
+ delete Ext.elCache[n.id];
+ }
},
/**
- * Calculates the mean of the Array
- * @param {Array} arr The Array to calculate the mean value of.
- * @return {Number} The mean.
+ * <p>Returns true if the passed value is empty.</p>
+ * <p>The value is deemed to be empty if it is<div class="mdetail-params"><ul>
+ * <li>null</li>
+ * <li>undefined</li>
+ * <li>an empty array</li>
+ * <li>a zero length string (Unless the <tt>allowBlank</tt> parameter is <tt>true</tt>)</li>
+ * </ul></div>
+ * @param {Mixed} value The value to test
+ * @param {Boolean} allowBlank (optional) true to allow empty strings (defaults to false)
+ * @return {Boolean}
*/
- mean : function(arr){
- return Ext.sum(arr) / arr.length;
+ isEmpty : function(v, allowBlank){
+ return v === null || v === undefined || ((Ext.isArray(v) && !v.length)) || (!allowBlank ? v === '' : false);
},
/**
- * Calculates the sum of the Array
- * @param {Array} arr The Array to calculate the sum value of.
- * @return {Number} The sum.
+ * Returns true if the passed value is a JavaScript array, otherwise false.
+ * @param {Mixed} value The value to test
+ * @return {Boolean}
*/
- sum : function(arr){
- var ret = 0;
- Ext.each(arr, function(v) {
- ret += v;
- });
- return ret;
+ isArray : function(v){
+ return toString.apply(v) === '[object Array]';
},
/**
- * Partitions the set into two sets: a true set and a false set.
- * Example:
- * Example2:
- * <pre><code>
-// Example 1:
-Ext.partition([true, false, true, true, false]); // [[true, true, true], [false, false]]
-
-// Example 2:
-Ext.partition(
- Ext.query("p"),
- function(val){
- return val.className == "class1"
- }
-);
-// true are those paragraph elements with a className of "class1",
-// false set are those that do not have that className.
- * </code></pre>
- * @param {Array|NodeList} arr The array to partition
- * @param {Function} truth (optional) a function to determine truth. If this is omitted the element
- * itself must be able to be evaluated for its truthfulness.
- * @return {Array} [true<Array>,false<Array>]
+ * Returns true if the passed object is a JavaScript date object, otherwise false.
+ * @param {Object} object The object to test
+ * @return {Boolean}
*/
- partition : function(arr, truth){
- var ret = [[],[]];
- Ext.each(arr, function(v, i, a) {
- ret[ (truth && truth(v, i, a)) || (!truth && v) ? 0 : 1].push(v);
- });
- return ret;
+ isDate : function(v){
+ return toString.apply(v) === '[object Date]';
},
/**
- * Invokes a method on each item in an Array.
- * <pre><code>
-// Example:
-Ext.invoke(Ext.query("p"), "getAttribute", "id");
-// [el1.getAttribute("id"), el2.getAttribute("id"), ..., elN.getAttribute("id")]
- * </code></pre>
- * @param {Array|NodeList} arr The Array of items to invoke the method on.
- * @param {String} methodName The method name to invoke.
- * @param {Anything} ... Arguments to send into the method invocation.
- * @return {Array} The results of invoking the method on each item in the array.
+ * Returns true if the passed value is a JavaScript Object, otherwise false.
+ * @param {Mixed} value The value to test
+ * @return {Boolean}
*/
- invoke : function(arr, methodName){
- var ret = [],
- args = Array.prototype.slice.call(arguments, 2);
- Ext.each(arr, function(v,i) {
- if (v && typeof v[methodName] == "function") {
- ret.push(v[methodName].apply(v, args));
- } else {
- ret.push(undefined);
- }
- });
- return ret;
+ isObject : function(v){
+ return !!v && Object.prototype.toString.call(v) === '[object Object]';
},
/**
- * Plucks the value of a property from each item in the Array
- * <pre><code>
-// Example:
-Ext.pluck(Ext.query("p"), "className"); // [el1.className, el2.className, ..., elN.className]
- * </code></pre>
- * @param {Array|NodeList} arr The Array of items to pluck the value from.
- * @param {String} prop The property name to pluck from each element.
- * @return {Array} The value from each item in the Array.
+ * Returns true if the passed value is a JavaScript 'primitive', a string, number or boolean.
+ * @param {Mixed} value The value to test
+ * @return {Boolean}
*/
- pluck : function(arr, prop){
- var ret = [];
- Ext.each(arr, function(v) {
- ret.push( v[prop] );
- });
- return ret;
+ isPrimitive : function(v){
+ return Ext.isString(v) || Ext.isNumber(v) || Ext.isBoolean(v);
},
/**
- * <p>Zips N sets together.</p>
- * <pre><code>
-// Example 1:
-Ext.zip([1,2,3],[4,5,6]); // [[1,4],[2,5],[3,6]]
-// Example 2:
-Ext.zip(
- [ "+", "-", "+"],
- [ 12, 10, 22],
- [ 43, 15, 96],
- function(a, b, c){
- return "$" + a + "" + b + "." + c
- }
-); // ["$+12.43", "$-10.15", "$+22.96"]
- * </code></pre>
- * @param {Arrays|NodeLists} arr This argument may be repeated. Array(s) to contribute values.
- * @param {Function} zipper (optional) The last item in the argument list. This will drive how the items are zipped together.
- * @return {Array} The zipped set.
+ * Returns true if the passed value is a JavaScript Function, otherwise false.
+ * @param {Mixed} value The value to test
+ * @return {Boolean}
*/
- zip : function(){
- var parts = Ext.partition(arguments, function( val ){ return !Ext.isFunction(val); }),
- arrs = parts[0],
- fn = parts[1][0],
- len = Ext.max(Ext.pluck(arrs, "length")),
- ret = [];
-
- for (var i = 0; i < len; i++) {
- ret[i] = [];
- if(fn){
- ret[i] = fn.apply(fn, Ext.pluck(arrs, i));
- }else{
- for (var j = 0, aLen = arrs.length; j < aLen; j++){
- ret[i].push( arrs[j][i] );
- }
- }
- }
- return ret;
+ isFunction : function(v){
+ return toString.apply(v) === '[object Function]';
},
/**
- * This is shorthand reference to {@link Ext.ComponentMgr#get}.
- * Looks up an existing {@link Ext.Component Component} by {@link Ext.Component#id id}
- * @param {String} id The component {@link Ext.Component#id id}
- * @return Ext.Component The Component, <tt>undefined</tt> if not found, or <tt>null</tt> if a
- * Class was found.
- */
- getCmp : function(id){
- return Ext.ComponentMgr.get(id);
+ * Returns true if the passed value is a number. Returns false for non-finite numbers.
+ * @param {Mixed} value The value to test
+ * @return {Boolean}
+ */
+ isNumber : function(v){
+ return typeof v === 'number' && isFinite(v);
},
/**
- * By default, Ext intelligently decides whether floating elements should be shimmed. If you are using flash,
- * you may want to set this to true.
- * @type Boolean
+ * Returns true if the passed value is a string.
+ * @param {Mixed} value The value to test
+ * @return {Boolean}
+ */
+ isString : function(v){
+ return typeof v === 'string';
+ },
+
+ /**
+ * Returns true if the passed value is a boolean.
+ * @param {Mixed} value The value to test
+ * @return {Boolean}
*/
- useShims: E.isIE6 || (E.isMac && E.isGecko2),
+ isBoolean : function(v){
+ return typeof v === 'boolean';
+ },
- // inpired by a similar function in mootools library
/**
- * Returns the type of object that is passed in. If the object passed in is null or undefined it
- * return false otherwise it returns one of the following values:<div class="mdetail-params"><ul>
- * <li><b>string</b>: If the object passed is a string</li>
- * <li><b>number</b>: If the object passed is a number</li>
- * <li><b>boolean</b>: If the object passed is a boolean value</li>
- * <li><b>date</b>: If the object passed is a Date object</li>
- * <li><b>function</b>: If the object passed is a function reference</li>
- * <li><b>object</b>: If the object passed is an object</li>
- * <li><b>array</b>: If the object passed is an array</li>
- * <li><b>regexp</b>: If the object passed is a regular expression</li>
- * <li><b>element</b>: If the object passed is a DOM Element</li>
- * <li><b>nodelist</b>: If the object passed is a DOM NodeList</li>
- * <li><b>textnode</b>: If the object passed is a DOM text node and contains something other than whitespace</li>
- * <li><b>whitespace</b>: If the object passed is a DOM text node and contains only whitespace</li>
- * </ul></div>
- * @param {Mixed} object
- * @return {String}
+ * Returns true if the passed value is an HTMLElement
+ * @param {Mixed} value The value to test
+ * @return {Boolean}
*/
- type : function(o){
- if(o === undefined || o === null){
- return false;
- }
- if(o.htmlElement){
- return 'element';
- }
- var t = typeof o;
- if(t == 'object' && o.nodeName) {
- switch(o.nodeType) {
- case 1: return 'element';
- case 3: return (/\S/).test(o.nodeValue) ? 'textnode' : 'whitespace';
- }
- }
- if(t == 'object' || t == 'function') {
- switch(o.constructor) {
- case Array: return 'array';
- case RegExp: return 'regexp';
- case Date: return 'date';
- }
- if(typeof o.length == 'number' && typeof o.item == 'function') {
- return 'nodelist';
- }
- }
- return t;
+ isElement : function(v) {
+ return v ? !!v.tagName : false;
},
- intercept : function(o, name, fn, scope){
- o[name] = o[name].createInterceptor(fn, scope);
+ /**
+ * Returns true if the passed value is not undefined.
+ * @param {Mixed} value The value to test
+ * @return {Boolean}
+ */
+ isDefined : function(v){
+ return typeof v !== 'undefined';
},
- // internal
- callback : function(cb, scope, args, delay){
- if(Ext.isFunction(cb)){
- if(delay){
- cb.defer(delay, scope, args || []);
- }else{
- cb.apply(scope, args || []);
- }
- }
- }
- };
-}());
+ /**
+ * True if the detected browser is Opera.
+ * @type Boolean
+ */
+ isOpera : isOpera,
+ /**
+ * True if the detected browser uses WebKit.
+ * @type Boolean
+ */
+ isWebKit : isWebKit,
+ /**
+ * True if the detected browser is Chrome.
+ * @type Boolean
+ */
+ isChrome : isChrome,
+ /**
+ * True if the detected browser is Safari.
+ * @type Boolean
+ */
+ isSafari : isSafari,
+ /**
+ * True if the detected browser is Safari 3.x.
+ * @type Boolean
+ */
+ isSafari3 : isSafari3,
+ /**
+ * True if the detected browser is Safari 4.x.
+ * @type Boolean
+ */
+ isSafari4 : isSafari4,
+ /**
+ * True if the detected browser is Safari 2.x.
+ * @type Boolean
+ */
+ isSafari2 : isSafari2,
+ /**
+ * True if the detected browser is Internet Explorer.
+ * @type Boolean
+ */
+ isIE : isIE,
+ /**
+ * True if the detected browser is Internet Explorer 6.x.
+ * @type Boolean
+ */
+ isIE6 : isIE6,
+ /**
+ * True if the detected browser is Internet Explorer 7.x.
+ * @type Boolean
+ */
+ isIE7 : isIE7,
+ /**
+ * True if the detected browser is Internet Explorer 8.x.
+ * @type Boolean
+ */
+ isIE8 : isIE8,
+ /**
+ * True if the detected browser uses the Gecko layout engine (e.g. Mozilla, Firefox).
+ * @type Boolean
+ */
+ isGecko : isGecko,
+ /**
+ * True if the detected browser uses a pre-Gecko 1.9 layout engine (e.g. Firefox 2.x).
+ * @type Boolean
+ */
+ isGecko2 : isGecko2,
+ /**
+ * True if the detected browser uses a Gecko 1.9+ layout engine (e.g. Firefox 3.x).
+ * @type Boolean
+ */
+ isGecko3 : isGecko3,
+ /**
+ * True if the detected browser is Internet Explorer running in non-strict mode.
+ * @type Boolean
+ */
+ isBorderBox : isBorderBox,
+ /**
+ * True if the detected platform is Linux.
+ * @type Boolean
+ */
+ isLinux : isLinux,
+ /**
+ * True if the detected platform is Windows.
+ * @type Boolean
+ */
+ isWindows : isWindows,
+ /**
+ * True if the detected platform is Mac OS.
+ * @type Boolean
+ */
+ isMac : isMac,
+ /**
+ * True if the detected platform is Adobe Air.
+ * @type Boolean
+ */
+ isAir : isAir
+ });
+
+ /**
+ * Creates namespaces to be used for scoping variables and classes so that they are not global.
+ * Specifying the last node of a namespace implicitly creates all other nodes. Usage:
+ * <pre><code>
+Ext.namespace('Company', 'Company.data');
+Ext.namespace('Company.data'); // equivalent and preferable to above syntax
+Company.Widget = function() { ... }
+Company.data.CustomStore = function(config) { ... }
+</code></pre>
+ * @param {String} namespace1
+ * @param {String} namespace2
+ * @param {String} etc
+ * @return {Object} The namespace object. (If multiple arguments are passed, this will be the last namespace created)
+ * @method ns
+ */
+ Ext.ns = Ext.namespace;
+})();
+
+Ext.ns('Ext.util', 'Ext.lib', 'Ext.data', 'Ext.supports');
+
+Ext.elCache = {};
/**
* @class Function
* These functions are available on every Function object (any JavaScript function).
*/
Ext.apply(Function.prototype, {
- /**
- * Create a combined function call sequence of the original function + the passed function.
- * The resulting function returns the results of the original function.
- * The passed fcn is called with the parameters of the original function. Example usage:
+ /**
+ * Creates an interceptor function. The passed function is called before the original one. If it returns false,
+ * the original one is not called. The resulting function returns the results of the original function.
+ * The passed function is called with the parameters of the original function. Example usage:
* <pre><code>
var sayHi = function(name){
alert('Hi, ' + name);
sayHi('Fred'); // alerts "Hi, Fred"
-var sayGoodbye = sayHi.createSequence(function(name){
- alert('Bye, ' + name);
+// create a new function that validates input without
+// directly modifying the original function:
+var sayHiToFriend = sayHi.createInterceptor(function(name){
+ return name == 'Brian';
});
-sayGoodbye('Fred'); // both alerts show
+sayHiToFriend('Fred'); // no alert
+sayHiToFriend('Brian'); // alerts "Hi, Brian"
</code></pre>
- * @param {Function} fcn The function to sequence
- * @param {Object} scope (optional) The scope of the passed fcn (Defaults to scope of original function or window)
+ * @param {Function} fcn The function to call before the original
+ * @param {Object} scope (optional) The scope (<code><b>this</b></code> reference) in which the passed function is executed.
+ * <b>If omitted, defaults to the scope in which the original function is called or the browser window.</b>
* @return {Function} The new function
*/
- createSequence : function(fcn, scope){
+ createInterceptor : function(fcn, scope){
var method = this;
return !Ext.isFunction(fcn) ?
this :
- function(){
- var retval = method.apply(this || window, arguments);
- fcn.apply(scope || this || window, arguments);
- return retval;
+ function() {
+ var me = this,
+ args = arguments;
+ fcn.target = me;
+ fcn.method = method;
+ return (fcn.apply(scope || me || window, args) !== false) ?
+ method.apply(me || window, args) :
+ null;
};
- }
-});
+ },
+ /**
+ * Creates a callback that passes arguments[0], arguments[1], arguments[2], ...
+ * Call directly on any function. Example: <code>myFunction.createCallback(arg1, arg2)</code>
+ * Will create a function that is bound to those 2 args. <b>If a specific scope is required in the
+ * callback, use {@link #createDelegate} instead.</b> The function returned by createCallback always
+ * executes in the window scope.
+ * <p>This method is required when you want to pass arguments to a callback function. If no arguments
+ * are needed, you can simply pass a reference to the function as a callback (e.g., callback: myFn).
+ * However, if you tried to pass a function with arguments (e.g., callback: myFn(arg1, arg2)) the function
+ * would simply execute immediately when the code is parsed. Example usage:
+ * <pre><code>
+var sayHi = function(name){
+ alert('Hi, ' + name);
+}
-/**
- * @class String
- * These functions are available as static methods on the JavaScript String object.
- */
-Ext.applyIf(String, {
+// clicking the button alerts "Hi, Fred"
+new Ext.Button({
+ text: 'Say Hi',
+ renderTo: Ext.getBody(),
+ handler: sayHi.createCallback('Fred')
+});
+</code></pre>
+ * @return {Function} The new function
+ */
+ createCallback : function(/*args...*/){
+ // make args available, in function below
+ var args = arguments,
+ method = this;
+ return function() {
+ return method.apply(window, args);
+ };
+ },
/**
- * Escapes the passed string for ' and \
- * @param {String} string The string to escape
- * @return {String} The escaped string
- * @static
+ * Creates a delegate (callback) that sets the scope to obj.
+ * Call directly on any function. Example: <code>this.myFunction.createDelegate(this, [arg1, arg2])</code>
+ * Will create a function that is automatically scoped to obj so that the <tt>this</tt> variable inside the
+ * callback points to obj. Example usage:
+ * <pre><code>
+var sayHi = function(name){
+ // Note this use of "this.text" here. This function expects to
+ // execute within a scope that contains a text property. In this
+ // example, the "this" variable is pointing to the btn object that
+ // was passed in createDelegate below.
+ alert('Hi, ' + name + '. You clicked the "' + this.text + '" button.');
+}
+
+var btn = new Ext.Button({
+ text: 'Say Hi',
+ renderTo: Ext.getBody()
+});
+
+// This callback will execute in the scope of the
+// button instance. Clicking the button alerts
+// "Hi, Fred. You clicked the "Say Hi" button."
+btn.on('click', sayHi.createDelegate(btn, ['Fred']));
+</code></pre>
+ * @param {Object} scope (optional) The scope (<code><b>this</b></code> reference) in which the function is executed.
+ * <b>If omitted, defaults to the browser window.</b>
+ * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
+ * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
+ * if a number the args are inserted at the specified position
+ * @return {Function} The new function
*/
- escape : function(string) {
- return string.replace(/('|\\)/g, "\\$1");
+ createDelegate : function(obj, args, appendArgs){
+ var method = this;
+ return function() {
+ var callArgs = args || arguments;
+ if (appendArgs === true){
+ callArgs = Array.prototype.slice.call(arguments, 0);
+ callArgs = callArgs.concat(args);
+ }else if (Ext.isNumber(appendArgs)){
+ callArgs = Array.prototype.slice.call(arguments, 0); // copy arguments first
+ var applyArgs = [appendArgs, 0].concat(args); // create method call params
+ Array.prototype.splice.apply(callArgs, applyArgs); // splice them in
+ }
+ return method.apply(obj || window, callArgs);
+ };
},
/**
- * Pads the left side of a string with a specified character. This is especially useful
- * for normalizing number and date strings. Example usage:
+ * Calls this function after the number of millseconds specified, optionally in a specific scope. Example usage:
* <pre><code>
-var s = String.leftPad('123', 5, '0');
-// s now contains the string: '00123'
- * </code></pre>
- * @param {String} string The original string
- * @param {Number} size The total length of the output string
- * @param {String} char (optional) The character with which to pad the original string (defaults to empty string " ")
- * @return {String} The padded string
- * @static
+var sayHi = function(name){
+ alert('Hi, ' + name);
+}
+
+// executes immediately:
+sayHi('Fred');
+
+// executes after 2 seconds:
+sayHi.defer(2000, this, ['Fred']);
+
+// this syntax is sometimes useful for deferring
+// execution of an anonymous function:
+(function(){
+ alert('Anonymous');
+}).defer(100);
+</code></pre>
+ * @param {Number} millis The number of milliseconds for the setTimeout call (if less than or equal to 0 the function is executed immediately)
+ * @param {Object} scope (optional) The scope (<code><b>this</b></code> reference) in which the function is executed.
+ * <b>If omitted, defaults to the browser window.</b>
+ * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
+ * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
+ * if a number the args are inserted at the specified position
+ * @return {Number} The timeout id that can be used with clearTimeout
*/
- leftPad : function (val, size, ch) {
- var result = String(val);
- if(!ch) {
- ch = " ";
- }
- while (result.length < size) {
- result = ch + result;
+ defer : function(millis, obj, args, appendArgs){
+ var fn = this.createDelegate(obj, args, appendArgs);
+ if(millis > 0){
+ return setTimeout(fn, millis);
}
- return result;
+ fn();
+ return 0;
}
});
/**
- * Utility function that allows you to easily switch a string between two alternating values. The passed value
- * is compared to the current string, and if they are equal, the other value that was passed in is returned. If
- * they are already different, the first value passed in is returned. Note that this method returns the new value
- * but does not change the current string.
- * <pre><code>
-// alternate sort directions
-sort = sort.toggle('ASC', 'DESC');
-
-// instead of conditional logic:
-sort = (sort == 'ASC' ? 'DESC' : 'ASC');
-</code></pre>
- * @param {String} value The value to compare to the current string
- * @param {String} other The new value to use if the string already equals the first value passed in
- * @return {String} The new value
- */
-String.prototype.toggle = function(value, other){
- return this == value ? other : value;
-};
-
-/**
- * Trims whitespace from either end of a string, leaving spaces within the string intact. Example:
- * <pre><code>
-var s = ' foo bar ';
-alert('-' + s + '-'); //alerts "- foo bar -"
-alert('-' + s.trim() + '-'); //alerts "-foo bar-"
-</code></pre>
- * @return {String} The trimmed string
+ * @class String
+ * These functions are available on every String object.
*/
-String.prototype.trim = function(){
- var re = /^\s+|\s+$/g;
- return function(){ return this.replace(re, ""); };
-}();
+Ext.applyIf(String, {
+ /**
+ * Allows you to define a tokenized string and pass an arbitrary number of arguments to replace the tokens. Each
+ * token must be unique, and must increment in the format {0}, {1}, etc. Example usage:
+ * <pre><code>
+var cls = 'my-class', text = 'Some text';
+var s = String.format('<div class="{0}">{1}</div>', cls, text);
+// s now contains the string: '<div class="my-class">Some text</div>'
+ * </code></pre>
+ * @param {String} string The tokenized string to be formatted
+ * @param {String} value1 The value to replace token {0}
+ * @param {String} value2 Etc...
+ * @return {String} The formatted string
+ * @static
+ */
+ format : function(format){
+ var args = Ext.toArray(arguments, 1);
+ return format.replace(/\{(\d+)\}/g, function(m, i){
+ return args[i];
+ });
+ }
+});
-// here to prevent dependency on Date.js
/**
- Returns the number of milliseconds between this date and date
- @param {Date} date (optional) Defaults to now
- @return {Number} The diff in milliseconds
- @member Date getElapsed
+ * @class Array
*/
-Date.prototype.getElapsed = function(date) {
- return Math.abs((date || new Date()).getTime()-this.getTime());
-};
-
+Ext.applyIf(Array.prototype, {
+ /**
+ * Checks whether or not the specified object exists in the array.
+ * @param {Object} o The object to check for
+ * @param {Number} from (Optional) The index at which to begin the search
+ * @return {Number} The index of o in the array (or -1 if it is not found)
+ */
+ indexOf : function(o, from){
+ var len = this.length;
+ from = from || 0;
+ from += (from < 0) ? len : 0;
+ for (; from < len; ++from){
+ if(this[from] === o){
+ return from;
+ }
+ }
+ return -1;
+ },
-/**
- * @class Number
- */
-Ext.applyIf(Number.prototype, {
/**
- * Checks whether or not the current number is within a desired range. If the number is already within the
- * range it is returned, otherwise the min or max value is returned depending on which side of the range is
- * exceeded. Note that this method returns the constrained value but does not change the current number.
- * @param {Number} min The minimum number in the range
- * @param {Number} max The maximum number in the range
- * @return {Number} The constrained value if outside the range, otherwise the current value
+ * Removes the specified object from the array. If the object is not found nothing happens.
+ * @param {Object} o The object to remove
+ * @return {Array} this array
*/
- constrain : function(min, max){
- return Math.min(Math.max(this, min), max);
+ remove : function(o){
+ var index = this.indexOf(o);
+ if(index != -1){
+ this.splice(index, 1);
+ }
+ return this;
}
});
/**
});
* </code></pre>
+ * <p>See the {@link #start} method for details about how to configure a task object.</p>
* Also see {@link Ext.util.DelayedTask}.
*
* @constructor
/**
* Starts a new task.
* @method start
- * @param {Object} task A config object that supports the following properties:<ul>
- * <li><code>run</code> : Function<div class="sub-desc">The function to execute each time the task is run. The
- * function will be called at each interval and passed the <code>args</code> argument if specified. If a
- * particular scope is required, be sure to specify it using the <code>scope</code> argument.</div></li>
+ * @param {Object} task <p>A config object that supports the following properties:<ul>
+ * <li><code>run</code> : Function<div class="sub-desc"><p>The function to execute each time the task is invoked. The
+ * function will be called at each interval and passed the <code>args</code> argument if specified, and the
+ * current invocation count if not.</p>
+ * <p>If a particular scope (<code>this</code> reference) is required, be sure to specify it using the <code>scope</code> argument.</p>
+ * <p>Return <code>false</code> from this function to terminate the task.</p></div></li>
* <li><code>interval</code> : Number<div class="sub-desc">The frequency in milliseconds with which the task
- * should be executed.</div></li>
+ * should be invoked.</div></li>
* <li><code>args</code> : Array<div class="sub-desc">(optional) An array of arguments to be passed to the function
- * specified by <code>run</code>.</div></li>
+ * specified by <code>run</code>. If not specified, the current invocation count is passed.</div></li>
* <li><code>scope</code> : Object<div class="sub-desc">(optional) The scope (<tt>this</tt> reference) in which to execute the
* <code>run</code> function. Defaults to the task config object.</div></li>
- * <li><code>duration</code> : Number<div class="sub-desc">(optional) The length of time in milliseconds to execute
+ * <li><code>duration</code> : Number<div class="sub-desc">(optional) The length of time in milliseconds to invoke
* the task before stopping automatically (defaults to indefinite).</div></li>
- * <li><code>repeat</code> : Number<div class="sub-desc">(optional) The number of times to execute the task before
+ * <li><code>repeat</code> : Number<div class="sub-desc">(optional) The number of times to invoke the task before
* stopping automatically (defaults to indefinite).</div></li>
- * </ul>
+ * </ul></p>
+ * <p>Before each invocation, Ext injects the property <code>taskRunCount</code> into the task object so
+ * that calculations based on the repeat count can be performed.</p>
* @return {Object} The task
*/
this.start = function(task){
}
Ext.TaskMgr.start(task);
</code></pre>
+ * <p>See the {@link #start} method for details about how to configure a task object.</p>
* @singleton
*/
Ext.TaskMgr = new Ext.util.TaskRunner();if(typeof jQuery == "undefined"){
},
isAncestor : function(p, c){
+ var ret = false;
+
p = Ext.getDom(p);
c = Ext.getDom(c);
- if (!p || !c) {return false;}
-
- if(p.contains && !Ext.isSafari) {
- return p.contains(c);
- }else if(p.compareDocumentPosition) {
- return !!(p.compareDocumentPosition(c) & 16);
- }else{
- var parent = c.parentNode;
- while (parent) {
- if (parent == p) {
- return true;
- }
- else if (!parent.tagName || parent.tagName.toUpperCase() == "HTML") {
- return false;
+ if (p && c) {
+ if (p.contains) {
+ return p.contains(c);
+ } else if (p.compareDocumentPosition) {
+ return !!(p.compareDocumentPosition(c) & 16);
+ } else {
+ while (c = c.parentNode) {
+ ret = c == p || ret;
}
- parent = parent.parentNode;
}
- return false;
}
+ return ret;
},
getRegion : function(el){
var iid = setInterval(f, 50);
},
- resolveTextNode: function(node) {
- if (node && 3 == node.nodeType) {
- return node.parentNode;
- } else {
- return node;
+ resolveTextNode: Ext.isGecko ? function(node){
+ if(!node){
+ return;
}
+ var s = HTMLElement.prototype.toString.call(node);
+ if(s == '[xpconnect wrapped native prototype]' || s == '[object XULElement]'){
+ return;
+ }
+ return node.nodeType == 3 ? node.parentNode : node;
+ } : function(node){
+ return node && node.nodeType == 3 ? node.parentNode : node;
},
getRelatedTarget: function(ev) {
var createComplete = function(cb){
return function(xhr, status){
if((status == 'error' || status == 'timeout') && cb.failure){
- cb.failure.call(cb.scope||window, {
- responseText: xhr.responseText,
- responseXML : xhr.responseXML,
- argument: cb.argument
- });
+ cb.failure.call(cb.scope||window, createResponse(cb, xhr));
}else if(cb.success){
- cb.success.call(cb.scope||window, {
- responseText: xhr.responseText,
- responseXML : xhr.responseXML,
- argument: cb.argument
- });
+ cb.success.call(cb.scope||window, createResponse(cb, xhr));
}
};
};
+
+ var createResponse = function(cb, xhr){
+ var headerObj = {},
+ headerStr,
+ t,
+ s;
+
+ try {
+ headerStr = xhr.getAllResponseHeaders();
+ Ext.each(headerStr.replace(/\r\n/g, '\n').split('\n'), function(v){
+ t = v.indexOf(':');
+ if(t >= 0){
+ s = v.substr(0, t).toLowerCase();
+ if(v.charAt(t + 1) == ' '){
+ ++t;
+ }
+ headerObj[s] = v.substr(t + 1);
+ }
+ });
+ } catch(e) {}
+
+ return {
+ responseText: xhr.responseText,
+ responseXML : xhr.responseXML,
+ argument: cb.argument,
+ status: xhr.status,
+ statusText: xhr.statusText,
+ getResponseHeader : function(header){
+ return headerObj[header.toLowerCase()];
+ },
+ getAllResponseHeaders : function(){
+ return headerStr;
+ }
+ };
+ };
return {
request : function(method, uri, cb, data, options){
var o = {
}
if(hs){
o.beforeSend = function(xhr){
- for(var h in hs){
- if(hs.hasOwnProperty(h)){
+ for (var h in hs) {
+ if (hs.hasOwnProperty(h)) {
xhr.setRequestHeader(h, hs[h]);
}
}
- }
+ };
}
}
jQuery.ajax(o);
if (args.top.from)
e.setTop(args.top.from);
break;
+ // jQuery can't handle callback, scope, and xy arguments, so break here
+ case 'callback':
+ case 'scope':
+ case 'xy':
+ break;
+
default:
o[k] = args[k].to;
if (args[k].from)
git.ithinksw.org / extjs.git / blobdiff