Ext.js
资源名称:ext-3.1.0.zip [点击查看]
上传用户:dawnssy
上传日期:2022-08-06
资源大小:9345k
文件大小:36k
源码类别:
JavaScript
开发平台:
JavaScript
- /*!
- * Ext JS Library 3.1.0
- * Copyright(c) 2006-2009 Ext JS, LLC
- * 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.1.0'
- };
- /**
- * Copies all the properties of config to obj.
- * @param {Object} obj The receiver of the properties
- * @param {Object} config The source of the properties
- * @param {Object} defaults A different object that will also be applied for default values
- * @return {Object} returns obj
- * @member Ext apply
- */
- Ext.apply = function(o, c, defaults){
- // no "this" reference for friendly out of scope calls
- if(defaults){
- Ext.apply(o, defaults);
- }
- if(o && c && typeof c == 'object'){
- for(var p in c){
- o[p] = c[p];
- }
- }
- return o;
- };
- (function(){
- var idSeed = 0,
- toString = Object.prototype.toString,
- ua = navigator.userAgent.toLowerCase(),
- check = function(r){
- return r.test(ua);
- },
- DOC = document,
- isStrict = DOC.compatMode == "CSS1Compat",
- isOpera = check(/opera/),
- isChrome = check(/chrome/),
- 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/),
- isIE8 = isIE && check(/msie 8/),
- 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 (<tt>'about:blank'</tt>, except for IE in secure mode, which is <tt>'javascript:""'</tt>).
- * @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.
- * <b>Note: Native JSON methods will not work with objects that have functions.
- * Also, property names must be quoted, otherwise the data will not parse.</b> (Defaults to false)
- * @type Boolean
- */
- USE_NATIVE_JSON : false,
- /**
- * Copies all the properties of config to obj if they don't already exist.
- * @param {Object} obj The receiver of the properties
- * @param {Object} config The source of the properties
- * @return {Object} returns obj
- */
- applyIf : function(o, c){
- if(o){
- for(var p in c){
- if(!Ext.isDefined(o[p])){
- o[p] = c[p];
- }
- }
- }
- 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){
- return (el = Ext.getDom(el) || {}).id = el.id || (prefix || "ext-gen") + (++idSeed);
- },
- /**
- * <p>Extends one class to create a subclass and optionally overrides members with the passed literal. This method
- * also adds the function "override()" to the subclass that can be used to override members of the class.</p>
- * For example, to create a subclass of Ext GridPanel:
- * <pre><code>
- 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.
- }
- });
- </code></pre>
- *
- * <p>This function also supports a 3-argument call in which the subclass's constructor is
- * passed as an argument. In this form, the parameters are as follows:</p>
- * <div class="mdetail-params"><ul>
- * <li><code>subclass</code> : Function <div class="sub-desc">The subclass constructor.</div></li>
- * <li><code>superclass</code> : Function <div class="sub-desc">The constructor of class being extended</div></li>
- * <li><code>overrides</code> : Object <div class="sub-desc">A literal with members which are copied into the subclass's
- * prototype, and are therefore shared among all instances of the new class.</div></li>
- * </ul></div>
- *
- * @param {Function} superclass The constructor of class being extended.
- * @param {Object} overrides <p>A literal with members which are copied into the subclass's
- * prototype, and are therefore shared between all instances of the new class.</p>
- * <p>This may contain a special member named <tt><b>constructor</b></tt>. This is used
- * to define the constructor of the new class, and is returned. If this property is
- * <i>not</i> specified, a constructor is generated and returned which just calls the
- * superclass's constructor passing on its parameters.</p>
- * <p><b>It is essential that you call the superclass constructor in any provided constructor. See example code.</b></p>
- * @return {Function} The subclass constructor from the <code>overrides</code> parameter, or a generated one if not provided.
- */
- extend : function(){
- // inline overrides
- var io = function(o){
- for(var m in o){
- this[m] = o[m];
- }
- };
- var oc = Object.prototype.constructor;
- return function(sb, sp, overrides){
- if(Ext.isObject(sp)){
- overrides = sp;
- sp = sb;
- sb = overrides.constructor != oc ? overrides.constructor : function(){sp.apply(this, arguments);};
- }
- var F = function(){},
- sbp,
- spp = sp.prototype;
- F.prototype = spp;
- sbp = sb.prototype = new F();
- sbp.constructor=sb;
- sb.superclass=spp;
- if(spp.constructor == oc){
- spp.constructor=sp;
- }
- sb.override = function(o){
- Ext.override(sb, o);
- };
- sbp.superclass = sbp.supr = (function(){
- return spp;
- });
- sbp.override = io;
- Ext.override(sb, overrides);
- sb.extend = function(o){return Ext.extend(sb, o);};
- return sb;
- };
- }(),
- /**
- * Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name.
- * Usage:<pre><code>
- Ext.override(MyClass, {
- newMethod1: function(){
- // etc.
- },
- newMethod2: function(foo){
- // etc.
- }
- });
- </code></pre>
- * @param {Object} origclass The class to override
- * @param {Object} overrides The list of functions to add to origClass. This should be specified as an object literal
- * containing one or more methods.
- * @method override
- */
- override : function(origclass, overrides){
- if(overrides){
- var p = origclass.prototype;
- Ext.apply(p, overrides);
- if(Ext.isIE && overrides.hasOwnProperty('toString')){
- p.toString = overrides.toString;
- }
- }
- },
- /**
- * Creates namespaces to be used for scoping variables and classes so that they are not global.
- * Specifying the last node of a namespace implicitly creates all other nodes. Usage:
- * <pre><code>
- Ext.namespace('Company', 'Company.data');
- Ext.namespace('Company.data'); // equivalent and preferable to above syntax
- Company.Widget = function() { ... }
- Company.data.CustomStore = function(config) { ... }
- </code></pre>
- * @param {String} namespace1
- * @param {String} namespace2
- * @param {String} etc
- * @return {Object} The namespace object. (If multiple arguments are passed, this will be the last namespace created)
- * @method namespace
- */
- namespace : function(){
- var o, d;
- Ext.each(arguments, function(v) {
- d = v.split(".");
- o = window[d[0]] = window[d[0]] || {};
- Ext.each(d.slice(1), function(v2){
- o = o[v2] = o[v2] || {};
- });
- });
- return o;
- },
- /**
- * Takes an object and converts it to an encoded URL. e.g. Ext.urlEncode({foo: 1, bar: 2}); would return "foo=1&bar=2". Optionally, property values can be arrays, instead of keys and the resulting string that's returned will contain a name/value pair for each array value.
- * @param {Object} o
- * @param {String} pre (optional) A prefix to add to the url encoded string
- * @return {String}
- */
- urlEncode : function(o, pre){
- var empty,
- buf = [],
- e = encodeURIComponent;
- Ext.iterate(o, function(key, item){
- empty = Ext.isEmpty(item);
- Ext.each(empty ? key : item, function(val){
- buf.push('&', e(key), '=', (!Ext.isEmpty(val) && (val != key || !empty)) ? (Ext.isDate(val) ? Ext.encode(val).replace(/"/g, '') : e(val)) : '');
- });
- });
- if(!pre){
- buf.shift();
- pre = '';
- }
- return pre + buf.join('');
- },
- /**
- * Takes an encoded URL and and converts it to an object. Example: <pre><code>
- Ext.urlDecode("foo=1&bar=2"); // returns {foo: "1", bar: "2"}
- Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2", "3", "4"]}
- </code></pre>
- * @param {String} string
- * @param {Boolean} overwrite (optional) Items of the same name will overwrite previous values instead of creating an an array (Defaults to false).
- * @return {Object} A literal with members
- */
- urlDecode : function(string, overwrite){
- if(Ext.isEmpty(string)){
- return {};
- }
- 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;
- },
- /**
- * 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;
- }
- 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;
- }
- //NodeList has an item and length property
- //IXMLDOMNodeList has nextNode method, needs to be checked first.
- return ((v.nextNode || 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 <code>index</code>. This function is called with
- * the following arguments:
- * <div class="mdetail-params"><ul>
- * <li><code>item</code> : <i>Mixed</i>
- * <div class="sub-desc">The item at the current <code>index</code>
- * in the passed <code>array</code></div></li>
- * <li><code>index</code> : <i>Number</i>
- * <div class="sub-desc">The current index within the array</div></li>
- * <li><code>allItems</code> : <i>Array</i>
- * <div class="sub-desc">The <code>array</code> passed as the first
- * argument to <code>Ext.each</code>.</div></li>
- * </ul></div>
- * @param {Object} scope The scope (<code>this</code> reference) in which the specified function is executed.
- * Defaults to the <code>item</code> at the current <code>index</code>
- * within the passed <code>array</code>.
- * @return See description for the fn parameter.
- */
- each : function(array, fn, scope){
- if(Ext.isEmpty(array, true)){
- return;
- }
- if(!Ext.isIterable(array) || Ext.isPrimitive(array)){
- array = [array];
- }
- for(var i = 0, len = array.length; i < len; i++){
- if(fn.call(scope || array[i], array[i], i, array) === false){
- return i;
- };
- }
- },
- /**
- * Iterates either the elements in an array, or each of the properties in an object.
- * <b>Note</b>: If you are only iterating arrays, it is better to call {@link #each}.
- * @param {Object/Array} object The object or array to be iterated
- * @param {Function} fn The function to be called for each iteration.
- * The iteration will stop if the supplied function returns false, or
- * all array elements / object properties have been covered. The signature
- * varies depending on the type of object being interated:
- * <div class="mdetail-params"><ul>
- * <li>Arrays : <tt>(Object item, Number index, Array allItems)</tt>
- * <div class="sub-desc">
- * When iterating an array, the supplied function is called with each item.</div></li>
- * <li>Objects : <tt>(String key, Object value, Object)</tt>
- * <div class="sub-desc">
- * When iterating an object, the supplied function is called with each key-value pair in
- * the object, and the iterated object</div></li>
- * </ul></div>
- * @param {Object} scope The scope (<code>this</code> reference) in which the specified function is executed. Defaults to
- * the <code>object</code> being iterated.
- */
- iterate : function(obj, fn, scope){
- if(Ext.isEmpty(obj)){
- return;
- }
- if(Ext.isIterable(obj)){
- Ext.each(obj, fn, scope);
- return;
- }else if(Ext.isObject(obj)){
- for(var prop in obj){
- if(obj.hasOwnProperty(prop)){
- if(fn.call(scope || obj, prop, obj[prop], obj) === false){
- return;
- };
- }
- }
- }
- },
- /**
- * Return the dom node for the passed String (id), dom node, or Ext.Element.
- * Here are some examples:
- * <pre><code>
- // gets dom node based on id
- var elDom = Ext.getDom('elId');
- // gets dom node based on the dom node
- var elDom1 = Ext.getDom(elDom);
- // If we don't know if we are working with an
- // Ext.Element or a dom node use Ext.getDom
- function(el){
- var dom = Ext.getDom(el);
- // do something with the dom node
- }
- * </code></pre>
- * <b>Note</b>: the dom node to be found actually needs to exist (be rendered, etc)
- * when this method is called to be successful.
- * @param {Mixed} el
- * @return HTMLElement
- */
- getDom : function(el){
- if(!el || !DOC){
- return null;
- }
- return el.dom ? el.dom : (Ext.isString(el) ? DOC.getElementById(el) : 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.
- */
- /**
- * <p>Removes this element from the document, removes all DOM event listeners, and deletes the cache reference.
- * All DOM event listeners are removed from this element. If {@link Ext#enableNestedListenerRemoval} is
- * <code>true</code>, then DOM event listeners are also removed from all child nodes. The body node
- * will be ignored if passed in.</p>
- * @param {HTMLElement} node The node to remove
- */
- removeNode : isIE && !isIE8 ? function(){
- var d;
- return function(n){
- if(n && n.tagName != 'BODY'){
- (Ext.enableNestedListenerRemoval) ? Ext.EventManager.purgeElement(n, true) : Ext.EventManager.removeAll(n);
- d = d || DOC.createElement('div');
- d.appendChild(n);
- d.innerHTML = '';
- delete Ext.elCache[n.id];
- }
- }
- }() : function(n){
- if(n && n.parentNode && n.tagName != 'BODY'){
- (Ext.enableNestedListenerRemoval) ? Ext.EventManager.purgeElement(n, true) : Ext.EventManager.removeAll(n);
- n.parentNode.removeChild(n);
- delete Ext.elCache[n.id];
- }
- },
- /**
- * <p>Returns true if the passed value is empty.</p>
- * <p>The value is deemed to be empty if it is<div class="mdetail-params"><ul>
- * <li>null</li>
- * <li>undefined</li>
- * <li>an empty array</li>
- * <li>a zero length string (Unless the <tt>allowBlank</tt> parameter is <tt>true</tt>)</li>
- * </ul></div>
- * @param {Mixed} value The value to test
- * @param {Boolean} allowBlank (optional) true to allow empty strings (defaults to false)
- * @return {Boolean}
- */
- 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;
- },
- /**
- * 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:
- * <pre><code>
- Ext.namespace('Company', 'Company.data');
- Ext.namespace('Company.data'); // equivalent and preferable to above syntax
- Company.Widget = function() { ... }
- Company.data.CustomStore = function(config) { ... }
- </code></pre>
- * @param {String} namespace1
- * @param {String} namespace2
- * @param {String} etc
- * @return {Object} The namespace object. (If multiple arguments are passed, this will be the last namespace created)
- * @method ns
- */
- Ext.ns = Ext.namespace;
- })();
- Ext.ns("Ext.util", "Ext.lib", "Ext.data");
- Ext.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:
- * <pre><code>
- 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"
- </code></pre>
- * @param {Function} fcn The function to call before the original
- * @param {Object} scope (optional) The scope (<code><b>this</b></code> reference) in which the passed function is executed.
- * <b>If omitted, defaults to the scope in which the original function is called or the browser window.</b>
- * @return {Function} The new function
- */
- 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: <code>myFunction.createCallback(arg1, arg2)</code>
- * Will create a function that is bound to those 2 args. <b>If a specific scope is required in the
- * callback, use {@link #createDelegate} instead.</b> The function returned by createCallback always
- * executes in the window scope.
- * <p>This method is required when you want to pass arguments to a callback function. If no arguments
- * are needed, you can simply pass a reference to the function as a callback (e.g., callback: myFn).
- * However, if you tried to pass a function with arguments (e.g., callback: myFn(arg1, arg2)) the function
- * would simply execute immediately when the code is parsed. Example usage:
- * <pre><code>
- var sayHi = function(name){
- alert('Hi, ' + name);
- }
- // clicking the button alerts "Hi, Fred"
- new Ext.Button({
- text: 'Say Hi',
- renderTo: Ext.getBody(),
- handler: sayHi.createCallback('Fred')
- });
- </code></pre>
- * @return {Function} The new function
- */
- createCallback : function(/*args...*/){
- // make args available, in function below
- var args = arguments,
- method = this;
- return function() {
- return method.apply(window, args);
- };
- },
- /**
- * Creates a delegate (callback) that sets the scope to obj.
- * Call directly on any function. Example: <code>this.myFunction.createDelegate(this, [arg1, arg2])</code>
- * Will create a function that is automatically scoped to obj so that the <tt>this</tt> variable inside the
- * callback points to obj. Example usage:
- * <pre><code>
- var sayHi = function(name){
- // Note this use of "this.text" here. This function expects to
- // execute within a scope that contains a text property. In this
- // example, the "this" variable is pointing to the btn object that
- // was passed in createDelegate below.
- alert('Hi, ' + name + '. You clicked the "' + this.text + '" button.');
- }
- var btn = new Ext.Button({
- text: 'Say Hi',
- renderTo: Ext.getBody()
- });
- // This callback will execute in the scope of the
- // button instance. Clicking the button alerts
- // "Hi, Fred. You clicked the "Say Hi" button."
- btn.on('click', sayHi.createDelegate(btn, ['Fred']));
- </code></pre>
- * @param {Object} scope (optional) The scope (<code><b>this</b></code> reference) in which the function is executed.
- * <b>If omitted, defaults to the browser window.</b>
- * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
- * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
- * if a number the args are inserted at the specified position
- * @return {Function} The new function
- */
- createDelegate : function(obj, args, appendArgs){
- var method = this;
- return function() {
- var callArgs = args || arguments;
- if (appendArgs === true){
- callArgs = Array.prototype.slice.call(arguments, 0);
- callArgs = callArgs.concat(args);
- }else if (Ext.isNumber(appendArgs)){
- callArgs = Array.prototype.slice.call(arguments, 0); // copy arguments first
- var applyArgs = [appendArgs, 0].concat(args); // create method call params
- Array.prototype.splice.apply(callArgs, applyArgs); // splice them in
- }
- return method.apply(obj || window, callArgs);
- };
- },
- /**
- * Calls this function after the number of millseconds specified, optionally in a specific scope. Example usage:
- * <pre><code>
- var sayHi = function(name){
- alert('Hi, ' + name);
- }
- // executes immediately:
- sayHi('Fred');
- // executes after 2 seconds:
- sayHi.defer(2000, this, ['Fred']);
- // this syntax is sometimes useful for deferring
- // execution of an anonymous function:
- (function(){
- alert('Anonymous');
- }).defer(100);
- </code></pre>
- * @param {Number} millis The number of milliseconds for the setTimeout call (if less than or equal to 0 the function is executed immediately)
- * @param {Object} scope (optional) The scope (<code><b>this</b></code> reference) in which the function is executed.
- * <b>If omitted, defaults to the browser window.</b>
- * @param {Array} args (optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)
- * @param {Boolean/Number} appendArgs (optional) if True args are appended to call args instead of overriding,
- * if a number the args are inserted at the specified position
- * @return {Number} The timeout id that can be used with clearTimeout
- */
- 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:
- * <pre><code>
- var cls = 'my-class', text = 'Some text';
- var s = String.format('<div class="{0}">{1}</div>', cls, text);
- // s now contains the string: '<div class="my-class">Some text</div>'
- * </code></pre>
- * @param {String} string The tokenized string to be formatted
- * @param {String} value1 The value to replace token {0}
- * @param {String} value2 Etc...
- * @return {String} The formatted string
- * @static
- */
- format : function(format){
- var args = Ext.toArray(arguments, 1);
- return format.replace(/{(d+)}/g, function(m, i){
- return args[i];
- });
- }
- });
- /**
- * @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;
- }
- }
- 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){
- this.splice(index, 1);
- }
- return this;
- }
- });