X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/6a7e4474cba9d8be4b2ec445e10f1691f7277c50..refs/tags/3.2.1:/adapter/ext/ext-base-debug.js diff --git a/adapter/ext/ext-base-debug.js b/adapter/ext/ext-base-debug.js index 82c8e022..1f9d9179 100644 --- a/adapter/ext/ext-base-debug.js +++ b/adapter/ext/ext-base-debug.js @@ -1,37 +1,22 @@ -/*! - * Ext JS Library 3.2.0 - * Copyright(c) 2006-2010 Ext JS, Inc. - * licensing@extjs.com - * http://www.extjs.com/license - */ - -// for old browsers + + window.undefined = window.undefined; -/** - * @class Ext - * Ext core utilities and functions. - * @singleton - */ + Ext = { - /** - * The version of the framework - * @type String - */ - version : '3.2.0' + + version : '3.2.1', + versionDetail : { + major: 3, + minor: 2, + patch: 1 + } }; -/** - * 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); } @@ -56,7 +41,7 @@ Ext.apply = function(o, c, defaults){ isChrome = check(/\bchrome\b/), isWebKit = check(/webkit/), isSafari = !isChrome && check(/safari/), - isSafari2 = isSafari && check(/applewebkit\/4/), // unique to Safari 2 + isSafari2 = isSafari && check(/applewebkit\/4/), isSafari3 = isSafari && check(/version\/3/), isSafari4 = isSafari && check(/version\/4/), isIE = !isOpera && check(/msie/), @@ -73,7 +58,7 @@ Ext.apply = function(o, c, defaults){ isLinux = check(/linux/), isSecure = /^https/i.test(window.location.protocol); - // remove css image flicker + if(isIE6){ try{ DOC.execCommand("BackgroundImageCache", false, true); @@ -81,68 +66,30 @@ Ext.apply = function(o, c, defaults){ } 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, - /** - * True if the {@link Ext.Fx} Class is available - * @type Boolean - * @property enableFx - */ + - /** - * True to automatically uncache orphaned Ext.Elements periodically (defaults to true) - * @type Boolean - */ + enableGarbageCollector : true, - /** - * True to automatically purge event listeners during garbageCollection (defaults to false). - * @type Boolean - */ + enableListenerCollection : false, - /** - * 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 - */ + 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 - */ + applyIf : function(o, c){ if(o){ for(var p in c){ @@ -154,12 +101,7 @@ Ext.apply = function(o, c, defaults){ 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) { @@ -168,57 +110,9 @@ Ext.apply = function(o, c, defaults){ return el.id; }, - /** - *

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({...});
-
-//      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
-    },
-
-    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

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 the overrides parameter, or a generated one if not provided. - */ + extend : function(){ - // inline overrides + var io = function(o){ for(var m in o){ this[m] = o[m]; @@ -227,7 +121,7 @@ MyGridPanel = Ext.extend(Ext.grid.GridPanel, { var oc = Object.prototype.constructor; return function(sb, sp, overrides){ - if(Ext.isObject(sp)){ + if(typeof sp == 'object'){ overrides = sp; sp = sb; sb = overrides.constructor != oc ? overrides.constructor : function(){sp.apply(this, arguments);}; @@ -256,23 +150,7 @@ MyGridPanel = Ext.extend(Ext.grid.GridPanel, { }; }(), - /** - * Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name. - * Usage:

-Ext.override(MyClass, {
-    newMethod1: function(){
-        // etc.
-    },
-    newMethod2: function(foo){
-        // etc.
-    }
-});
-
- * @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; @@ -283,21 +161,7 @@ Ext.override(MyClass, { } }, - /** - * 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.namespace('Company', 'Company.data');
-Ext.namespace('Company.data'); // equivalent and preferable to above syntax
-Company.Widget = function() { ... }
-Company.data.CustomStore = function(config) { ... }
-
- * @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) { @@ -310,12 +174,7 @@ Company.data.CustomStore = function(config) { ... } return o; }, - /** - * 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 = [], @@ -334,15 +193,7 @@ Company.data.CustomStore = function(config) { ... } return pre + buf.join(''); }, - /** - * Takes an encoded URL and and converts it to an object. Example:

-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"]}
-
- * @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 {}; @@ -362,13 +213,7 @@ Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2" return obj; }, - /** - * 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; @@ -376,13 +221,7 @@ Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2" 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){ @@ -398,42 +237,20 @@ Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2" }(), 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)); }, - /** - * 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 index. This function is called with - * the following arguments: - *
- * @param {Object} scope The scope (this reference) in which the specified function is executed. - * Defaults to the item at the current index - * within the passed array. - * @return See description for the fn parameter. - */ + each : function(array, fn, scope){ if(Ext.isEmpty(array, true)){ return; @@ -448,26 +265,7 @@ Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2" } }, - /** - * 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 (this reference) in which the specified function is executed. Defaults to - * the object being iterated. - */ + iterate : function(obj, fn, scope){ if(Ext.isEmpty(obj)){ return; @@ -475,7 +273,7 @@ Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2" if(Ext.isIterable(obj)){ Ext.each(obj, fn, scope); return; - }else if(Ext.isObject(obj)){ + }else if(typeof obj == 'object'){ for(var prop in obj){ if(obj.hasOwnProperty(prop)){ if(fn.call(scope || obj, prop, obj[prop], obj) === false){ @@ -486,29 +284,7 @@ Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2" } }, - /** - * 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: - *

-// 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
-}
-         * 
- * 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; @@ -516,10 +292,10 @@ function(el){ if (el.dom){ return el.dom; } else { - if (Ext.isString(el)) { + 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; @@ -534,24 +310,13 @@ function(el){ } }, - /** - * Returns the current document body as an {@link Ext.Element}. - * @return Ext.Element The document body - */ + getBody : function(){ return Ext.get(DOC.body || DOC.documentElement); }, - /** - * Removes a DOM node from the document. - */ - /** - *

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 - * true, then DOM event listeners are also removed from all child nodes. The body node - * will be ignored if passed in.

- * @param {HTMLElement} node The node to remove - */ + + removeNode : isIE && !isIE8 ? function(){ var d; return function(n){ @@ -571,224 +336,102 @@ function(el){ } }, - /** - *

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) - * @return {Boolean} - */ + isEmpty : function(v, allowBlank){ return v === null || v === undefined || ((Ext.isArray(v) && !v.length)) || (!allowBlank ? v === '' : false); }, - /** - * Returns true if the passed value is a JavaScript array, otherwise false. - * @param {Mixed} value The value to test - * @return {Boolean} - */ + isArray : function(v){ return toString.apply(v) === '[object Array]'; }, - /** - * Returns true if the passed object is a JavaScript date object, otherwise false. - * @param {Object} object The object to test - * @return {Boolean} - */ + isDate : function(v){ return toString.apply(v) === '[object Date]'; }, - /** - * Returns true if the passed value is a JavaScript Object, otherwise false. - * @param {Mixed} value The value to test - * @return {Boolean} - */ + isObject : function(v){ return !!v && Object.prototype.toString.call(v) === '[object Object]'; }, - /** - * Returns true if the passed value is a JavaScript 'primitive', a string, number or boolean. - * @param {Mixed} value The value to test - * @return {Boolean} - */ + isPrimitive : function(v){ return Ext.isString(v) || Ext.isNumber(v) || Ext.isBoolean(v); }, - /** - * Returns true if the passed value is a JavaScript Function, otherwise false. - * @param {Mixed} value The value to test - * @return {Boolean} - */ + isFunction : function(v){ return toString.apply(v) === '[object Function]'; }, - /** - * 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); }, - /** - * 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} - */ + isBoolean : function(v){ return typeof v === 'boolean'; }, - /** - * Returns true if the passed value is an HTMLElement - * @param {Mixed} value The value to test - * @return {Boolean} - */ + isElement : function(v) { return v ? !!v.tagName : false; }, - /** - * 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'; }, - /** - * 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: - *

-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} 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; })(); @@ -796,36 +439,9 @@ Ext.ns("Ext.util", "Ext.lib", "Ext.data"); Ext.elCache = {}; -/** - * @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: - *

-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"
-
- * @param {Function} fcn The function to call before the original - * @param {Object} scope (optional) The scope (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 - */ +Ext.apply(Function.prototype, { + createInterceptor : function(fcn, scope){ var method = this; return !Ext.isFunction(fcn) ? @@ -841,32 +457,9 @@ sayHiToFriend('Brian'); // alerts "Hi, Brian" }; }, - /** - * 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: - *


-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')
-});
-
- * @return {Function} The new function - */ - createCallback : function(/*args...*/){ - // make args available, in function below + + createCallback : function(){ + var args = arguments, method = this; return function() { @@ -874,37 +467,7 @@ new Ext.Button({ }; }, - /** - * Creates a delegate (callback) that sets the scope to obj. - * Call directly on any function. Example: 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: - *

-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']));
-
- * @param {Object} scope (optional) The scope (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() { @@ -913,41 +476,15 @@ btn.on('click', sayHi.createDelegate(btn, ['Fred'])); 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 + callArgs = Array.prototype.slice.call(arguments, 0); + var applyArgs = [appendArgs, 0].concat(args); + Array.prototype.splice.apply(callArgs, applyArgs); } return method.apply(obj || window, callArgs); }; }, - /** - * Calls this function after the number of millseconds specified, optionally in a specific scope. Example usage: - *

-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);
-
- * @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 (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){ @@ -958,25 +495,9 @@ sayHi.defer(2000, this, ['Fred']); } }); -/** - * @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: - *

-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>'
-     * 
- * @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){ @@ -985,16 +506,9 @@ var s = String.format('<div class="{0}">{1}</div>', cls, text); } }); -/** - * @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; @@ -1007,11 +521,7 @@ Ext.applyIf(Array.prototype, { 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 - */ + remove : function(o){ var index = this.indexOf(o); if(index != -1){ @@ -1020,86 +530,47 @@ Ext.applyIf(Array.prototype, { return this; } }); -/** - * @class Ext - */ + Ext.ns("Ext.grid", "Ext.list", "Ext.dd", "Ext.tree", "Ext.form", "Ext.menu", "Ext.state", "Ext.layout", "Ext.app", "Ext.ux", "Ext.chart", "Ext.direct"); - /** - * Namespace alloted for extensions to the framework. - * @property ux - * @type Object - */ + Ext.apply(Ext, function(){ - var E = Ext, + var E = Ext, idSeed = 0, scrollWidth = null; return { - /** - * A reusable empty function - * @property - * @type Function - */ + emptyFn : function(){}, - /** - * 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. - * @type String - */ + BLANK_IMAGE_URL : Ext.isIE6 || Ext.isIE7 || Ext.isAir ? - 'http:/' + '/extjs.com/s.gif' : + 'http:/' + '/www.extjs.com/s.gif' : 'data:image/gif;base64,R0lGODlhAQABAID/AMDAwAAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==', extendX : function(supr, fn){ return Ext.extend(supr, fn(supr.prototype)); }, - /** - * Returns the current HTML document object as an {@link Ext.Element}. - * @return Ext.Element The document - */ + getDoc : function(){ return Ext.get(document); }, - /** - * 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 - */ + num : function(v, defaultValue){ - v = Number(Ext.isEmpty(v) || Ext.isArray(v) || Ext.isBoolean(v) || (Ext.isString(v) && v.trim().length == 0) ? NaN : v); + v = Number(Ext.isEmpty(v) || Ext.isArray(v) || typeof v == 'boolean' || (typeof v == 'string' && v.trim().length == 0) ? NaN : v); return isNaN(v) ? defaultValue : v; }, - /** - *

Utility method for returning a default value if the passed value is empty.

- *

The value is deemed to be empty if it is

- * @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 - */ + value : function(v, defaultValue, allowBlank){ return Ext.isEmpty(v, allowBlank) ? defaultValue : v; }, - /** - * Escapes the passed string for use in a regular expression - * @param {String} str - * @return {String} - */ + escapeRe : function(s) { return s.replace(/([-.*+?^${}()|[\]\/\\])/g, "\\$1"); }, @@ -1108,36 +579,19 @@ Ext.apply(Ext, function(){ o[name] = o[name].createSequence(fn, scope); }, - /** - * Applies event listeners to elements by selectors when the document is ready. - * The event name is specified with an @ suffix. - *

-Ext.addBehaviors({
-    // add a listener for click on all anchors in element with id foo
-    '#foo a@click' : function(e, t){
-        // do something
-    },
-    
-    // add the same listener to multiple selectors (separated by comma BEFORE the @)
-    '#foo a, #bar span.some-class@mouseover' : function(){
-        // do something
-    }
-});
-         * 
- * @param {Object} obj The list of behaviors to apply - */ + addBehaviors : function(o){ if(!Ext.isReady){ Ext.onReady(function(){ Ext.addBehaviors(o); }); } else { - var cache = {}, // simple cache for applying multiple behaviors to same selector does query multiple times + var cache = {}, parts, b, s; for (b in o) { - if ((parts = b.split('@'))[1]) { // for Object prototype breakers + if ((parts = b.split('@'))[1]) { s = parts[0]; if(!cache[s]){ cache[s] = Ext.select(s); @@ -1148,34 +602,29 @@ Ext.addBehaviors({ cache = null; } }, + - /** - * Utility method for getting the width of the browser scrollbar. This can differ depending on - * operating system settings, such as the theme or font size. - * @param {Boolean} force (optional) true to force a recalculation of the value. - * @return {Number} The width of the scrollbar. - */ getScrollBarWidth: function(force){ if(!Ext.isReady){ return 0; } - + if(force === true || scrollWidth === null){ - // Append our div, do our calculation and then remove it + var div = Ext.getBody().createChild('
'), child = div.child('div', true); var w1 = child.offsetWidth; div.setStyle('overflow', (Ext.isWebKit || Ext.isGecko) ? 'auto' : 'scroll'); var w2 = child.offsetWidth; div.remove(); - // Need to add 2 to ensure we leave enough space + scrollWidth = w1 - w2 + 2; } return scrollWidth; }, - // deprecated + combine : function(){ var as = arguments, l = as.length, r = []; for(var i = 0; i < l; i++){ @@ -1191,25 +640,9 @@ Ext.addBehaviors({ return r; }, - /** - * Copies a set of named properties fom the source object to the destination object. - *

example:


-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');
-    }
-});
-         * 
- * @param {Object} dest The destination object. - * @param {Object} source The source object. - * @param {Array/String} names 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(Ext.isString(names)){ + if(typeof names == 'string'){ names = names.split(/[,;\s]/); } Ext.each(names, function(name){ @@ -1220,36 +653,22 @@ ImageComponent = Ext.extend(Ext.BoxComponent, { return dest; }, - /** - * 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) - */ + destroy : function(){ Ext.each(arguments, function(arg){ if(arg){ if(Ext.isArray(arg)){ this.destroy.apply(this, arg); - }else if(Ext.isFunction(arg.destroy)){ + }else if(typeof arg.destroy == 'function'){ arg.destroy(); }else if(arg.dom){ arg.remove(); - } + } } }, this); }, - /** - * 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. - */ + destroyMembers : function(o, arg1, arg2, etc){ for(var i = 1, a = arguments, len = a.length; i < len; i++) { Ext.destroy(o[a[i]]); @@ -1257,11 +676,7 @@ ImageComponent = Ext.extend(Ext.BoxComponent, { } }, - /** - * 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. - */ + clean : function(arr){ var ret = []; Ext.each(arr, function(v){ @@ -1272,11 +687,7 @@ ImageComponent = Ext.extend(Ext.BoxComponent, { return ret; }, - /** - * 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. - */ + unique : function(arr){ var ret = [], collect = {}; @@ -1290,11 +701,7 @@ ImageComponent = Ext.extend(Ext.BoxComponent, { return ret; }, - /** - * Recursively flattens into 1-d Array. Injects Arrays inline. - * @param {Array} arr The array to flatten - * @return {Array} The new, flattened array. - */ + flatten : function(arr){ var worker = []; function rFlatten(a) { @@ -1310,13 +717,7 @@ ImageComponent = Ext.extend(Ext.BoxComponent, { 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. - */ + min : function(arr, comp){ var ret = arr[0]; comp = comp || function(a,b){ return a < b ? -1 : 1; }; @@ -1326,13 +727,7 @@ ImageComponent = Ext.extend(Ext.BoxComponent, { return ret; }, - /** - * 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. - */ + max : function(arr, comp){ var ret = arr[0]; comp = comp || function(a,b){ return a > b ? 1 : -1; }; @@ -1342,20 +737,12 @@ ImageComponent = Ext.extend(Ext.BoxComponent, { return ret; }, - /** - * Calculates the mean of the Array - * @param {Array} arr The Array to calculate the mean value of. - * @return {Number} The mean. - */ + mean : function(arr){ return arr.length > 0 ? Ext.sum(arr) / arr.length : undefined; }, - /** - * Calculates the sum of the Array - * @param {Array} arr The Array to calculate the sum value of. - * @return {Number} The sum. - */ + sum : function(arr){ var ret = 0; Ext.each(arr, function(v) { @@ -1364,29 +751,7 @@ ImageComponent = Ext.extend(Ext.BoxComponent, { return ret; }, - /** - * Partitions the set into two sets: a true set and a false set. - * Example: - * Example2: - *

-// 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.
-         * 
- * @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,false] - */ + partition : function(arr, truth){ var ret = [[],[]]; Ext.each(arr, function(v, i, a) { @@ -1395,23 +760,12 @@ Ext.partition( return ret; }, - /** - * Invokes a method on each item in an Array. - *

-// Example:
-Ext.invoke(Ext.query("p"), "getAttribute", "id");
-// [el1.getAttribute("id"), el2.getAttribute("id"), ..., elN.getAttribute("id")]
-         * 
- * @param {Array|NodeList} arr The Array of items to invoke the method on. - * @param {String} methodName The method name to invoke. - * @param {...*} args Arguments to send into the method invocation. - * @return {Array} The results of invoking the method on each item in the array. - */ + invoke : function(arr, methodName){ var ret = [], args = Array.prototype.slice.call(arguments, 2); Ext.each(arr, function(v,i) { - if (v && Ext.isFunction(v[methodName])) { + if (v && typeof v[methodName] == 'function') { ret.push(v[methodName].apply(v, args)); } else { ret.push(undefined); @@ -1420,16 +774,7 @@ Ext.invoke(Ext.query("p"), "getAttribute", "id"); return ret; }, - /** - * Plucks the value of a property from each item in the Array - *

-// Example:
-Ext.pluck(Ext.query("p"), "className"); // [el1.className, el2.className, ..., elN.className]
-         * 
- * @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. - */ + pluck : function(arr, prop){ var ret = []; Ext.each(arr, function(v) { @@ -1438,27 +783,9 @@ Ext.pluck(Ext.query("p"), "className"); // [el1.className, el2.className, ..., e return ret; }, - /** - *

Zips N sets together.

- *

-// 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"]
-         * 
- * @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. - */ + zip : function(){ - var parts = Ext.partition(arguments, function( val ){ return !Ext.isFunction(val); }), + var parts = Ext.partition(arguments, function( val ){ return typeof val != 'function'; }), arrs = parts[0], fn = parts[1][0], len = Ext.max(Ext.pluck(arrs, "length")), @@ -1477,44 +804,16 @@ Ext.zip( return ret; }, - /** - * 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, undefined if not found, or null if a - * Class was found. - */ + getCmp : function(id){ return Ext.ComponentMgr.get(id); }, - /** - * 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 - */ + useShims: E.isIE6 || (E.isMac && E.isGecko2), - // 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:
    - *
  • string: If the object passed is a string
  • - *
  • number: If the object passed is a number
  • - *
  • boolean: If the object passed is a boolean value
  • - *
  • date: If the object passed is a Date object
  • - *
  • function: If the object passed is a function reference
  • - *
  • object: If the object passed is an object
  • - *
  • array: If the object passed is an array
  • - *
  • regexp: If the object passed is a regular expression
  • - *
  • element: If the object passed is a DOM Element
  • - *
  • nodelist: If the object passed is a DOM NodeList
  • - *
  • textnode: If the object passed is a DOM text node and contains something other than whitespace
  • - *
  • whitespace: If the object passed is a DOM text node and contains only whitespace
  • - *
- * @param {Mixed} object - * @return {String} - */ + + type : function(o){ if(o === undefined || o === null){ return false; @@ -1535,7 +834,7 @@ Ext.zip( case RegExp: return 'regexp'; case Date: return 'date'; } - if(Ext.isNumber(o.length) && Ext.isFunction(o.item)) { + if(typeof o.length == 'number' && typeof o.item == 'function') { return 'nodelist'; } } @@ -1546,9 +845,9 @@ Ext.zip( o[name] = o[name].createInterceptor(fn, scope); }, - // internal + callback : function(cb, scope, args, delay){ - if(Ext.isFunction(cb)){ + if(typeof cb == 'function'){ if(delay){ cb.defer(delay, scope, args || []); }else{ @@ -1559,36 +858,12 @@ Ext.zip( }; }()); -/** - * @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: - *

-var sayHi = function(name){
-    alert('Hi, ' + name);
-}
-
-sayHi('Fred'); // alerts "Hi, Fred"
-
-var sayGoodbye = sayHi.createSequence(function(name){
-    alert('Bye, ' + name);
-});
 
-sayGoodbye('Fred'); // both alerts show
-
- * @param {Function} fcn The function to sequence - * @param {Object} scope (optional) The scope (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 - */ +Ext.apply(Function.prototype, { + createSequence : function(fcn, scope){ var method = this; - return !Ext.isFunction(fcn) ? + return (typeof fcn != 'function') ? this : function(){ var retval = method.apply(this || window, arguments); @@ -1599,35 +874,15 @@ sayGoodbye('Fred'); // both alerts show }); -/** - * @class String - * These functions are available as static methods on the JavaScript String object. - */ + Ext.applyIf(String, { - /** - * Escapes the passed string for ' and \ - * @param {String} string The string to escape - * @return {String} The escaped string - * @static - */ + escape : function(string) { return string.replace(/('|\\)/g, "\\$1"); }, - /** - * Pads the left side of a string with a specified character. This is especially useful - * for normalizing number and date strings. Example usage: - *

-var s = String.leftPad('123', 5, '0');
-// s now contains the string: '00123'
-     * 
- * @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 - */ + leftPad : function (val, size, ch) { var result = String(val); if(!ch) { @@ -1640,101 +895,32 @@ var s = String.leftPad('123', 5, '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. - *

-// alternate sort directions
-sort = sort.toggle('ASC', 'DESC');
-
-// instead of conditional logic:
-sort = (sort == 'ASC' ? 'DESC' : 'ASC');
-
- * @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: - *

-var s = '  foo bar  ';
-alert('-' + s + '-');         //alerts "- foo bar -"
-alert('-' + s.trim() + '-');  //alerts "-foo bar-"
-
- * @return {String} The trimmed string - */ + String.prototype.trim = function(){ var re = /^\s+|\s+$/g; return function(){ return this.replace(re, ""); }; }(); -// 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 - */ + + Date.prototype.getElapsed = function(date) { return Math.abs((date || new Date()).getTime()-this.getTime()); }; -/** - * @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 - */ + constrain : function(min, max){ return Math.min(Math.max(this, min), max); } }); -/** - * @class Ext.util.TaskRunner - * Provides the ability to execute one or more arbitrary tasks in a multithreaded - * manner. Generally, you can use the singleton {@link Ext.TaskMgr} instead, but - * if needed, you can create separate instances of TaskRunner. Any number of - * separate tasks can be started at any time and will run independently of each - * other. Example usage: - *

-// Start a simple clock task that updates a div once per second
-var updateClock = function(){
-    Ext.fly('clock').update(new Date().format('g:i:s A'));
-} 
-var task = {
-    run: updateClock,
-    interval: 1000 //1 second
-}
-var runner = new Ext.util.TaskRunner();
-runner.start(task);
-
-// equivalent using TaskMgr
-Ext.TaskMgr.start({
-    run: updateClock,
-    interval: 1000
-});
 
- * 
- *

See the {@link #start} method for details about how to configure a task object.

- * Also see {@link Ext.util.DelayedTask}. - * - * @constructor - * @param {Number} interval (optional) The minimum precision in milliseconds supported by this TaskRunner instance - * (defaults to 10) - */ Ext.util.TaskRunner = function(interval){ interval = interval || 10; var tasks = [], @@ -1742,14 +928,14 @@ Ext.util.TaskRunner = function(interval){ id = 0, running = false, - // private + stopThread = function(){ running = false; clearInterval(id); id = 0; }, - // private + startThread = function(){ if(!running){ running = true; @@ -1757,7 +943,7 @@ Ext.util.TaskRunner = function(interval){ } }, - // private + removeTask = function(t){ removeQueue.push(t); if(t.onStop){ @@ -1765,7 +951,7 @@ Ext.util.TaskRunner = function(interval){ } }, - // private + runTasks = function(){ var rqLen = removeQueue.length, now = new Date().getTime(); @@ -1797,30 +983,7 @@ Ext.util.TaskRunner = function(interval){ } }; - /** - * Starts a new task. - * @method start - * @param {Object} task

A config object that supports the following properties:

- *

Before each invocation, Ext injects the property taskRunCount into the task object so - * that calculations based on the repeat count can be performed.

- * @return {Object} The task - */ + this.start = function(task){ tasks.push(task); task.taskStartTime = new Date().getTime(); @@ -1830,21 +993,13 @@ Ext.util.TaskRunner = function(interval){ return task; }; - /** - * Stops an existing running task. - * @method stop - * @param {Object} task The task to stop - * @return {Object} The task - */ + this.stop = function(task){ removeTask(task); return task; }; - /** - * Stops all tasks that are currently running. - * @method stopAll - */ + this.stopAll = function(){ stopThread(); for(var i = 0, len = tasks.length; i < len; i++){ @@ -1857,24 +1012,7 @@ Ext.util.TaskRunner = function(interval){ }; }; -/** - * @class Ext.TaskMgr - * @extends Ext.util.TaskRunner - * A static {@link Ext.util.TaskRunner} instance that can be used to start and stop arbitrary tasks. See - * {@link Ext.util.TaskRunner} for supported methods and task config properties. - *

-// Start a simple clock task that updates a div once per second
-var task = {
-    run: function(){
-        Ext.fly('clock').update(new Date().format('g:i:s A'));
-    },
-    interval: 1000 //1 second
-}
-Ext.TaskMgr.start(task);
-
- *

See the {@link #start} method for details about how to configure a task object.

- * @singleton - */ + Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ var libFlyweight; @@ -2049,7 +1187,7 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ win = window, doc = document, - // constants + POLL_RETRYS = 200, POLL_INTERVAL = 20, EL = 0, @@ -2063,7 +1201,7 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ UNLOAD = 'unload', MOUSEOVER = 'mouseover', MOUSEOUT = 'mouseout', - // private + doAdd = function() { var ret; if (win.addEventListener) { @@ -2089,7 +1227,7 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ } return ret; }(), - // private + doRemove = function(){ var ret; if (win.removeEventListener) { @@ -2130,24 +1268,26 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ return false; } - // private + function _tryPreloadAttach() { var ret = false, notAvail = [], - element, i, len, v, + element, i, v, override, tryAgain = !loadComplete || (retryCount > 0); - if (!locked) { + if(!locked){ locked = true; - - for (i = 0, len = onAvailStack.length; i < len; i++) { + + for(i = 0; i < onAvailStack.length; ++i){ v = onAvailStack[i]; if(v && (element = doc.getElementById(v.id))){ if(!v.checkReady || loadComplete || element.nextSibling || (doc && doc.body)) { - element = v.override ? (v.override === true ? v.obj : v.override) : element; + override = v.override; + element = override ? (override === true ? v.obj : override) : element; v.fn.call(element, v.obj); onAvailStack.remove(v); - } else { + --i; + }else{ notAvail.push(v); } } @@ -2161,13 +1301,12 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ clearInterval(_interval); _interval = null; } - ret = !(locked = false); } return ret; } - // private + function startInterval() { if(!_interval){ var callback = function() { @@ -2177,7 +1316,7 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ } } - // private + function getScroll() { var dd = doc.documentElement, db = doc.body; @@ -2190,7 +1329,7 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ } } - // private + function getPageCoord (ev, xy) { ev = ev.browserEvent || ev; var coord = ev['page' + xy]; @@ -2219,7 +1358,7 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ startInterval(); }, - // This function should ALWAYS be called from Ext.EventManager + addListener: function(el, eventName, fn) { el = Ext.getDom(el); if (el && fn) { @@ -2235,7 +1374,7 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ return false; }, - // This function should ALWAYS be called from Ext.EventManager + removeListener: function(el, eventName, fn) { el = Ext.getDom(el); var i, len, li, lis; @@ -2263,7 +1402,7 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ if(!node){ return; } - // work around firefox bug, https://bugzilla.mozilla.org/show_bug.cgi?id=101197 + var s = HTMLElement.prototype.toString.call(node); if(s == '[xpconnect wrapped native prototype]' || s == '[object XULElement]'){ return; @@ -2336,13 +1475,13 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ return ev.charCode || ev.keyCode || 0; }, - //clearCache: function() {}, - // deprecated, call from EventManager + + getListeners : function(el, eventName) { Ext.EventManager.getListeners(el, eventName); }, - // deprecated, call from EventManager + purgeElement : function(el, recurse, eventName) { Ext.EventManager.purgeElement(el, recurse, eventName); }, @@ -2351,8 +1490,8 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ loadComplete = true; var EU = Ext.lib.Event; if (Ext.isIE && e !== true) { - // IE8 complains that _load is null or not an object - // so lets remove self via arguments.callee + + doRemove(win, "load", arguments.callee); } }, @@ -2381,7 +1520,7 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ } }; - // Initialize stuff. + pub.on = pub.addListener; pub.un = pub.removeListener; if (doc && doc.body) { @@ -2394,19 +1533,14 @@ Ext.TaskMgr = new Ext.util.TaskRunner();(function(){ return pub; }(); -/* -* Portions of this file are based on pieces of Yahoo User Interface Library -* Copyright (c) 2007, Yahoo! Inc. All rights reserved. -* YUI licensed under the BSD License: -* http://developer.yahoo.net/yui/license.txt -*/ + Ext.lib.Ajax = function() { var activeX = ['MSXML2.XMLHTTP.3.0', 'MSXML2.XMLHTTP', 'Microsoft.XMLHTTP'], CONTENTTYPE = 'Content-Type'; - // private + function setHeader(o) { var conn = o.conn, prop; @@ -2429,7 +1563,7 @@ Ext.lib.Ajax = function() { } } - // private + function createExceptionObject(tId, callbackArg, isAbort, isTimeout) { return { tId : tId, @@ -2441,19 +1575,19 @@ Ext.lib.Ajax = function() { }; } - // private + function initHeader(label, value) { (pub.headers = pub.headers || {})[label] = value; } - // private + function createResponseObject(o, callbackArg) { var headerObj = {}, headerStr, conn = o.conn, t, s, - // see: https://prototype.lighthouseapp.com/projects/8886/tickets/129-ie-mangles-http-response-status-code-204-to-1223 + isBrokenStatus = conn.status == 1223; try { @@ -2472,7 +1606,7 @@ Ext.lib.Ajax = function() { return { tId : o.tId, - // Normalize the status and statusText when IE returns 1223, see the above link. + status : isBrokenStatus ? 204 : conn.status, statusText : isBrokenStatus ? 'No Content' : conn.statusText, getResponseHeader : function(header){return headerObj[header.toLowerCase()];}, @@ -2483,7 +1617,7 @@ Ext.lib.Ajax = function() { }; } - // private + function releaseObject(o) { if (o.tId) { pub.conn[o.tId] = null; @@ -2492,7 +1626,7 @@ Ext.lib.Ajax = function() { o = null; } - // private + function handleTransactionResponse(o, callback, isAbort, isTimeout) { if (!callback) { releaseObject(o); @@ -2559,7 +1693,7 @@ Ext.lib.Ajax = function() { responseObject = null; } - // private + function handleReadyState(o, callback){ callback = callback || {}; var conn = o.conn, @@ -2591,7 +1725,7 @@ Ext.lib.Ajax = function() { pub.pollInterval); } - // private + function asyncRequest(method, uri, callback, postData) { var o = getConnectionObject() || null; @@ -2616,7 +1750,7 @@ Ext.lib.Ajax = function() { return o; } - // private + function getConnectionObject() { var o; @@ -2630,7 +1764,7 @@ Ext.lib.Ajax = function() { } } - // private + function createXhrObject(transactionId) { var http; @@ -2713,32 +1847,32 @@ Ext.lib.Ajax = function() { pollInterval : 50, transactionId : 0, -// This is never called - Is it worth exposing this? -// setProgId : function(id) { -// activeX.unshift(id); -// }, - -// This is never called - Is it worth exposing this? -// setDefaultPostHeader : function(b) { -// this.useDefaultHeader = b; -// }, - -// This is never called - Is it worth exposing this? -// setDefaultXhrHeader : function(b) { -// this.useDefaultXhrHeader = b; -// }, - -// This is never called - Is it worth exposing this? -// setPollingInterval : function(i) { -// if (typeof i == 'number' && isFinite(i)) { -// this.pollInterval = i; -// } -// }, - -// This is never called - Is it worth exposing this? -// resetDefaultHeaders : function() { -// this.defaultHeaders = null; -// }, + + + + + + + + + + + + + + + + + + + + + + + + + + abort : function(o, callback, isTimeout) { var me = this, @@ -2758,7 +1892,7 @@ Ext.lib.Ajax = function() { }, isCallInProgress : function(o) { - // if there is a connection and readyState is not 0 or 4 + return o.conn && !{0:true,4:true}[o.conn.readyState]; } }; @@ -3273,13 +2407,7 @@ Ext.lib.Ajax = function() { if(control.length > 0 && !Ext.isArray(control[0])){ control = [control]; }else{ - /* - var tmp = []; - for (i = 0,len = control.length; i < len; ++i) { - tmp[i] = control[i]; - } - control = tmp; - */ + } Ext.fly(el, '_anim').position(); @@ -3317,9 +2445,9 @@ Ext.lib.Ajax = function() { return [val[0] - pageXY[0] + start[0], val[1] - pageXY[1] + start[1]]; }; })(); -})();// Easing functions +})(); (function(){ - // shortcuts to aid compression + var abs = Math.abs, pi = Math.PI, asin = Math.asin, @@ -3450,7 +2578,7 @@ Ext.lib.Ajax = function() { (function() { var EXTLIB = Ext.lib; - // Color Animation + EXTLIB.Anim.color = function(el, args, duration, easing, cb, scope) { return EXTLIB.Anim.run(el, args, duration, easing, cb, scope, EXTLIB.ColorAnim); } @@ -3471,7 +2599,7 @@ Ext.lib.Ajax = function() { return typeof v !== 'undefined'; }; - // private + function parseColor(s) { var pi = parseInt, base, @@ -3560,7 +2688,7 @@ Ext.lib.Ajax = function() { (function() { - // Scroll Animation + var EXTLIB = Ext.lib; EXTLIB.Anim.scroll = function(el, args, duration, easing, cb, scope) { return EXTLIB.Anim.run(el, args, duration, easing, cb, scope, EXTLIB.Scroll); @@ -3629,4 +2757,4 @@ Ext.lib.Ajax = function() { } window.attachEvent("onunload", fnCleanUp); } -})(); \ No newline at end of file +})();