1 <div class="body-wrap" xmlns:ext="http://www.extjs.com"><div class="top-tools"><a class="inner-link" href="#Ext-props"><img src="resources/images/default/s.gif" class="item-icon icon-prop">Properties</a> <a class="inner-link" href="#Ext-methods"><img src="resources/images/default/s.gif" class="item-icon icon-method">Methods</a> <a class="inner-link" href="#Ext-events"><img src="resources/images/default/s.gif" class="item-icon icon-event">Events</a> <a class="bookmark" href="../docs/?class=Ext"><img src="resources/images/default/s.gif" class="item-icon icon-fav">Direct Link</a> </div><h1>Class <a href="source/Ext.html#cls-Ext">Ext</a></h1><table cellspacing="0"><tr><td class="label">Package:</td><td class="hd-info">Global</td></tr><tr><td class="label">Defined In:</td><td class="hd-info"><a href="source/Ext.html#cls-Ext">Ext.js</a></td></tr><tr><td class="label">Class:</td><td class="hd-info"><a href="source/Ext.html#cls-Ext">Ext</a></td></tr><tr><td class="label">Extends:</td><td class="hd-info">Object</td></tr></table><div class="description">Ext core utilities and functions.<br><br><i>This class is a singleton and cannot be created directly.</i></div><div class="hr"></div><a id="Ext-props"></a><h2>Public Properties</h2><table cellspacing="0" class="member-table"><tbody><tr><th colspan="2" class="sig-header">Property</th><th class="msource-header">Defined By</th></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-"></a><b><a href="source/Ext.html#prop-Ext-"></a></b> : Object<div class="mdesc">Removes a DOM node from the document.</div></td><td class="msource">Ext</td></tr><tr class="property-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-BLANK_IMAGE_URL"></a><b><a href="source/Ext-more.html#prop-Ext-BLANK_IMAGE_URL">BLANK_IMAGE_URL</a></b> : String<div class="mdesc"><div class="short">URL to a 1x1 transparent gif image used by Ext to create inline icons with CSS background images.
2 In older versions o...</div><div class="long">URL to a 1x1 transparent gif image used by Ext to create inline icons with CSS background images.
3 In older versions of IE, this defaults to "http://extjs.com/s.gif" and you should change this to a URL on your server.
4 For other browsers it uses an inline data URL.</div></div></td><td class="msource">Ext</td></tr><tr class="property-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-SSL_SECURE_URL"></a><b><a href="source/Ext.html#prop-Ext-SSL_SECURE_URL">SSL_SECURE_URL</a></b> : String<div class="mdesc"><div class="short">URL to a blank file used by Ext when in secure mode for iframe src and onReady src to prevent
5 the IE insecure content...</div><div class="long">URL to a blank file used by Ext when in secure mode for iframe src and onReady src to prevent
6 the IE insecure content warning (<tt>'about:blank'</tt>, except for IE in secure mode, which is <tt>'javascript:""'</tt>).</div></div></td><td class="msource">Ext</td></tr><tr class="property-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-USE_NATIVE_JSON"></a><b><a href="source/Ext.html#prop-Ext-USE_NATIVE_JSON">USE_NATIVE_JSON</a></b> : Boolean<div class="mdesc"><div class="short">Indicates whether to use native browser parsing for JSON methods.
7 This option is ignored if the browser does not supp...</div><div class="long">Indicates whether to use native browser parsing for JSON methods.
8 This option is ignored if the browser does not support native JSON methods.
9 <b>Note: Native JSON methods will not work with objects that have functions.
10 Also, property names must be quoted, otherwise the data will not parse.</b> (Defaults to false)</div></div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-emptyFn"></a><b><a href="source/Ext-more.html#prop-Ext-emptyFn">emptyFn</a></b> : Function<div class="mdesc">A reusable empty function</div></td><td class="msource">Ext</td></tr><tr class="property-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-enableForcedBoxModel"></a><b><a href="source/Ext.html#prop-Ext-enableForcedBoxModel">enableForcedBoxModel</a></b> : Boolean<div class="mdesc"><div class="short">HIGHLY EXPERIMENTAL
11 True to force css based border-box model override and turning off javascript based adjustments. T...</div><div class="long">HIGHLY EXPERIMENTAL
12 True to force css based border-box model override and turning off javascript based adjustments. This is a
13 runtime configuration and must be set before onReady.</div></div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-enableFx"></a><b><a href="source/Ext.html#prop-Ext-enableFx">enableFx</a></b> : Boolean<div class="mdesc">True if the <a href="output/Ext.Fx.html" ext:cls="Ext.Fx">Ext.Fx</a> Class is available</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-enableGarbageCollector"></a><b><a href="source/Ext.html#prop-Ext-enableGarbageCollector">enableGarbageCollector</a></b> : Boolean<div class="mdesc">True to automatically uncache orphaned Ext.Elements periodically (defaults to true)</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-enableListenerCollection"></a><b><a href="source/Ext.html#prop-Ext-enableListenerCollection">enableListenerCollection</a></b> : Boolean<div class="mdesc">True to automatically purge event listeners during garbageCollection (defaults to false).</div></td><td class="msource">Ext</td></tr><tr class="property-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-enableNestedListenerRemoval"></a><b><a href="source/Ext.html#prop-Ext-enableNestedListenerRemoval">enableNestedListenerRemoval</a></b> : Boolean<div class="mdesc"><div class="short">EXPERIMENTAL - True to cascade listener removal to child elements when an element is removed.
14 Currently not optimized...</div><div class="long">EXPERIMENTAL - True to cascade listener removal to child elements when an element is removed.
15 Currently not optimized for performance.</div></div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isAir"></a><b><a href="source/Ext.html#prop-Ext-isAir">isAir</a></b> : Boolean<div class="mdesc">True if the detected platform is Adobe Air.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isBorderBox"></a><b><a href="source/Ext.html#prop-Ext-isBorderBox">isBorderBox</a></b> : Boolean<div class="mdesc">True if the detected browser is Internet Explorer running in non-strict mode.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isChrome"></a><b><a href="source/Ext.html#prop-Ext-isChrome">isChrome</a></b> : Boolean<div class="mdesc">True if the detected browser is Chrome.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isGecko"></a><b><a href="source/Ext.html#prop-Ext-isGecko">isGecko</a></b> : Boolean<div class="mdesc">True if the detected browser uses the Gecko layout engine (e.g. Mozilla, Firefox).</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isGecko2"></a><b><a href="source/Ext.html#prop-Ext-isGecko2">isGecko2</a></b> : Boolean<div class="mdesc">True if the detected browser uses a pre-Gecko 1.9 layout engine (e.g. Firefox 2.x).</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isGecko3"></a><b><a href="source/Ext.html#prop-Ext-isGecko3">isGecko3</a></b> : Boolean<div class="mdesc">True if the detected browser uses a Gecko 1.9+ layout engine (e.g. Firefox 3.x).</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isIE"></a><b><a href="source/Ext.html#prop-Ext-isIE">isIE</a></b> : Boolean<div class="mdesc">True if the detected browser is Internet Explorer.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isIE6"></a><b><a href="source/Ext.html#prop-Ext-isIE6">isIE6</a></b> : Boolean<div class="mdesc">True if the detected browser is Internet Explorer 6.x.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isIE7"></a><b><a href="source/Ext.html#prop-Ext-isIE7">isIE7</a></b> : Boolean<div class="mdesc">True if the detected browser is Internet Explorer 7.x.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isIE8"></a><b><a href="source/Ext.html#prop-Ext-isIE8">isIE8</a></b> : Boolean<div class="mdesc">True if the detected browser is Internet Explorer 8.x.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isLinux"></a><b><a href="source/Ext.html#prop-Ext-isLinux">isLinux</a></b> : Boolean<div class="mdesc">True if the detected platform is Linux.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isMac"></a><b><a href="source/Ext.html#prop-Ext-isMac">isMac</a></b> : Boolean<div class="mdesc">True if the detected platform is Mac OS.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isOpera"></a><b><a href="source/Ext.html#prop-Ext-isOpera">isOpera</a></b> : Boolean<div class="mdesc">True if the detected browser is Opera.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isReady"></a><b><a href="source/Ext.html#prop-Ext-isReady">isReady</a></b> : Boolean<div class="mdesc">True when the document is fully initialized and ready for action</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isSafari"></a><b><a href="source/Ext.html#prop-Ext-isSafari">isSafari</a></b> : Boolean<div class="mdesc">True if the detected browser is Safari.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isSafari2"></a><b><a href="source/Ext.html#prop-Ext-isSafari2">isSafari2</a></b> : Boolean<div class="mdesc">True if the detected browser is Safari 2.x.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isSafari3"></a><b><a href="source/Ext.html#prop-Ext-isSafari3">isSafari3</a></b> : Boolean<div class="mdesc">True if the detected browser is Safari 3.x.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isSafari4"></a><b><a href="source/Ext.html#prop-Ext-isSafari4">isSafari4</a></b> : Boolean<div class="mdesc">True if the detected browser is Safari 4.x.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isSecure"></a><b><a href="source/Ext.html#prop-Ext-isSecure">isSecure</a></b> : Boolean<div class="mdesc">True if the page is running over SSL</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isStrict"></a><b><a href="source/Ext.html#prop-Ext-isStrict">isStrict</a></b> : Boolean<div class="mdesc">True if the browser is in strict (standards-compliant) mode, as opposed to quirks mode</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isWebKit"></a><b><a href="source/Ext.html#prop-Ext-isWebKit">isWebKit</a></b> : Boolean<div class="mdesc">True if the detected browser uses WebKit.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isWindows"></a><b><a href="source/Ext.html#prop-Ext-isWindows">isWindows</a></b> : Boolean<div class="mdesc">True if the detected platform is Windows.</div></td><td class="msource">Ext</td></tr><tr class="property-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-useShims"></a><b><a href="source/Ext-more.html#prop-Ext-useShims">useShims</a></b> : Boolean<div class="mdesc"><div class="short">By default, Ext intelligently decides whether floating elements should be shimmed. If you are using flash,
16 you may wa...</div><div class="long">By default, Ext intelligently decides whether floating elements should be shimmed. If you are using flash,
17 you may want to set this to true.</div></div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-ux"></a><b><a href="source/Ext-more.html#prop-Ext-ux">ux</a></b> : Object<div class="mdesc">Namespace alloted for extensions to the framework.</div></td><td class="msource">Ext</td></tr><tr class="property-row "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-version"></a><b><a href="source/Ext.html#prop-Ext-version">version</a></b> : String<div class="mdesc">The version of the framework</div></td><td class="msource">Ext</td></tr></tbody></table><a id="Ext-methods"></a><h2>Public Methods</h2><table cellspacing="0" class="member-table"><tbody><tr><th colspan="2" class="sig-header">Method</th><th class="msource-header">Defined By</th></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-addBehaviors"></a><b><a href="source/Ext-more.html#method-Ext-addBehaviors">addBehaviors</a></b>( <code>Object obj</code> )
19 void<div class="mdesc"><div class="short">Applies event listeners to elements by selectors when the document is ready.
20 The event name is specified with an &#64...</div><div class="long">Applies event listeners to elements by selectors when the document is ready.
21 The event name is specified with an <tt>@</tt> suffix.
22 <pre><code>Ext.addBehaviors({
23 <i>// add a listener <b>for</b> click on all anchors <b>in</b> element <b>with</b> id foo</i>
24 <em>'#foo a@click'</em> : <b>function</b>(e, t){
25 <i>// <b>do</b> something</i>
28 <i>// add the same listener to multiple selectors (separated by comma BEFORE the @)</i>
29 <em>'#foo a, #bar span.some-class@mouseover'</em> : <b>function</b>(){
30 <i>// <b>do</b> something</i>
32 });</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>obj</code> : Object<div class="sub-desc">The list of behaviors to apply</div></li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-apply"></a><b><a href="source/Ext.html#method-Ext-apply">apply</a></b>( <code>Object obj</code>, <code>Object config</code>, <code>Object defaults</code> )
34 Object<div class="mdesc"><div class="short">Copies all the properties of config to obj.</div><div class="long">Copies all the properties of config to obj.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>obj</code> : Object<div class="sub-desc">The receiver of the properties</div></li><li><code>config</code> : Object<div class="sub-desc">The source of the properties</div></li><li><code>defaults</code> : Object<div class="sub-desc">A different object that will also be applied for default values</div></li></ul><strong>Returns:</strong><ul><li><code>Object</code><div class="sub-desc">returns obj</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-applyIf"></a><b><a href="source/Ext.html#method-Ext-applyIf">applyIf</a></b>( <code>Object obj</code>, <code>Object config</code> )
36 Object<div class="mdesc"><div class="short">Copies all the properties of config to obj if they don't already exist.</div><div class="long">Copies all the properties of config to obj if they don't already exist.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>obj</code> : Object<div class="sub-desc">The receiver of the properties</div></li><li><code>config</code> : Object<div class="sub-desc">The source of the properties</div></li></ul><strong>Returns:</strong><ul><li><code>Object</code><div class="sub-desc">returns obj</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-clean"></a><b><a href="source/Ext-more.html#method-Ext-clean">clean</a></b>( <code>Array/NodeList arr</code> )
38 Array<div class="mdesc"><div class="short">Creates a copy of the passed Array with falsy values removed.</div><div class="long">Creates a copy of the passed Array with falsy values removed.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>arr</code> : Array/NodeList<div class="sub-desc">The Array from which to remove falsy values.</div></li></ul><strong>Returns:</strong><ul><li><code>Array</code><div class="sub-desc">The new, compressed Array.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-copyTo"></a><b><a href="source/Ext-more.html#method-Ext-copyTo">copyTo</a></b>( <code>Object dest</code>, <code>Object source</code>, <code>Array/String names</code> )
40 Object<div class="mdesc"><div class="short">Copies a set of named properties fom the source object to the destination object.
41 example:ImageComponent = Ext.extend...</div><div class="long">Copies a set of named properties fom the source object to the destination object.
42 <p>example:<pre><code>ImageComponent = Ext.extend(Ext.BoxComponent, {
43 initComponent: <b>function</b>() {
44 this.autoEl = { tag: <em>'img'</em> };
45 MyComponent.superclass.initComponent.apply(this, arguments);
46 this.initialBox = Ext.copyTo({}, this.initialConfig, <em>'x,y,width,height'</em>);
48 });</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>dest</code> : Object<div class="sub-desc">The destination object.</div></li><li><code>source</code> : Object<div class="sub-desc">The source object.</div></li><li><code>names</code> : Array/String<div class="sub-desc">Either an Array of property names, or a comma-delimited list
49 of property names to copy.</div></li></ul><strong>Returns:</strong><ul><li><code>Object</code><div class="sub-desc">The modified object.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-create"></a><b><a href="source/ComponentMgr.html#method-Ext-create">create</a></b>( <code>Object config</code>, <code>Constructor defaultType</code> )
51 Ext.Component<div class="mdesc"><div class="short">Shorthand for Ext.ComponentMgr.create
52 Creates a new Component from the specified config object using the
53 config objec...</div><div class="long">Shorthand for <a href="output/Ext.ComponentMgr.html#Ext.ComponentMgr-create" ext:member="create" ext:cls="Ext.ComponentMgr">Ext.ComponentMgr.create</a>
54 Creates a new Component from the specified config object using the
55 config object's <a href="output/Ext.component.html#Ext.component-xtype" ext:member="xtype" ext:cls="Ext.component">xtype</a> to determine the class to instantiate.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>config</code> : Object<div class="sub-desc">A configuration object for the Component you wish to create.</div></li><li><code>defaultType</code> : Constructor<div class="sub-desc">The constructor to provide the default Component type if
56 the config object does not contain a <code>xtype</code>. (Optional if the config contains a <code>xtype</code>).</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Component</code><div class="sub-desc">The newly instantiated Component.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-decode"></a><b><a href="source/JSON.html#method-Ext-decode">decode</a></b>( <code>String json</code>, <span title="Optional" class="optional">[<code>Boolean safe</code>]</span> )
58 Object<div class="mdesc"><div class="short">Shorthand for Ext.util.JSON.decode</div><div class="long">Shorthand for <a href="output/Ext.util.JSON.html#Ext.util.JSON-decode" ext:member="decode" ext:cls="Ext.util.JSON">Ext.util.JSON.decode</a><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>json</code> : String<div class="sub-desc">The JSON string</div></li><li><code>safe</code> : Boolean<div class="sub-desc">(optional) Whether to return null or throw an exception if the JSON is invalid.</div></li></ul><strong>Returns:</strong><ul><li><code>Object</code><div class="sub-desc">The resulting object</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-defer"></a><b><a href="source/Function.html#method-Ext-defer">defer</a></b>( <code>Function fn</code>, <span title="Optional" class="optional">[<code>Object scope</code>]</span>, <span title="Optional" class="optional">[<code>Array args</code>]</span>, <span title="Optional" class="optional">[<code>Boolean/Number appendArgs</code>]</span> )
60 Function<div class="mdesc"><div class="short">Shorthand for Ext.util.Functions.createDelegate</div><div class="long">Shorthand for <a href="output/Ext.util.Functions.html#Ext.util.Functions-createDelegate" ext:member="createDelegate" ext:cls="Ext.util.Functions">Ext.util.Functions.createDelegate</a><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>fn</code> : Function<div class="sub-desc">The function to delegate.</div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope (<code><b>this</b></code> reference) in which the function is executed.
61 <b>If omitted, defaults to the browser window.</b></div></li><li><code>args</code> : Array<div class="sub-desc">(optional) Overrides arguments for the call. (Defaults to the arguments passed by the caller)</div></li><li><code>appendArgs</code> : Boolean/Number<div class="sub-desc">(optional) if True args are appended to call args instead of overriding,
62 if a number the args are inserted at the specified position</div></li></ul><strong>Returns:</strong><ul><li><code>Function</code><div class="sub-desc">The new function</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-destroy"></a><b><a href="source/Ext-more.html#method-Ext-destroy">destroy</a></b>( <code>Mixed arg1</code>, <span title="Optional" class="optional">[<code>Mixed arg2</code>]</span>, <span title="Optional" class="optional">[<code>Mixed etc...</code>]</span> )
64 void<div class="mdesc"><div class="short">Attempts to destroy any objects passed to it by removing all event listeners, removing them from the
65 DOM (if applicab...</div><div class="long">Attempts to destroy any objects passed to it by removing all event listeners, removing them from the
66 DOM (if applicable) and calling their destroy functions (if available). This method is primarily
67 intended for arguments of type <a href="output/Ext.Element.html" ext:cls="Ext.Element">Ext.Element</a> and <a href="output/Ext.Component.html" ext:cls="Ext.Component">Ext.Component</a>, but any subclass of
68 <a href="output/Ext.util.Observable.html" ext:cls="Ext.util.Observable">Ext.util.Observable</a> can be passed in. Any number of elements and/or components can be
69 passed into this function in a single call as separate arguments.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>arg1</code> : Mixed<div class="sub-desc">An <a href="output/Ext.Element.html" ext:cls="Ext.Element">Ext.Element</a>, <a href="output/Ext.Component.html" ext:cls="Ext.Component">Ext.Component</a>, or an Array of either of these to destroy</div></li><li><code>arg2</code> : Mixed<div class="sub-desc">(optional)</div></li><li><code>etc...</code> : Mixed<div class="sub-desc">(optional)</div></li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-destroyMembers"></a><b><a href="source/Ext-more.html#method-Ext-destroyMembers">destroyMembers</a></b>( <code>Object o</code>, <code>Mixed arg1</code>, <code>Mixed etc...</code> )
71 void<div class="mdesc"><div class="short">Attempts to destroy and then remove a set of named properties of the passed object.</div><div class="long">Attempts to destroy and then remove a set of named properties of the passed object.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>o</code> : Object<div class="sub-desc">The object (most likely a Component) who's properties you wish to destroy.</div></li><li><code>arg1</code> : Mixed<div class="sub-desc">The name of the property to destroy and remove from the object.</div></li><li><code>etc...</code> : Mixed<div class="sub-desc">More property names to destroy and remove.</div></li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-each"></a><b><a href="source/Ext.html#method-Ext-each">each</a></b>( <code>Array/NodeList/Mixed array</code>, <code>Function fn</code>, <code>Object scope</code> )
73 See<div class="mdesc"><div class="short">Iterates an array calling the supplied function.</div><div class="long">Iterates an array calling the supplied function.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>array</code> : Array/NodeList/Mixed<div class="sub-desc">The array to be iterated. If this
74 argument is not really an array, the supplied function is called once.</div></li><li><code>fn</code> : Function<div class="sub-desc">The function to be called with each item. If the
75 supplied function returns false, iteration stops and this method returns
76 the current <code>index</code>. This function is called with
77 the following arguments:
78 <div class="mdetail-params"><ul>
79 <li><code>item</code> : <i>Mixed</i>
80 <div class="sub-desc">The item at the current <code>index</code>
81 in the passed <code>array</code></div></li>
82 <li><code>index</code> : <i>Number</i>
83 <div class="sub-desc">The current index within the array</div></li>
84 <li><code>allItems</code> : <i>Array</i>
85 <div class="sub-desc">The <code>array</code> passed as the first
86 argument to <code>Ext.each</code>.</div></li>
87 </ul></div></div></li><li><code>scope</code> : Object<div class="sub-desc">The scope (<code>this</code> reference) in which the specified function is executed.
88 Defaults to the <code>item</code> at the current <code>index</code>
89 within the passed <code>array</code>.</div></li></ul><strong>Returns:</strong><ul><li><code>See</code><div class="sub-desc">description for the fn parameter.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-encode"></a><b><a href="source/JSON.html#method-Ext-encode">encode</a></b>( <code>Mixed o</code> )
91 String<div class="mdesc"><div class="short">Shorthand for Ext.util.JSON.encode</div><div class="long">Shorthand for <a href="output/Ext.util.JSON.html#Ext.util.JSON-encode" ext:member="encode" ext:cls="Ext.util.JSON">Ext.util.JSON.encode</a><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>o</code> : Mixed<div class="sub-desc">The variable to encode</div></li></ul><strong>Returns:</strong><ul><li><code>String</code><div class="sub-desc">The JSON string</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-escapeRe"></a><b><a href="source/Ext-more.html#method-Ext-escapeRe">escapeRe</a></b>( <code>String str</code> )
93 String<div class="mdesc"><div class="short">Escapes the passed string for use in a regular expression</div><div class="long">Escapes the passed string for use in a regular expression<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>str</code> : String<div class="sub-desc"></div></li></ul><strong>Returns:</strong><ul><li><code>String</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-extend"></a><b><a href="source/Ext.html#method-Ext-extend">extend</a></b>( <code>Function superclass</code>, <code>Object overrides</code> )
95 Function<div class="mdesc"><div class="short">Extends one class to create a subclass and optionally overrides members with the passed literal. This method
96 also add...</div><div class="long"><p>Extends one class to create a subclass and optionally overrides members with the passed literal. This method
97 also adds the function "override()" to the subclass that can be used to override members of the class.</p>
98 For example, to create a subclass of Ext GridPanel:
99 <pre><code>MyGridPanel = Ext.extend(Ext.grid.GridPanel, {
100 constructor: <b>function</b>(config) {
102 <i>// Create configuration <b>for</b> this Grid.</i>
103 <b>var</b> store = <b>new</b> Ext.data.Store({...});
104 <b>var</b> colModel = <b>new</b> Ext.grid.ColumnModel({...});
106 <i>// Create a <b>new</b> config object containing our computed properties</i>
107 <i>// *plus* whatever was <b>in</b> the config parameter.</i>
113 MyGridPanel.superclass.constructor.call(this, config);
115 <i>// Your postprocessing here</i>
118 yourMethod: <b>function</b>() {
122 <p>This function also supports a 3-argument call in which the subclass's constructor is
123 passed as an argument. In this form, the parameters are as follows:</p>
124 <div class="mdetail-params"><ul>
125 <li><code>subclass</code> : Function <div class="sub-desc">The subclass constructor.</div></li>
126 <li><code>superclass</code> : Function <div class="sub-desc">The constructor of class being extended</div></li>
127 <li><code>overrides</code> : Object <div class="sub-desc">A literal with members which are copied into the subclass's
128 prototype, and are therefore shared among all instances of the new class.</div></li>
129 </ul></div><div class="mdetail-params"><strong>Parameters:</strong><ul><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"><p>A literal with members which are copied into the subclass's
130 prototype, and are therefore shared between all instances of the new class.</p>
131 <p>This may contain a special member named <tt><b>constructor</b></tt>. This is used
132 to define the constructor of the new class, and is returned. If this property is
133 <i>not</i> specified, a constructor is generated and returned which just calls the
134 superclass's constructor passing on its parameters.</p>
135 <p><b>It is essential that you call the superclass constructor in any provided constructor. See example code.</b></p></div></li></ul><strong>Returns:</strong><ul><li><code>Function</code><div class="sub-desc">The subclass constructor from the <code>overrides</code> parameter, or a generated one if not provided.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-flatten"></a><b><a href="source/Ext-more.html#method-Ext-flatten">flatten</a></b>( <code>Array arr</code> )
137 Array<div class="mdesc"><div class="short">Recursively flattens into 1-d Array. Injects Arrays inline.</div><div class="long">Recursively flattens into 1-d Array. Injects Arrays inline.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>arr</code> : Array<div class="sub-desc">The array to flatten</div></li></ul><strong>Returns:</strong><ul><li><code>Array</code><div class="sub-desc">The new, flattened array.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-fly"></a><b><a href="source/Element.html#method-Ext-fly">fly</a></b>( <code>String/HTMLElement el</code>, <span title="Optional" class="optional">[<code>String named</code>]</span> )
139 Element<div class="mdesc"><div class="short">Gets the globally shared flyweight Element, with the passed node as the active element. Do not store a reference to t...</div><div class="long"><p>Gets the globally shared flyweight Element, with the passed node as the active element. Do not store a reference to this element -
140 the dom node can be overwritten by other code. Shorthand of <a href="output/Ext.Element.html#Ext.Element-fly" ext:member="fly" ext:cls="Ext.Element">Ext.Element.fly</a></p>
141 <p>Use this to make one-time references to DOM elements which are not going to be accessed again either by
142 application code, or by Ext's classes. If accessing an element which will be processed regularly, then <a href="output/Ext.html#Ext-get" ext:member="get" ext:cls="Ext">Ext.get</a>
143 will be more appropriate to take advantage of the caching provided by the Ext.Element class.</p><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>el</code> : String/HTMLElement<div class="sub-desc">The dom node or id</div></li><li><code>named</code> : String<div class="sub-desc">(optional) Allows for creation of named reusable flyweights to prevent conflicts
144 (e.g. internally Ext uses "_global")</div></li></ul><strong>Returns:</strong><ul><li><code>Element</code><div class="sub-desc">The shared Element object (or null if no matching element was found)</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-get"></a><b><a href="source/Element.html#method-Ext-get">get</a></b>( <code>Mixed el</code> )
146 Element<div class="mdesc"><div class="short">Retrieves Ext.Element objects.
147 This method does not retrieve Components. This method
148 retrieves Ext.Element objects wh...</div><div class="long">Retrieves Ext.Element objects.
149 <p><b>This method does not retrieve <a href="output/Ext.Component.html" ext:cls="Ext.Component">Component</a>s.</b> This method
150 retrieves Ext.Element objects which encapsulate DOM elements. To retrieve a Component by
151 its ID, use <a href="output/Ext.ComponentMgr.html#Ext.ComponentMgr-get" ext:member="get" ext:cls="Ext.ComponentMgr">Ext.ComponentMgr.get</a>.</p>
152 <p>Uses simple caching to consistently return the same object. Automatically fixes if an
153 object was recreated with the same id via AJAX or DOM.</p>
154 Shorthand of <a href="output/Ext.Element.html#Ext.Element-get" ext:member="get" ext:cls="Ext.Element">Ext.Element.get</a><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>el</code> : Mixed<div class="sub-desc">The id of the node, a DOM Node or an existing Element.</div></li></ul><strong>Returns:</strong><ul><li><code>Element</code><div class="sub-desc">The Element object (or null if no matching element was found)</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-getBody"></a><b><a href="source/Ext.html#method-Ext-getBody">getBody</a></b>()
156 Ext.Element<div class="mdesc"><div class="short">Returns the current document body as an Ext.Element.</div><div class="long">Returns the current document body as an <a href="output/Ext.Element.html" ext:cls="Ext.Element">Ext.Element</a>.<div class="mdetail-params"><strong>Parameters:</strong><ul><li>None.</li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The document body</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-getCmp"></a><b><a href="source/Ext-more.html#method-Ext-getCmp">getCmp</a></b>( <code>String id</code> )
158 Ext.Component<div class="mdesc"><div class="short">This is shorthand reference to Ext.ComponentMgr.get.
159 Looks up an existing Component by id</div><div class="long">This is shorthand reference to <a href="output/Ext.ComponentMgr.html#Ext.ComponentMgr-get" ext:member="get" ext:cls="Ext.ComponentMgr">Ext.ComponentMgr.get</a>.
160 Looks up an existing <a href="output/Ext.Component.html" ext:cls="Ext.Component">Component</a> by <a href="output/Ext.Component.html#Ext.Component-id" ext:member="id" ext:cls="Ext.Component">id</a><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>id</code> : String<div class="sub-desc">The component <a href="output/Ext.Component.html#Ext.Component-id" ext:member="id" ext:cls="Ext.Component">id</a></div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Component</code><div class="sub-desc">The Component, <tt>undefined</tt> if not found, or <tt>null</tt> if a
161 Class was found.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-getDoc"></a><b><a href="source/Ext-more.html#method-Ext-getDoc">getDoc</a></b>()
163 Ext.Element<div class="mdesc"><div class="short">Returns the current HTML document object as an Ext.Element.</div><div class="long">Returns the current HTML document object as an <a href="output/Ext.Element.html" ext:cls="Ext.Element">Ext.Element</a>.<div class="mdetail-params"><strong>Parameters:</strong><ul><li>None.</li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The document</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-getDom"></a><b><a href="source/Ext.html#method-Ext-getDom">getDom</a></b>( <code>Mixed el</code> )
165 HTMLElement<div class="mdesc"><div class="short">Return the dom node for the passed String (id), dom node, or Ext.Element.
166 Optional 'strict' flag is needed for IE sin...</div><div class="long">Return the dom node for the passed String (id), dom node, or Ext.Element.
167 Optional 'strict' flag is needed for IE since it can return 'name' and
168 'id' elements by using getElementById.
169 Here are some examples:
170 <pre><code><i>// gets dom node based on id</i>
171 <b>var</b> elDom = Ext.getDom(<em>'elId'</em>);
172 <i>// gets dom node based on the dom node</i>
173 <b>var</b> elDom1 = Ext.getDom(elDom);
175 <i>// If we don't know <b>if</b> we are working <b>with</b> an</i>
176 <i>// Ext.Element or a dom node use Ext.getDom</i>
178 <b>var</b> dom = Ext.getDom(el);
179 <i>// <b>do</b> something <b>with</b> the dom node</i>
181 <b>Note</b>: the dom node to be found actually needs to exist (be rendered, etc)
182 when this method is called to be successful.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>el</code> : Mixed<div class="sub-desc"></div></li></ul><strong>Returns:</strong><ul><li><code>HTMLElement</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-getHead"></a><b><a href="source/Ext.html#method-Ext-getHead">getHead</a></b>()
184 Ext.Element<div class="mdesc"><div class="short">Returns the current document body as an Ext.Element.</div><div class="long">Returns the current document body as an <a href="output/Ext.Element.html" ext:cls="Ext.Element">Ext.Element</a>.<div class="mdetail-params"><strong>Parameters:</strong><ul><li>None.</li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The document body</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-getScrollBarWidth"></a><b><a href="source/Ext-more.html#method-Ext-getScrollBarWidth">getScrollBarWidth</a></b>( <span title="Optional" class="optional">[<code>Boolean force</code>]</span> )
186 Number<div class="mdesc"><div class="short">Utility method for getting the width of the browser scrollbar. This can differ depending on
187 operating system settings...</div><div class="long">Utility method for getting the width of the browser scrollbar. This can differ depending on
188 operating system settings, such as the theme or font size.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>force</code> : Boolean<div class="sub-desc">(optional) true to force a recalculation of the value.</div></li></ul><strong>Returns:</strong><ul><li><code>Number</code><div class="sub-desc">The width of the scrollbar.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-id"></a><b><a href="source/Ext.html#method-Ext-id">id</a></b>( <span title="Optional" class="optional">[<code>Mixed el</code>]</span>, <span title="Optional" class="optional">[<code>String prefix</code>]</span> )
190 String<div class="mdesc"><div class="short">Generates unique ids. If the element already has an id, it is unchanged</div><div class="long">Generates unique ids. If the element already has an id, it is unchanged<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>el</code> : Mixed<div class="sub-desc">(optional) The element to generate an id for</div></li><li><code>prefix</code> : String<div class="sub-desc">(optional) Id prefix (defaults "ext-gen")</div></li></ul><strong>Returns:</strong><ul><li><code>String</code><div class="sub-desc">The generated Id.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-invoke"></a><b><a href="source/Ext-more.html#method-Ext-invoke">invoke</a></b>( <code>Array|NodeList arr</code>, <code>String methodName</code>, <code>...* args</code> )
192 Array<div class="mdesc"><div class="short">Invokes a method on each item in an Array.
194 Ext.invoke(Ext.query("p"), "getAttribute", "id");
195 // [el1.getA...</div><div class="long">Invokes a method on each item in an Array.
196 <pre><code><i>// Example:</i>
197 Ext.invoke(Ext.query(<em>"p"</em>), <em>"getAttribute"</em>, <em>"id"</em>);
198 <i>// [el1.getAttribute(<em>"id"</em>), el2.getAttribute(<em>"id"</em>), ..., elN.getAttribute(<em>"id"</em>)]</i></code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>arr</code> : Array|NodeList<div class="sub-desc">The Array of items to invoke the method on.</div></li><li><code>methodName</code> : String<div class="sub-desc">The method name to invoke.</div></li><li><code>args</code> : ...*<div class="sub-desc">Arguments to send into the method invocation.</div></li></ul><strong>Returns:</strong><ul><li><code>Array</code><div class="sub-desc">The results of invoking the method on each item in the array.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isArray"></a><b><a href="source/Ext.html#method-Ext-isArray">isArray</a></b>( <code>Mixed value</code> )
200 Boolean<div class="mdesc"><div class="short">Returns true if the passed value is a JavaScript array, otherwise false.</div><div class="long">Returns true if the passed value is a JavaScript array, otherwise false.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>value</code> : Mixed<div class="sub-desc">The value to test</div></li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isBoolean"></a><b><a href="source/Ext.html#method-Ext-isBoolean">isBoolean</a></b>( <code>Mixed value</code> )
202 Boolean<div class="mdesc"><div class="short">Returns true if the passed value is a boolean.</div><div class="long">Returns true if the passed value is a boolean.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>value</code> : Mixed<div class="sub-desc">The value to test</div></li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isDate"></a><b><a href="source/Ext.html#method-Ext-isDate">isDate</a></b>( <code>Object object</code> )
204 Boolean<div class="mdesc"><div class="short">Returns true if the passed object is a JavaScript date object, otherwise false.</div><div class="long">Returns true if the passed object is a JavaScript date object, otherwise false.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>object</code> : Object<div class="sub-desc">The object to test</div></li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isDefined"></a><b><a href="source/Ext.html#method-Ext-isDefined">isDefined</a></b>( <code>Mixed value</code> )
206 Boolean<div class="mdesc"><div class="short">Returns true if the passed value is not undefined.</div><div class="long">Returns true if the passed value is not undefined.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>value</code> : Mixed<div class="sub-desc">The value to test</div></li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isElement"></a><b><a href="source/Ext.html#method-Ext-isElement">isElement</a></b>( <code>Mixed value</code> )
208 Boolean<div class="mdesc"><div class="short">Returns true if the passed value is an HTMLElement</div><div class="long">Returns true if the passed value is an HTMLElement<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>value</code> : Mixed<div class="sub-desc">The value to test</div></li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isEmpty"></a><b><a href="source/Ext.html#method-Ext-isEmpty">isEmpty</a></b>( <code>Mixed value</code>, <span title="Optional" class="optional">[<code>Boolean allowBlank</code>]</span> )
210 Boolean<div class="mdesc"><div class="short">Returns true if the passed value is empty.
211 The value is deemed to be empty if it is<div class="mdetail-params">
213 ...</div><div class="long"><p>Returns true if the passed value is empty.</p>
214 <p>The value is deemed to be empty if it is<div class="mdetail-params"><ul>
217 <li>an empty array</li>
218 <li>a zero length string (Unless the <tt>allowBlank</tt> parameter is <tt>true</tt>)</li>
219 </ul></div><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>value</code> : Mixed<div class="sub-desc">The value to test</div></li><li><code>allowBlank</code> : Boolean<div class="sub-desc">(optional) true to allow empty strings (defaults to false)</div></li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isFunction"></a><b><a href="source/Ext.html#method-Ext-isFunction">isFunction</a></b>( <code>Mixed value</code> )
221 Boolean<div class="mdesc"><div class="short">Returns true if the passed value is a JavaScript Function, otherwise false.</div><div class="long">Returns true if the passed value is a JavaScript Function, otherwise false.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>value</code> : Mixed<div class="sub-desc">The value to test</div></li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isNumber"></a><b><a href="source/Ext.html#method-Ext-isNumber">isNumber</a></b>( <code>Mixed value</code> )
223 Boolean<div class="mdesc"><div class="short">Returns true if the passed value is a number. Returns false for non-finite numbers.</div><div class="long">Returns true if the passed value is a number. Returns false for non-finite numbers.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>value</code> : Mixed<div class="sub-desc">The value to test</div></li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isObject"></a><b><a href="source/Ext.html#method-Ext-isObject">isObject</a></b>( <code>Mixed value</code> )
225 Boolean<div class="mdesc"><div class="short">Returns true if the passed value is a JavaScript Object, otherwise false.</div><div class="long">Returns true if the passed value is a JavaScript Object, otherwise false.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>value</code> : Mixed<div class="sub-desc">The value to test</div></li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isPrimitive"></a><b><a href="source/Ext.html#method-Ext-isPrimitive">isPrimitive</a></b>( <code>Mixed value</code> )
227 Boolean<div class="mdesc"><div class="short">Returns true if the passed value is a JavaScript 'primitive', a string, number or boolean.</div><div class="long">Returns true if the passed value is a JavaScript 'primitive', a string, number or boolean.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>value</code> : Mixed<div class="sub-desc">The value to test</div></li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-isString"></a><b><a href="source/Ext.html#method-Ext-isString">isString</a></b>( <code>Mixed value</code> )
229 Boolean<div class="mdesc"><div class="short">Returns true if the passed value is a string.</div><div class="long">Returns true if the passed value is a string.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>value</code> : Mixed<div class="sub-desc">The value to test</div></li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-iterate"></a><b><a href="source/Ext.html#method-Ext-iterate">iterate</a></b>( <code>Object/Array object</code>, <code>Function fn</code>, <code>Object scope</code> )
231 void<div class="mdesc"><div class="short">Iterates either the elements in an array, or each of the properties in an object.
232 Note: If you are only iterating arr...</div><div class="long">Iterates either the elements in an array, or each of the properties in an object.
233 <b>Note</b>: If you are only iterating arrays, it is better to call <a href="output/Ext.html#Ext-each" ext:member="each" ext:cls="Ext">each</a>.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>object</code> : Object/Array<div class="sub-desc">The object or array to be iterated</div></li><li><code>fn</code> : Function<div class="sub-desc">The function to be called for each iteration.
234 The iteration will stop if the supplied function returns false, or
235 all array elements / object properties have been covered. The signature
236 varies depending on the type of object being interated:
237 <div class="mdetail-params"><ul>
238 <li>Arrays : <tt>(Object item, Number index, Array allItems)</tt>
239 <div class="sub-desc">
240 When iterating an array, the supplied function is called with each item.</div></li>
241 <li>Objects : <tt>(String key, Object value, Object)</tt>
242 <div class="sub-desc">
243 When iterating an object, the supplied function is called with each key-value pair in
244 the object, and the iterated object</div></li>
245 </ul></div></div></li><li><code>scope</code> : Object<div class="sub-desc">The scope (<code>this</code> reference) in which the specified function is executed. Defaults to
246 the <code>object</code> being iterated.</div></li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-max"></a><b><a href="source/Ext-more.html#method-Ext-max">max</a></b>( <code>Array|NodeList arr</code>, <span title="Optional" class="optional">[<code>Function comp</code>]</span> )
248 Object<div class="mdesc"><div class="short">Returns the maximum value in the Array</div><div class="long">Returns the maximum value in the Array<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>arr</code> : Array|NodeList<div class="sub-desc">The Array from which to select the maximum value.</div></li><li><code>comp</code> : Function<div class="sub-desc">(optional) a function to perform the comparision which determines maximization.
249 If omitted the ">" operator will be used. Note: gt = 1; eq = 0; lt = -1</div></li></ul><strong>Returns:</strong><ul><li><code>Object</code><div class="sub-desc">The maximum value in the Array.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-mean"></a><b><a href="source/Ext-more.html#method-Ext-mean">mean</a></b>( <code>Array arr</code> )
251 Number<div class="mdesc"><div class="short">Calculates the mean of the Array</div><div class="long">Calculates the mean of the Array<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>arr</code> : Array<div class="sub-desc">The Array to calculate the mean value of.</div></li></ul><strong>Returns:</strong><ul><li><code>Number</code><div class="sub-desc">The mean.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-min"></a><b><a href="source/Ext-more.html#method-Ext-min">min</a></b>( <code>Array|NodeList arr</code>, <span title="Optional" class="optional">[<code>Function comp</code>]</span> )
253 Object<div class="mdesc"><div class="short">Returns the minimum value in the Array.</div><div class="long">Returns the minimum value in the Array.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>arr</code> : Array|NodeList<div class="sub-desc">The Array from which to select the minimum value.</div></li><li><code>comp</code> : Function<div class="sub-desc">(optional) a function to perform the comparision which determines minimization.
254 If omitted the "<" operator will be used. Note: gt = 1; eq = 0; lt = -1</div></li></ul><strong>Returns:</strong><ul><li><code>Object</code><div class="sub-desc">The minimum value in the Array.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-namespace"></a><b><a href="source/Ext.html#method-Ext-namespace">namespace</a></b>( <code>String namespace1</code>, <code>String namespace2</code>, <code>String etc</code> )
256 Object<div class="mdesc"><div class="short">Creates namespaces to be used for scoping variables and classes so that they are not global.
257 Specifying the last node...</div><div class="long">Creates namespaces to be used for scoping variables and classes so that they are not global.
258 Specifying the last node of a namespace implicitly creates all other nodes. Usage:
259 <pre><code>Ext.namespace(<em>'Company'</em>, <em>'Company.data'</em>);
260 Ext.namespace(<em>'Company.data'</em>); <i>// equivalent and preferable to above syntax</i>
261 Company.Widget = <b>function</b>() { ... }
262 Company.data.CustomStore = <b>function</b>(config) { ... }</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>namespace1</code> : String<div class="sub-desc"></div></li><li><code>namespace2</code> : String<div class="sub-desc"></div></li><li><code>etc</code> : String<div class="sub-desc"></div></li></ul><strong>Returns:</strong><ul><li><code>Object</code><div class="sub-desc">The namespace object. (If multiple arguments are passed, this will be the last namespace created)</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-ns"></a><b><a href="source/Ext.html#method-Ext-ns">ns</a></b>( <code>String namespace1</code>, <code>String namespace2</code>, <code>String etc</code> )
264 Object<div class="mdesc"><div class="short">Creates namespaces to be used for scoping variables and classes so that they are not global.
265 Specifying the last node...</div><div class="long">Creates namespaces to be used for scoping variables and classes so that they are not global.
266 Specifying the last node of a namespace implicitly creates all other nodes. Usage:
267 <pre><code>Ext.namespace(<em>'Company'</em>, <em>'Company.data'</em>);
268 Ext.namespace(<em>'Company.data'</em>); <i>// equivalent and preferable to above syntax</i>
269 Company.Widget = <b>function</b>() { ... }
270 Company.data.CustomStore = <b>function</b>(config) { ... }</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>namespace1</code> : String<div class="sub-desc"></div></li><li><code>namespace2</code> : String<div class="sub-desc"></div></li><li><code>etc</code> : String<div class="sub-desc"></div></li></ul><strong>Returns:</strong><ul><li><code>Object</code><div class="sub-desc">The namespace object. (If multiple arguments are passed, this will be the last namespace created)</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-num"></a><b><a href="source/Ext-more.html#method-Ext-num">num</a></b>( <code>Mixed value</code>, <code>Number defaultValue</code> )
272 Number<div class="mdesc"><div class="short">Utility method for validating that a value is numeric, returning the specified default value if it is not.</div><div class="long">Utility method for validating that a value is numeric, returning the specified default value if it is not.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>value</code> : Mixed<div class="sub-desc">Should be a number, but any type will be handled appropriately</div></li><li><code>defaultValue</code> : Number<div class="sub-desc">The value to return if the original value is non-numeric</div></li></ul><strong>Returns:</strong><ul><li><code>Number</code><div class="sub-desc">Value, if numeric, else defaultValue</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-onReady"></a><b><a href="source/EventManager.html#method-Ext-onReady">onReady</a></b>( <code>Function fn</code>, <span title="Optional" class="optional">[<code>Object scope</code>]</span>, <span title="Optional" class="optional">[<code>boolean options</code>]</span> )
274 void<div class="mdesc"><div class="short">Adds a listener to be notified when the document is ready (before onload and before images are loaded). Shorthand of ...</div><div class="long">Adds a listener to be notified when the document is ready (before onload and before images are loaded). Shorthand of <a href="output/Ext.EventManager.html#Ext.EventManager-onDocumentReady" ext:member="onDocumentReady" ext:cls="Ext.EventManager">Ext.EventManager.onDocumentReady</a>.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>fn</code> : Function<div class="sub-desc">The method the event invokes.</div></li><li><code>scope</code> : Object<div class="sub-desc">(optional) The scope (<code>this</code> reference) in which the handler function executes. Defaults to the browser window.</div></li><li><code>options</code> : boolean<div class="sub-desc">(optional) Options object as passed to <a href="output/Ext.Element.html#Ext.Element-addListener" ext:member="addListener" ext:cls="Ext.Element">Ext.Element.addListener</a>. It is recommended that the options
275 <code>{single: true}</code> be used so that the handler is removed on first invocation.</div></li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-override"></a><b><a href="source/Ext.html#method-Ext-override">override</a></b>( <code>Object origclass</code>, <code>Object overrides</code> )
277 void<div class="mdesc"><div class="short">Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name.
278 ...</div><div class="long">Adds a list of functions to the prototype of an existing class, overwriting any existing methods with the same name.
279 Usage:<pre><code>Ext.override(MyClass, {
280 newMethod1: <b>function</b>(){
283 newMethod2: <b>function</b>(foo){
286 });</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>origclass</code> : Object<div class="sub-desc">The class to override</div></li><li><code>overrides</code> : Object<div class="sub-desc">The list of functions to add to origClass. This should be specified as an object literal
287 containing one or more methods.</div></li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-partition"></a><b><a href="source/Ext-more.html#method-Ext-partition">partition</a></b>( <code>Array|NodeList arr</code>, <span title="Optional" class="optional">[<code>Function truth</code>]</span> )
289 Array<div class="mdesc"><div class="short">Partitions the set into two sets: a true set and a false set.
293 Ext.partition([true, f...</div><div class="long">Partitions the set into two sets: a true set and a false set.
296 <pre><code><i>// Example 1:</i>
297 Ext.partition([true, false, true, true, false]); <i>// [[true, true, true], [false, false]]</i>
301 Ext.query(<em>"p"</em>),
302 <b>function</b>(val){
303 <b>return</b> val.className == <em>"class1"</em>
306 <i>// true are those paragraph elements <b>with</b> a className of <em>"class1"</em>,</i>
307 <i>// false set are those that <b>do</b> not have that className.</i></code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>arr</code> : Array|NodeList<div class="sub-desc">The array to partition</div></li><li><code>truth</code> : Function<div class="sub-desc">(optional) a function to determine truth. If this is omitted the element
308 itself must be able to be evaluated for its truthfulness.</div></li></ul><strong>Returns:</strong><ul><li><code>Array</code><div class="sub-desc">[true<Array>,false<Array>]</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-pluck"></a><b><a href="source/Ext-more.html#method-Ext-pluck">pluck</a></b>( <code>Array|NodeList arr</code>, <code>String prop</code> )
310 Array<div class="mdesc"><div class="short">Plucks the value of a property from each item in the Array
312 Ext.pluck(Ext.query("p"), "className"); // [el...</div><div class="long">Plucks the value of a property from each item in the Array
313 <pre><code><i>// Example:</i>
314 Ext.pluck(Ext.query(<em>"p"</em>), <em>"className"</em>); <i>// [el1.className, el2.className, ..., elN.className]</i></code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>arr</code> : Array|NodeList<div class="sub-desc">The Array of items to pluck the value from.</div></li><li><code>prop</code> : String<div class="sub-desc">The property name to pluck from each element.</div></li></ul><strong>Returns:</strong><ul><li><code>Array</code><div class="sub-desc">The value from each item in the Array.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-preg"></a><b><a href="source/ComponentMgr.html#method-Ext-preg">preg</a></b>( <code>String ptype</code>, <code>Constructor cls</code> )
316 void<div class="mdesc"><div class="short">Shorthand for Ext.ComponentMgr.registerPlugin</div><div class="long">Shorthand for <a href="output/Ext.ComponentMgr.html#Ext.ComponentMgr-registerPlugin" ext:member="registerPlugin" ext:cls="Ext.ComponentMgr">Ext.ComponentMgr.registerPlugin</a><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>ptype</code> : String<div class="sub-desc">The <a href="output/Ext.component.html#Ext.component-ptype" ext:member="ptype" ext:cls="Ext.component">mnemonic string</a> by which the Plugin class
317 may be looked up.</div></li><li><code>cls</code> : Constructor<div class="sub-desc">The new Plugin class.</div></li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-query"></a><b><a href="source/DomQuery.html#method-Ext-query">query</a></b>( <code>String path</code>, <span title="Optional" class="optional">[<code>Node root</code>]</span> )
319 Array<div class="mdesc"><div class="short">Selects an array of DOM nodes by CSS/XPath selector. Shorthand of Ext.DomQuery.select</div><div class="long">Selects an array of DOM nodes by CSS/XPath selector. Shorthand of <a href="output/Ext.DomQuery.html#Ext.DomQuery-select" ext:member="select" ext:cls="Ext.DomQuery">Ext.DomQuery.select</a><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>path</code> : String<div class="sub-desc">The selector/xpath query</div></li><li><code>root</code> : Node<div class="sub-desc">(optional) The start of the query (defaults to document).</div></li></ul><strong>Returns:</strong><ul><li><code>Array</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-reg"></a><b><a href="source/ComponentMgr.html#method-Ext-reg">reg</a></b>( <code>String xtype</code>, <code>Constructor cls</code> )
321 void<div class="mdesc"><div class="short">Shorthand for Ext.ComponentMgr.registerType</div><div class="long">Shorthand for <a href="output/Ext.ComponentMgr.html#Ext.ComponentMgr-registerType" ext:member="registerType" ext:cls="Ext.ComponentMgr">Ext.ComponentMgr.registerType</a><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>xtype</code> : String<div class="sub-desc">The <a href="output/Ext.component.html#Ext.component-xtype" ext:member="xtype" ext:cls="Ext.component">mnemonic string</a> by which the Component class
322 may be looked up.</div></li><li><code>cls</code> : Constructor<div class="sub-desc">The new Component class.</div></li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-removeNode"></a><b><a href="source/Ext.html#method-Ext-removeNode">removeNode</a></b>( <code>HTMLElement node</code> )
324 void<div class="mdesc"><div class="short">Removes this element from the document, removes all DOM event listeners, and deletes the cache reference.
325 All DOM eve...</div><div class="long"><p>Removes this element from the document, removes all DOM event listeners, and deletes the cache reference.
326 All DOM event listeners are removed from this element. If <a href="output/Ext.html#Ext-enableNestedListenerRemoval" ext:member="enableNestedListenerRemoval" ext:cls="Ext">Ext.enableNestedListenerRemoval</a> is
327 <code>true</code>, then DOM event listeners are also removed from all child nodes. The body node
328 will be ignored if passed in.</p><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>node</code> : HTMLElement<div class="sub-desc">The node to remove</div></li></ul><strong>Returns:</strong><ul><li>void</li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-select"></a><b><a href="source/CompositeElement.html#method-Ext-select">select</a></b>( <code>String/Array selector</code>, <span title="Optional" class="optional">[<code>Boolean unique</code>]</span>, <span title="Optional" class="optional">[<code>HTMLElement/String root</code>]</span> )
330 CompositeElementLite/CompositeElement<div class="mdesc"><div class="short">Selects elements based on the passed CSS selector to enable Element methods
331 to be applied to many related elements in...</div><div class="long">Selects elements based on the passed CSS selector to enable <a href="output/Ext.Element.html" ext:cls="Ext.Element">Element</a> methods
332 to be applied to many related elements in one statement through the returned <a href="output/Ext.CompositeElement.html" ext:cls="Ext.CompositeElement">CompositeElement</a> or
333 <a href="output/Ext.CompositeElementLite.html" ext:cls="Ext.CompositeElementLite">CompositeElementLite</a> object.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>selector</code> : String/Array<div class="sub-desc">The CSS selector or an array of elements</div></li><li><code>unique</code> : Boolean<div class="sub-desc">(optional) true to create a unique Ext.Element for each element (defaults to a shared flyweight object)</div></li><li><code>root</code> : HTMLElement/String<div class="sub-desc">(optional) The root element of the query or id of the root</div></li></ul><strong>Returns:</strong><ul><li><code>CompositeElementLite/CompositeElement</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-sum"></a><b><a href="source/Ext-more.html#method-Ext-sum">sum</a></b>( <code>Array arr</code> )
335 Number<div class="mdesc"><div class="short">Calculates the sum of the Array</div><div class="long">Calculates the sum of the Array<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>arr</code> : Array<div class="sub-desc">The Array to calculate the sum value of.</div></li></ul><strong>Returns:</strong><ul><li><code>Number</code><div class="sub-desc">The sum.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-toArray"></a><b><a href="source/Ext.html#method-Ext-toArray">toArray</a></b>( <code>Iterable the</code> )
337 (Array)<div class="mdesc"><div class="short">Converts any iterable (numeric indices and a length property) into a true array
338 Don't use this on strings. IE doesn't...</div><div class="long">Converts any iterable (numeric indices and a length property) into a true array
339 Don't use this on strings. IE doesn't support "abc"[0] which this implementation depends on.
340 For strings, use this instead: "abc".match(/./g) => [a,b,c];<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>the</code> : Iterable<div class="sub-desc">iterable object to be turned into a true Array.</div></li></ul><strong>Returns:</strong><ul><li><code>(Array)</code><div class="sub-desc">array</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-type"></a><b><a href="source/Ext-more.html#method-Ext-type">type</a></b>( <code>Mixed object</code> )
342 String<div class="mdesc"><div class="short">Returns the type of object that is passed in. If the object passed in is null or undefined it
343 return false otherwise ...</div><div class="long">Returns the type of object that is passed in. If the object passed in is null or undefined it
344 return false otherwise it returns one of the following values:<div class="mdetail-params"><ul>
345 <li><b>string</b>: If the object passed is a string</li>
346 <li><b>number</b>: If the object passed is a number</li>
347 <li><b>boolean</b>: If the object passed is a boolean value</li>
348 <li><b>date</b>: If the object passed is a Date object</li>
349 <li><b>function</b>: If the object passed is a function reference</li>
350 <li><b>object</b>: If the object passed is an object</li>
351 <li><b>array</b>: If the object passed is an array</li>
352 <li><b>regexp</b>: If the object passed is a regular expression</li>
353 <li><b>element</b>: If the object passed is a DOM Element</li>
354 <li><b>nodelist</b>: If the object passed is a DOM NodeList</li>
355 <li><b>textnode</b>: If the object passed is a DOM text node and contains something other than whitespace</li>
356 <li><b>whitespace</b>: If the object passed is a DOM text node and contains only whitespace</li>
357 </ul></div><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>object</code> : Mixed<div class="sub-desc"></div></li></ul><strong>Returns:</strong><ul><li><code>String</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-unique"></a><b><a href="source/Ext-more.html#method-Ext-unique">unique</a></b>( <code>Array arr</code> )
359 Array<div class="mdesc"><div class="short">Creates a copy of the passed Array, filtered to contain only unique values.</div><div class="long">Creates a copy of the passed Array, filtered to contain only unique values.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>arr</code> : Array<div class="sub-desc">The Array to filter</div></li></ul><strong>Returns:</strong><ul><li><code>Array</code><div class="sub-desc">The new Array containing unique values.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-urlAppend"></a><b><a href="source/Ext.html#method-Ext-urlAppend">urlAppend</a></b>( <code>String url</code>, <code>String s</code> )
361 (String)<div class="mdesc"><div class="short">Appends content to the query string of a URL, handling logic for whether to place
362 a question mark or ampersand.</div><div class="long">Appends content to the query string of a URL, handling logic for whether to place
363 a question mark or ampersand.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>url</code> : String<div class="sub-desc">The URL to append to.</div></li><li><code>s</code> : String<div class="sub-desc">The content to append to the URL.</div></li></ul><strong>Returns:</strong><ul><li><code>(String)</code><div class="sub-desc">The resulting URL</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-urlDecode"></a><b><a href="source/Ext.html#method-Ext-urlDecode">urlDecode</a></b>( <code>String string</code>, <span title="Optional" class="optional">[<code>Boolean overwrite</code>]</span> )
365 Object<div class="mdesc"><div class="short">Takes an encoded URL and and converts it to an object. Example: Ext.urlDecode("foo=1&bar=2"); // returns {foo: "1", b...</div><div class="long">Takes an encoded URL and and converts it to an object. Example: <pre><code>Ext.urlDecode(<em>"foo=1&bar=2"</em>); <i>// returns {foo: <em>"1"</em>, bar: <em>"2"</em>}</i>
366 Ext.urlDecode(<em>"foo=1&bar=2&bar=3&bar=4"</em>, false); <i>// returns {foo: <em>"1"</em>, bar: [<em>"2"</em>, <em>"3"</em>, <em>"4"</em>]}</i></code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>string</code> : String<div class="sub-desc"></div></li><li><code>overwrite</code> : Boolean<div class="sub-desc">(optional) Items of the same name will overwrite previous values instead of creating an an array (Defaults to false).</div></li></ul><strong>Returns:</strong><ul><li><code>Object</code><div class="sub-desc">A literal with members</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-urlEncode"></a><b><a href="source/Ext.html#method-Ext-urlEncode">urlEncode</a></b>( <code>Object o</code>, <span title="Optional" class="optional">[<code>String pre</code>]</span> )
368 String<div class="mdesc"><div class="short">Takes an object and converts it to an encoded URL. e.g. Ext.urlEncode({foo: 1, bar: 2}); would return "foo=1&bar=2". ...</div><div class="long">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.<div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>o</code> : Object<div class="sub-desc"></div></li><li><code>pre</code> : String<div class="sub-desc">(optional) A prefix to add to the url encoded string</div></li></ul><strong>Returns:</strong><ul><li><code>String</code><div class="sub-desc"></div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-value"></a><b><a href="source/Ext-more.html#method-Ext-value">value</a></b>( <code>Mixed value</code>, <code>Mixed defaultValue</code>, <span title="Optional" class="optional">[<code>Boolean allowBlank</code>]</span> )
370 Mixed<div class="mdesc"><div class="short">Utility method for returning a default value if the passed value is empty.
371 The value is deemed to be empty if it is<d...</div><div class="long"><p>Utility method for returning a default value if the passed value is empty.</p>
372 <p>The value is deemed to be empty if it is<div class="mdetail-params"><ul>
375 <li>an empty array</li>
376 <li>a zero length string (Unless the <tt>allowBlank</tt> parameter is <tt>true</tt>)</li>
377 </ul></div><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>value</code> : Mixed<div class="sub-desc">The value to test</div></li><li><code>defaultValue</code> : Mixed<div class="sub-desc">The value to return if the original value is empty</div></li><li><code>allowBlank</code> : Boolean<div class="sub-desc">(optional) true to allow zero length strings to qualify as non-empty (defaults to false)</div></li></ul><strong>Returns:</strong><ul><li><code>Mixed</code><div class="sub-desc">value, if non-empty, else defaultValue</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi"> </a></td><td class="sig"><a id="Ext-zip"></a><b><a href="source/Ext-more.html#method-Ext-zip">zip</a></b>( <code>Arrays|NodeLists arr</code>, <span title="Optional" class="optional">[<code>Function zipper</code>]</span> )
379 Array<div class="mdesc"><div class="short">Zips N sets together.
381 Ext.zip([1,2,3],[4,5,6]); // [[1,4],[2,5],[3,6]]
384 [ "+"...</div><div class="long"><p>Zips N sets together.</p>
385 <pre><code><i>// Example 1:</i>
386 Ext.zip([1,2,3],[4,5,6]); <i>// [[1,4],[2,5],[3,6]]</i>
389 [ <em>"+"</em>, <em>"-"</em>, <em>"+"</em>],
392 <b>function</b>(a, b, c){
393 <b>return</b> <em>"$"</em> + a + <em>""</em> + b + <em>"."</em> + c
395 ); <i>// [<em>"$+12.43"</em>, <em>"$-10.15"</em>, <em>"$+22.96"</em>]</i></code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>arr</code> : Arrays|NodeLists<div class="sub-desc">This argument may be repeated. Array(s) to contribute values.</div></li><li><code>zipper</code> : Function<div class="sub-desc">(optional) The last item in the argument list. This will drive how the items are zipped together.</div></li></ul><strong>Returns:</strong><ul><li><code>Array</code><div class="sub-desc">The zipped set.</div></li></ul></div></div></div></td><td class="msource">Ext</td></tr></tbody></table><a id="Ext-events"></a><h2>Public Events</h2><div class="no-members">This class has no public events.</div></div>
git.ithinksw.org / extjs.git / blob