X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/0494b8d9b9bb03ab6c22b34dae81261e3cd7e3e6..f562e4c6e5fac7bcb445985b99acbea4d706e6f0:/docs/source/Ext.html diff --git a/docs/source/Ext.html b/docs/source/Ext.html index 161c66cc..4c7b103c 100644 --- a/docs/source/Ext.html +++ b/docs/source/Ext.html @@ -1,1062 +1,604 @@ +
- +/*! - * Ext JS Library 3.3.1 - * Copyright(c) 2006-2010 Sencha Inc. - * licensing@sencha.com - * http://www.sencha.com/license - */ -// for old browsers -window.undefined = window.undefined; - -/** - * @class Ext - * Ext core utilities and functions. + +- \ No newline at end of file +/** + * @class Ext * @singleton */ +(function() { + var global = this, + objectPrototype = Object.prototype, + toString = objectPrototype.toString, + enumerables = true, + enumerablesTest = { toString: 1 }, + i; + + if (typeof Ext === 'undefined') { + global.Ext = {}; + } -Ext = { - /** - * The version of the framework - * @type String - */ - version : '3.3.1', - versionDetail : { - major : 3, - minor : 3, - patch : 1 + Ext.global = global; + + for (i in enumerablesTest) { + enumerables = null; } -}; - -/** - * 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 (enumerables) { + enumerables = ['hasOwnProperty', 'valueOf', 'isPrototypeOf', 'propertyIsEnumerable', + 'toLocaleString', 'toString', 'constructor']; } - if(o && c && typeof c == 'object'){ - for(var p in c){ - o[p] = c[p]; + + /** + * An array containing extra enumerables for old browsers + * @property {String[]} + */ + Ext.enumerables = enumerables; + + /** + * Copies all the properties of config to the specified object. + * Note that if recursive merging and cloning without referencing the original objects / arrays is needed, use + * {@link Ext.Object#merge} instead. + * @param {Object} object 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 + */ + Ext.apply = function(object, config, defaults) { + if (defaults) { + Ext.apply(object, defaults); } - } - return o; -}; - -(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 blank file used by Ext when in secure mode for iframe src and onReady src to prevent - * the IE insecure content warning ('about:blank', except for IE in secure mode, which is 'javascript:""'). - * @type String - */ - 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, + if (object && config && typeof config === 'object') { + var i, j, k; - /** - * True if the {@link Ext.Fx} Class is available - * @type Boolean - * @property enableFx - */ + for (i in config) { + object[i] = config[i]; + } - /** - * 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 - */ - enableForcedBoxModel : false, + if (enumerables) { + for (j = enumerables.length; j--;) { + k = enumerables[j]; + if (config.hasOwnProperty(k)) { + object[k] = config[k]; + } + } + } + } - /** - * True to automatically uncache orphaned Ext.Elements periodically (defaults to true) - * @type Boolean - */ - enableGarbageCollector : true, + return object; + }; - /** - * True to automatically purge event listeners during garbageCollection (defaults to false). - * @type Boolean - */ - enableListenerCollection : false, + Ext.buildSettings = Ext.apply({ + baseCSSPrefix: 'x-', + scopeResetCSS: false + }, Ext.buildSettings || {}); - /** - * EXPERIMENTAL - True to cascade listener removal to child elements when an element is removed. - * Currently not optimized for performance. - * @type Boolean - */ - enableNestedListenerRemoval : false, - - /** - * Indicates whether to use native browser parsing for JSON methods. - * This option is ignored if the browser does not support native JSON methods. - * Note: Native JSON methods will not work with objects that have functions. - * Also, property names must be quoted, otherwise the data will not parse. (Defaults to false) - * @type Boolean + Ext.apply(Ext, { + /** + * A reusable empty function */ - USE_NATIVE_JSON : false, + emptyFn: function() {}, + + baseCSSPrefix: Ext.buildSettings.baseCSSPrefix, - /** - * Copies all the properties of config to obj if they don't already exist. - * @param {Object} obj The receiver of the properties + /** + * Copies all the properties of config to object if they don't already exist. + * @param {Object} object The receiver of the properties * @param {Object} config The source of the properties * @return {Object} returns obj */ - applyIf : function(o, c){ - if(o){ - for(var p in c){ - if(!Ext.isDefined(o[p])){ - o[p] = c[p]; + applyIf: function(object, config) { + var property; + + if (object) { + for (property in config) { + if (object[property] === undefined) { + object[property] = config[property]; } } } - return o; - }, - /** - * 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; + return object; }, - /** - *+ Ext.type = Ext.typeOf; + +})(); +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.
- * For example, to create a subclass of Ext GridPanel: - *- * - *-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({...}); + /** + * Iterates either an array or an object. This method delegates to + * {@link Ext.Array#each Ext.Array.each} if the given value is iterable, and {@link Ext.Object#each Ext.Object.each} otherwise. + * + * @param {Object/Array} object The object or array to be iterated. + * @param {Function} fn The function to be called for each iteration. See and {@link Ext.Array#each Ext.Array.each} and + * {@link Ext.Object#each Ext.Object.each} for detailed lists of arguments passed to this function depending on the given object + * type that is being iterated. + * @param {Object} scope (Optional) The scope (`this` reference) in which the specified function is executed. + * Defaults to the object being iterated itself. + * @markdown + */ + iterate: function(object, fn, scope) { + if (Ext.isEmpty(object)) { + return; + } -// Create a new config object containing our computed properties -// *plus* whatever was in the config parameter. - config = Ext.apply({ - store: store, - colModel: colModel - }, config); + if (scope === undefined) { + scope = object; + } - MyGridPanel.superclass.constructor.call(this, config); + if (Ext.isIterable(object)) { + Ext.Array.each.call(Ext.Array, object, fn, scope); + } + else { + Ext.Object.each.call(Ext.Object, object, fn, scope); + } + } + }); -// Your postprocessing here - }, + Ext.apply(Ext, { - yourMethod: function() { - // etc. - } -}); -
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:
- *- * - * @param {Function} superclass The constructor of class being extended. - * @param {Object} overrides- *
- - *
subclass
: FunctionThe subclass constructor.- - *
superclass
: FunctionThe constructor of class being extended- - *
overrides
: ObjectA literal with members which are copied into the subclass's - * prototype, and are therefore shared among all instances of the new class.A literal with members which are copied into the subclass's - * prototype, and are therefore shared between all instances of the new class.
- *This may contain a special member named constructor. This is used - * to define the constructor of the new class, and is returned. If this property is - * not specified, a constructor is generated and returned which just calls the - * superclass's constructor passing on its parameters.
- *It is essential that you call the superclass constructor in any provided constructor. See example code.
- * @return {Function} The subclass constructor from theoverrides
parameter, or a generated one if not provided. + /** + * This method deprecated. Use {@link Ext#define Ext.define} instead. + * @method + * @param {Function} superclass + * @param {Object} overrides + * @return {Function} The subclass constructor from the <tt>overrides</tt> parameter, or a generated one if not provided. + * @deprecated 4.0.0 Use {@link Ext#define Ext.define} instead */ - extend : function(){ + extend: function() { // inline overrides - var io = function(o){ - for(var m in o){ + var objectConstructor = objectPrototype.constructor, + inlineOverrides = function(o) { + for (var m in o) { + if (!o.hasOwnProperty(m)) { + continue; + } 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);}; + return function(subclass, superclass, overrides) { + // First we check if the user passed in just the superClass with overrides + if (Ext.isObject(superclass)) { + overrides = superclass; + superclass = subclass; + subclass = overrides.constructor !== objectConstructor ? overrides.constructor : function() { + superclass.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; + + //<debug> + if (!superclass) { + Ext.Error.raise({ + sourceClass: 'Ext', + sourceMethod: 'extend', + msg: 'Attempting to extend from a class which has not been loaded on the page.' + }); } - sb.override = function(o){ - Ext.override(sb, o); + //</debug> + + // We create a new temporary class + var F = function() {}, + subclassProto, superclassProto = superclass.prototype; + + F.prototype = superclassProto; + subclassProto = subclass.prototype = new F(); + subclassProto.constructor = subclass; + subclass.superclass = superclassProto; + + if (superclassProto.constructor === objectConstructor) { + superclassProto.constructor = superclass; + } + + subclass.override = function(overrides) { + Ext.override(subclass, overrides); }; - sbp.superclass = sbp.supr = (function(){ - return spp; - }); - sbp.override = io; - Ext.override(sb, overrides); - sb.extend = function(o){return Ext.extend(sb, o);}; - return sb; + + subclassProto.override = inlineOverrides; + subclassProto.proto = subclassProto; + + subclass.override(overrides); + subclass.extend = function(o) { + return Ext.extend(subclass, o); + }; + + return subclass; }; }(), - /** - * Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name. - * Usage:- * @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 + + Ext.override(My.cool.Class, { + sayHi: function() { + alert('About to say...'); + + this.callOverridden(); + } + }); + + var cool = new My.cool.Class(); + cool.sayHi(); // alerts 'About to say...' + // alerts 'Hi!' + + * Please note that `this.callOverridden()` only works if the class was previously + * created with {@link Ext#define) + * + * @param {Object} cls 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 + * @markdown */ - override : function(origclass, overrides){ - if(overrides){ - var p = origclass.prototype; - Ext.apply(p, overrides); - if(Ext.isIE && overrides.hasOwnProperty('toString')){ - p.toString = overrides.toString; - } + override: function(cls, overrides) { + if (cls.prototype.$className) { + return cls.override(overrides); } - }, + else { + Ext.apply(cls.prototype, overrides); + } + } + }); + + // A full set of static methods to do type checking + Ext.apply(Ext, { - /** - * 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: - *-Ext.override(MyClass, { - newMethod1: function(){ - // etc. - }, - newMethod2: function(foo){ - // etc. + /** + * Proxy to {@link Ext.Base#override}. Please refer {@link Ext.Base#override} for further details. + + Ext.define('My.cool.Class', { + sayHi: function() { + alert('Hi!'); + } } -}); -
- * @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 + /** + * Returns the given value itself if it's not empty, as described in {@link Ext#isEmpty}; returns the default + * value (second argument) otherwise. + * + * @param {Object} value The value to test + * @param {Object} 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 {Object} value, if non-empty, else defaultValue */ - 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; + valueFrom: function(value, defaultValue, allowBlank){ + return Ext.isEmpty(value, allowBlank) ? defaultValue : value; }, - /** - * 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 + /** + * Returns the type of the given variable in string format. List of possible values are: + * + * - `undefined`: If the given value is `undefined` + * - `null`: If the given value is `null` + * - `string`: If the given value is a string + * - `number`: If the given value is a number + * - `boolean`: If the given value is a boolean value + * - `date`: If the given value is a `Date` object + * - `function`: If the given value is a function reference + * - `object`: If the given value is an object + * - `array`: If the given value is an array + * - `regexp`: If the given value is a regular expression + * - `element`: If the given value is a DOM Element + * - `textnode`: If the given value is a DOM text node and contains something other than whitespace + * - `whitespace`: If the given value is a DOM text node and contains only whitespace + * + * @param {Object} value * @return {String} + * @markdown */ - 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 = ''; + typeOf: function(value) { + if (value === null) { + return 'null'; } - return pre + buf.join(''); - }, - /** - * Takes an encoded URL and and converts it to an object. Example:-Ext.namespace('Company', 'Company.data'); -Ext.namespace('Company.data'); // equivalent and preferable to above syntax -Company.Widget = function() { ... } -Company.data.CustomStore = function(config) { ... } -
- * @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 {}; - } - 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; - }, + var type = typeof value; - /** - * 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 - */ - urlAppend : function(url, s){ - if(!Ext.isEmpty(s)){ - return url + (url.indexOf('?') === -1 ? '?' : '&') + s; + if (type === 'undefined' || type === 'string' || type === 'number' || type === 'boolean') { + return type; } - return url; - }, - /** - * 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 - */ - 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; + var typeToString = toString.call(value); + + switch(typeToString) { + case '[object Array]': + return 'array'; + case '[object Date]': + return 'date'; + case '[object Boolean]': + return 'boolean'; + case '[object Number]': + return 'number'; + case '[object RegExp]': + return 'regexp'; } - //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)); - }, - /** - * 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-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"]} -
index
. This function is called with - * the following arguments: - *- * @param {Object} scope The scope (- *
- - *
item
: Mixed - *The item at the currentindex
- * in the passedarray
- - *
index
: Number - *The current index within the array- - *
allItems
: Array - *Thearray
passed as the first - * argument toExt.each
.this
reference) in which the specified function is executed. - * Defaults to theitem
at the currentindex
- * within the passedarray
. - * @return See description for the fn parameter. - */ - each : function(array, fn, scope){ - if(Ext.isEmpty(array, true)){ - return; - } - if(!Ext.isIterable(array) || Ext.isPrimitive(array)){ - array = [array]; + if (type === 'function') { + return 'function'; } - for(var i = 0, len = array.length; i < len; i++){ - if(fn.call(scope || array[i], array[i], i, array) === false){ - return i; - }; - } - }, - /** - * Iterates either the elements in an array, or each of the properties in an object. - * Note: 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: - *- * @param {Object} scope The scope (- *
- Arrays : (Object item, Number index, Array allItems) - *
- *- * When iterating an array, the supplied function is called with each item.- Objects : (String key, Object value, Object) - *
- *- * When iterating an object, the supplied function is called with each key-value pair in - * the object, and the iterated objectthis
reference) in which the specified function is executed. Defaults to - * theobject
being iterated. - */ - 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; - }; + if (type === 'object') { + if (value.nodeType !== undefined) { + if (value.nodeType === 3) { + return (/\S/).test(value.nodeValue) ? 'textnode' : 'whitespace'; } - } - } - }, - - /** - * 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: - *- * Note: 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 - */ - 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; - } + else { + return 'element'; } - return e; - } else { - return el; } + + return 'object'; } + + //<debug error> + Ext.Error.raise({ + sourceClass: 'Ext', + sourceMethod: 'typeOf', + msg: 'Failed to determine the type of the specified value "' + value + '". This is most likely a bug.' + }); + //</debug> }, - /** - * Returns the current document body as an {@link Ext.Element}. - * @return Ext.Element The document body + /** + * Returns true if the passed value is empty, false otherwise. The value is deemed to be empty if it is either: + * + * - `null` + * - `undefined` + * - a zero-length array + * - a zero-length string (Unless the `allowEmptyString` parameter is set to `true`) + * + * @param {Object} value The value to test + * @param {Boolean} allowEmptyString (optional) true to allow empty strings (defaults to false) + * @return {Boolean} + * @markdown */ - getBody : function(){ - return Ext.get(DOC.body || DOC.documentElement); + isEmpty: function(value, allowEmptyString) { + return (value === null) || (value === undefined) || (!allowEmptyString ? value === '' : false) || (Ext.isArray(value) && value.length === 0); }, - - /** - * 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; - }; - }(), - /** - * Removes a DOM node from the document. - */ - /** - *-// 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 -} - *
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 - *
- * @param {HTMLElement} node The node to remove + /** + * Returns true if the passed value is a JavaScript Array, false otherwise. + * + * @param {Object} target The target to test + * @return {Boolean} + * @method */ - 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]; - } + isArray: ('isArray' in Array) ? Array.isArray : function(value) { + return toString.call(value) === '[object Array]'; }, - /** - *true
, then DOM event listeners are also removed from all child nodes. The body node - * will be ignored if passed in.Returns true if the passed value is empty.
- *The value is deemed to be empty if it is
- * @param {Mixed} value The value to test - * @param {Boolean} allowBlank (optional) true to allow empty strings (defaults to false) + /** + * Returns true if the passed value is a JavaScript Date object, false otherwise. + * @param {Object} object The object to test * @return {Boolean} */ - isEmpty : function(v, allowBlank){ - return v === null || v === undefined || ((Ext.isArray(v) && !v.length)) || (!allowBlank ? v === '' : false); + isDate: function(value) { + return toString.call(value) === '[object Date]'; }, - /** - * Returns true if the passed value is a JavaScript array, otherwise false. - * @param {Mixed} value The value to test + /** + * Returns true if the passed value is a JavaScript Object, false otherwise. + * @param {Object} value The value to test * @return {Boolean} - */ - isArray : function(v){ - return toString.apply(v) === '[object Array]'; + * @method + */ + isObject: (toString.call(null) === '[object Object]') ? + function(value) { + // check ownerDocument here as well to exclude DOM nodes + return value !== null && value !== undefined && toString.call(value) === '[object Object]' && value.ownerDocument === undefined; + } : + function(value) { + return toString.call(value) === '[object Object]'; }, - /** - * Returns true if the passed object is a JavaScript date object, otherwise false. - * @param {Object} object The object to test + /** + * Returns true if the passed value is a JavaScript 'primitive', a string, number or boolean. + * @param {Object} value The value to test * @return {Boolean} */ - isDate : function(v){ - return toString.apply(v) === '[object Date]'; + isPrimitive: function(value) { + var type = typeof value; + + return type === 'string' || type === 'number' || type === 'boolean'; }, - /** - * Returns true if the passed value is a JavaScript Object, otherwise false. - * @param {Mixed} value The value to test + /** + * Returns true if the passed value is a JavaScript Function, false otherwise. + * @param {Object} value The value to test * @return {Boolean} - */ - isObject : function(v){ - return !!v && Object.prototype.toString.call(v) === '[object Object]'; + * @method + */ + isFunction: + // Safari 3.x and 4.x returns 'function' for typeof <NodeList>, hence we need to fall back to using + // Object.prorotype.toString (slower) + (typeof document !== 'undefined' && typeof document.getElementsByTagName('body') === 'function') ? function(value) { + return toString.call(value) === '[object Function]'; + } : function(value) { + return typeof value === 'function'; }, - /** - * Returns true if the passed value is a JavaScript 'primitive', a string, number or boolean. - * @param {Mixed} value The value to test + /** + * Returns true if the passed value is a number. Returns false for non-finite numbers. + * @param {Object} value The value to test * @return {Boolean} */ - isPrimitive : function(v){ - return Ext.isString(v) || Ext.isNumber(v) || Ext.isBoolean(v); + isNumber: function(value) { + return typeof value === 'number' && isFinite(value); }, - /** - * Returns true if the passed value is a JavaScript Function, otherwise false. - * @param {Mixed} value The value to test - * @return {Boolean} + /** + * Validates that a value is numeric. + * @param {Object} value Examples: 1, '1', '2.34' + * @return {Boolean} True if numeric, false otherwise */ - isFunction : function(v){ - return toString.apply(v) === '[object Function]'; + isNumeric: function(value) { + return !isNaN(parseFloat(value)) && isFinite(value); }, - /** - * Returns true if the passed value is a number. Returns false for non-finite numbers. - * @param {Mixed} value The value to test + /** + * Returns true if the passed value is a string. + * @param {Object} value The value to test * @return {Boolean} */ - isNumber : function(v){ - return typeof v === 'number' && isFinite(v); + isString: function(value) { + return typeof value === 'string'; }, - /** - * Returns true if the passed value is a string. - * @param {Mixed} value The value to test + /** + * Returns true if the passed value is a boolean. + * + * @param {Object} value The value to test * @return {Boolean} */ - isString : function(v){ - return typeof v === 'string'; + isBoolean: function(value) { + return typeof value === 'boolean'; }, - /** - * Returns true if the passed value is a boolean. - * @param {Mixed} value The value to test + /** + * Returns true if the passed value is an HTMLElement + * @param {Object} value The value to test * @return {Boolean} */ - isBoolean : function(v){ - return typeof v === 'boolean'; + isElement: function(value) { + return value ? value.nodeType === 1 : false; }, - /** - * Returns true if the passed value is an HTMLElement - * @param {Mixed} value The value to test + /** + * Returns true if the passed value is a TextNode + * @param {Object} value The value to test * @return {Boolean} */ - isElement : function(v) { - return v ? !!v.tagName : false; + isTextNode: function(value) { + return value ? value.nodeName === "#text" : false; }, - /** - * Returns true if the passed value is not undefined. - * @param {Mixed} value The value to test + /** + * Returns true if the passed value is defined. + * @param {Object} value The value to test * @return {Boolean} */ - isDefined : function(v){ - return typeof v !== 'undefined'; + isDefined: function(value) { + return typeof value !== 'undefined'; }, - /** - * 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 + /** + * Returns true if the passed value is iterable, false otherwise + * @param {Object} value The value to test + * @return {Boolean} */ - isAir : isAir + isIterable: function(value) { + return (value && typeof value !== 'string') ? value.length !== undefined : false; + } }); - /** - * 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: - *- *
- null
- *- undefined
- *- an empty array
- *- a zero length string (Unless the allowBlank parameter is true)
- *- * @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.apply(Ext, { -Ext.ns('Ext.util', 'Ext.lib', 'Ext.data', 'Ext.supports'); + /** + * Clone almost any type of variable including array, object, DOM nodes and Date without keeping the old reference + * @param {Object} item The variable to clone + * @return {Object} clone + */ + clone: function(item) { + if (item === null || item === undefined) { + return item; + } -Ext.elCache = {}; + // DOM nodes + // TODO proxy this to Ext.Element.clone to handle automatic id attribute changing + // recursively + if (item.nodeType && item.cloneNode) { + return item.cloneNode(true); + } -/** - * @class Function - * These functions are available on every Function object (any JavaScript function). - */ -Ext.apply(Function.prototype, { - /** - * 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: - *-Ext.namespace('Company', 'Company.data'); -Ext.namespace('Company.data'); // equivalent and preferable to above syntax -Company.Widget = function() { ... } -Company.data.CustomStore = function(config) { ... } -
- * @param {Function} fcn The function to call before the original - * @param {Object} scope (optional) The scope (-var sayHi = function(name){ - alert('Hi, ' + name); -} - -sayHi('Fred'); // alerts "Hi, Fred" - -// create a new function that validates input without -// directly modifying the original function: -var sayHiToFriend = sayHi.createInterceptor(function(name){ - return name == 'Brian'; -}); - -sayHiToFriend('Fred'); // no alert -sayHiToFriend('Brian'); // alerts "Hi, Brian" -
this
reference) in which the passed function is executed. - * If omitted, defaults to the scope in which the original function is called or the browser window. - * @return {Function} The new function - */ - createInterceptor : function(fcn, scope){ - var method = this; - return !Ext.isFunction(fcn) ? - this : - 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:myFunction.createCallback(arg1, arg2)
- * Will create a function that is bound to those 2 args. If a specific scope is required in the - * callback, use {@link #createDelegate} instead. The function returned by createCallback always - * executes in the window scope. - *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: - *
- * @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); - }; - }, - - /** - * Creates a delegate (callback) that sets the scope to obj. - * Call directly on any function. Example:-var sayHi = function(name){ - alert('Hi, ' + name); -} - -// clicking the button alerts "Hi, Fred" -new Ext.Button({ - text: 'Say Hi', - renderTo: Ext.getBody(), - handler: sayHi.createCallback('Fred') -}); -
this.myFunction.createDelegate(this, [arg1, arg2])
- * Will create a function that is automatically scoped to obj so that the this variable inside the - * callback points to obj. Example usage: - *- * @param {Object} scope (optional) The scope (-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'])); -
this
reference) in which the function is executed. - * If omitted, defaults to the browser window. - * @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 - */ - 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 + var type = toString.call(item); + + // Date + if (type === '[object Date]') { + return new Date(item.getTime()); } - return method.apply(obj || window, callArgs); - }; - }, - - /** - * Calls this function after the number of millseconds specified, optionally in a specific scope. Example usage: - *- * @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 (-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); -
this
reference) in which the function is executed. - * If omitted, defaults to the browser window. - * @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 - */ - defer : function(millis, obj, args, appendArgs){ - var fn = this.createDelegate(obj, args, appendArgs); - if(millis > 0){ - return setTimeout(fn, millis); - } - fn(); - return 0; - } -}); -/** - * @class String - * These functions are available on every String object. - */ -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: - *- * @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]; - }); - } -}); + var i, j, k, clone, key; -/** - * @class Array - */ -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; + // Array + if (type === '[object Array]') { + i = item.length; + + clone = []; + + while (i--) { + clone[i] = Ext.clone(item[i]); + } } + // Object + else if (type === '[object Object]' && item.constructor === Object) { + clone = {}; + + for (key in item) { + clone[key] = Ext.clone(item[key]); + } + + if (enumerables) { + for (j = enumerables.length; j--;) { + k = enumerables[j]; + clone[k] = item[k]; + } + } + } + + return clone || item; + }, + + /** + * @private + * Generate a unique reference of Ext in the global scope, useful for sandboxing + */ + getUniqueGlobalNamespace: function() { + var uniqueGlobalNamespace = this.uniqueGlobalNamespace; + + if (uniqueGlobalNamespace === undefined) { + var i = 0; + + do { + uniqueGlobalNamespace = 'ExtBox' + (++i); + } while (Ext.global[uniqueGlobalNamespace] !== undefined); + + Ext.global[uniqueGlobalNamespace] = Ext; + this.uniqueGlobalNamespace = uniqueGlobalNamespace; + } + + return uniqueGlobalNamespace; + }, + + /** + * @private + */ + functionFactory: function() { + var args = Array.prototype.slice.call(arguments); + + if (args.length > 0) { + args[args.length - 1] = 'var Ext=window.' + this.getUniqueGlobalNamespace() + ';' + + args[args.length - 1]; + } + + return Function.prototype.constructor.apply(Function.prototype, args); } - return -1; - }, + }); - /** - * 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 + /** + * Old alias to {@link Ext#typeOf} + * @deprecated 4.0.0 Use {@link Ext#typeOf} instead + * @method + * @alias Ext#typeOf */ - remove : function(o){ - var index = this.indexOf(o); - if(index != -1){ - this.splice(index, 1); - } - return this; - } -}); --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>' - *