Upgrade to ExtJS 3.1.0 - Released 12/16/2009
[extjs.git] / docs / output / Ext.Fx.html
index ecd6df7..25f52f2 100644 (file)
@@ -1,32 +1,19 @@
-        <div class="body-wrap">
-        <div class="top-tools">
-            <a class="inner-link" href="#Ext.Fx-props"><img src="../resources/images/default/s.gif" class="item-icon icon-prop">Properties</a>
-            <a class="inner-link" href="#Ext.Fx-methods"><img src="../resources/images/default/s.gif" class="item-icon icon-method">Methods</a>
-            <a class="inner-link" href="#Ext.Fx-events"><img src="../resources/images/default/s.gif" class="item-icon icon-event">Events</a>
-                            <a class="inner-link" href="#Ext.Fx-configs"><img src="../resources/images/default/s.gif" class="item-icon icon-config">Config Options</a>
-                        <a class="bookmark" href="../docs/?class=Ext.Fx"><img src="../resources/images/default/s.gif" class="item-icon icon-fav">Direct Link</a>
-        </div>
-                <h1>Class Ext.Fx</h1>
-        <table cellspacing="0">
-            <tr><td class="label">Package:</td><td class="hd-info">Ext</td></tr>
-            <tr><td class="label">Defined In:</td><td class="hd-info"><a href="../src/Fx.js" target="_blank">Fx.js</a></td></tr>
-            <tr><td class="label">Class:</td><td class="hd-info">Fx</td></tr>
-                                    <tr><td class="label">Extends:</td><td class="hd-info">Object</td></tr>
-                    </table>
-        <div class="description">
-            <p>A class to provide basic animation and visual effects support.  <b>Note:</b> This class is automatically applied
-to the <a ext:cls="Ext.Element" href="output/Ext.Element.html">Ext.Element</a> interface when included, so all effects calls should be performed via Element.
-Conversely, since the effects are not actually defined in Element, Ext.Fx <b>must</b> be included in order for the 
-Element effects to work.</p><br/>
-<p>It is important to note that although the Fx methods and many non-Fx Element methods support "method chaining" in that
-they return the Element object itself as the method return value, it is not always possible to mix the two in a single
-method chain.  The Fx methods use an internal effects queue so that each effect can be properly timed and sequenced.
-Non-Fx methods, on the other hand, have no such internal queueing and will always execute immediately.  For this reason,
-while it may be possible to mix certain Fx and non-Fx method calls in a single chain, it may not always provide the
-expected results and should be done with care.</p><br/>
-<p>Motion effects support 8-way anchoring, meaning that you can choose one of 8 different anchor points on the Element
+<div xmlns:ext="http://www.extjs.com" class="body-wrap"><h1>Class <a href="source/Fx.html#cls-Ext.Fx">Ext.Fx</a></h1><table cellspacing="0"><tr><td class="label">Package:</td><td class="hd-info">Ext</td></tr><tr><td class="label">Defined In:</td><td class="hd-info">Fx.js</td></tr><tr><td class="label">Class:</td><td class="hd-info"><a href="source/Fx.html#cls-Ext.Fx">Fx</a></td></tr><tr><td class="label">Extends:</td><td class="hd-info">Object</td></tr></table><div class="description"><p>A class to provide basic animation and visual effects support.  <b>Note:</b> This class is automatically applied\r
+to the <a href="output/Ext.Element.html" ext:cls="Ext.Element">Ext.Element</a> interface when included, so all effects calls should be performed via <a href="output/Ext.Element.html" ext:cls="Ext.Element">Ext.Element</a>.\r
+Conversely, since the effects are not actually defined in <a href="output/Ext.Element.html" ext:cls="Ext.Element">Ext.Element</a>, Ext.Fx <b>must</b> be\r
+<a href="output/Ext.html#Ext-enableFx" ext:member="enableFx" ext:cls="Ext">included</a> in order for the Element effects to work.</p><br/>\r
+<p><b><u>Method Chaining</u></b></p>\r
+<p>It is important to note that although the Fx methods and many non-Fx Element methods support "method chaining" in that\r
+they return the Element object itself as the method return value, it is not always possible to mix the two in a single\r
+method chain.  The Fx methods use an internal effects queue so that each effect can be properly timed and sequenced.\r
+Non-Fx methods, on the other hand, have no such internal queueing and will always execute immediately.  For this reason,\r
+while it may be possible to mix certain Fx and non-Fx method calls in a single chain, it may not always provide the\r
+expected results and should be done with care.  Also see <tt><a href="output/Ext.Fx.html#Ext.Fx-callback" ext:member="callback" ext:cls="Ext.Fx">callback</a></tt>.</p><br/>\r
+<p><b><u>Anchor Options for Motion Effects</u></b></p>\r
+<p>Motion effects support 8-way anchoring, meaning that you can choose one of 8 different anchor points on the Element\r
 that will serve as either the start or end point of the animation.  Following are all of the supported anchor positions:</p>\r
-<pre>Value  Description\r
+<pre>\r
+Value  Description\r
 -----  -----------------------------\r
 tl     The top left corner\r
 t      The center of the top edge\r
@@ -35,672 +22,263 @@ l      The center of the left edge
 r      The center of the right edge\r
 bl     The bottom left corner\r
 b      The center of the bottom edge\r
-br     The bottom right corner</pre>
-<b>Although some Fx methods accept specific custom config parameters, the ones shown in the Config Options section
-below are common options that can be passed to any Fx method.</b>        </div>
-        
-        <div class="hr"></div>
-                <a id="Ext.Fx-configs"></a>
-        <h2>Config Options</h2>
-        <table cellspacing="0" class="member-table">
-            <tr>
-                <th class="sig-header" colspan="2">Config Options</th>
-                <th class="msource-header">Defined By</th>
-            </tr>
-                <tr class="config-row">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-afterCls"></a>\r
-            <b>afterCls</b> : String            <div class="mdesc">\r
-                            A css class to apply after the effect                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="config-row alt expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-afterStyle"></a>\r
-            <b>afterStyle</b> : String/Object/Function            <div class="mdesc">\r
-                        <div class="short">A style specification string, e.g. "width:100px", or an object in the form {width:"100px"}, or a function which retur...</div>\r
-            <div class="long">\r
-                A style specification string, e.g. "width:100px", or an object in the form {width:"100px"}, or a function which returns such a specification that will be applied to the Element after the effect finishes            </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="config-row">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-block"></a>\r
-            <b>block</b> : Boolean            <div class="mdesc">\r
-                            Whether the effect should block other effects from queueing while it runs                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="config-row alt expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-callback"></a>\r
-            <b>callback</b> : Function            <div class="mdesc">\r
-                        <div class="short">A function called when the effect is finished. Note that effects are queued internally by the Fx class, so do not nee...</div>\r
-            <div class="long">\r
-                A function called when the effect is finished. Note that effects are queued internally by the Fx class, so do not need to use the callback parameter to specify another effect -- effects can simply be chained together and called in sequence (e.g., el.slideIn().highlight();). The callback is intended for any additional code that should run once a particular effect has completed. The Element being operated upon is passed as the first parameter.            </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="config-row expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-concurrent"></a>\r
-            <b>concurrent</b> : Boolean            <div class="mdesc">\r
-                        <div class="short">Whether to allow subsequently-queued effects to run at the same time as the current effect, or to ensure that they ru...</div>\r
-            <div class="long">\r
-                Whether to allow subsequently-queued effects to run at the same time as the current effect, or to ensure that they run in sequence            </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="config-row alt">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-duration"></a>\r
-            <b>duration</b> : Number            <div class="mdesc">\r
-                            The length of time (in seconds) that the effect should last                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="config-row">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-easing"></a>\r
-            <b>easing</b> : String            <div class="mdesc">\r
-                            A valid Easing value for the effect                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="config-row alt">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-remove"></a>\r
-            <b>remove</b> : Boolean            <div class="mdesc">\r
-                            Whether the Element should be removed from the DOM and destroyed after the effect finishes                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="config-row">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-scope"></a>\r
-            <b>scope</b> : Object            <div class="mdesc">\r
-                            The scope of the effect function                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="config-row alt">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-stopFx"></a>\r
-            <b>stopFx</b> : Boolean            <div class="mdesc">\r
-                            Whether subsequent effects should be stopped and removed after the current effect finishes                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="config-row expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-useDisplay"></a>\r
-            <b>useDisplay</b> : Boolean            <div class="mdesc">\r
-                        <div class="short">Whether to use the display CSS property instead of visibility when hiding Elements (only applies to effects that end ...</div>\r
-            <div class="long">\r
-                Whether to use the <i>display</i> CSS property instead of <i>visibility</i> when hiding Elements (only applies to effects that end with the element being visually hidden, ignored otherwise)            </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-            </table>
-                <a id="Ext.Fx-props"></a>
-        <h2>Public Properties</h2>
-        <div class="no-members">This class has no public properties.</div>        <a id="Ext.Fx-methods"></a>
-        <h2>Public Methods</h2>
-                <table cellspacing="0" class="member-table">
-            <tr>
-                <th class="sig-header" colspan="2">Method</th>
-                <th class="msource-header">Defined By</th>
-            </tr>
-                <tr class="method-row expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-fadeIn"></a>\r
-            <b>fadeIn</b>(&nbsp;<span class="optional" title="Optional">[<code>Object options</code>]</span>&nbsp;) : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Fade an element in (from transparent to opaque).  The ending opacity can be specified
-using the "endOpacity" config o...</div>\r
-            <div class="long">\r
-                Fade an element in (from transparent to opaque).  The ending opacity can be specified
-using the "endOpacity" config option.
+br     The bottom right corner\r
+</pre>\r
+<b>Note</b>: some Fx methods accept specific custom config parameters.  The options shown in the Config Options\r
+section below are common options that can be passed to any Fx method unless otherwise noted.</b></div><div class="hr"></div><a id="Ext.Fx-configs"></a><h2>Config Options</h2><table cellspacing="0" class="member-table"><tbody><tr><th colspan="2" class="sig-header">Config Options</th><th class="msource-header">Defined By</th></tr><tr class="config-row  "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-afterCls"></a><b><a href="source/Fx.html#cfg-Ext.Fx-afterCls">afterCls</a></b> : String<div class="mdesc">A css class to apply after the effect</div></td><td class="msource">Fx</td></tr><tr class="config-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-afterStyle"></a><b><a href="source/Fx.html#cfg-Ext.Fx-afterStyle">afterStyle</a></b> : String/Object/Function<div class="mdesc"><div class="short">A style specification string, e.g. "width:100px", or an object&#13;\r
+in the form {width:"100px"}, or a function which retu...</div><div class="long">A style specification string, e.g. <tt>"width:100px"</tt>, or an object\r
+in the form <tt>{width:"100px"}</tt>, or a function which returns such a specification that will be applied to the\r
+Element after the effect finishes.</div></div></td><td class="msource">Fx</td></tr><tr class="config-row  "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-block"></a><b><a href="source/Fx.html#cfg-Ext.Fx-block">block</a></b> : Boolean<div class="mdesc">Whether the effect should block other effects from queueing while it runs</div></td><td class="msource">Fx</td></tr><tr class="config-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-callback"></a><b><a href="source/Fx.html#cfg-Ext.Fx-callback">callback</a></b> : Function<div class="mdesc"><div class="short">A function called when the effect is finished.  Note that effects are queued internally by the&#13;\r
+Fx class, so a callba...</div><div class="long">A function called when the effect is finished.  Note that effects are queued internally by the\r
+Fx class, so a callback is not required to specify another effect -- effects can simply be chained together\r
+and called in sequence (see note for <b><u>Method Chaining</u></b> above), for example:<pre><code>el.slideIn().highlight();</code></pre>\r
+The callback is intended for any additional code that should run once a particular effect has completed. The Element\r
+being operated upon is passed as the first parameter.</div></div></td><td class="msource">Fx</td></tr><tr class="config-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-concurrent"></a><b><a href="source/Fx.html#cfg-Ext.Fx-concurrent">concurrent</a></b> : Boolean<div class="mdesc"><div class="short">Whether to allow subsequently-queued effects to run at the same time as the current effect, or to ensure that they ru...</div><div class="long">Whether to allow subsequently-queued effects to run at the same time as the current effect, or to ensure that they run in sequence</div></div></td><td class="msource">Fx</td></tr><tr class="config-row  "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-duration"></a><b><a href="source/Fx.html#cfg-Ext.Fx-duration">duration</a></b> : Number<div class="mdesc">The length of time (in seconds) that the effect should last</div></td><td class="msource">Fx</td></tr><tr class="config-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-easing"></a><b><a href="source/Fx.html#cfg-Ext.Fx-easing">easing</a></b> : String<div class="mdesc"><div class="short">A valid Ext.lib.Easing value for the effect:&lt;div class="mdetail-params"&gt;&#13;\r
+backBoth&#13;\r
+backIn&#13;\r
+backOut&#13;\r
+bounceBoth&#13;\r
+boun...</div><div class="long">A valid Ext.lib.Easing value for the effect:</p><div class="mdetail-params"><ul>\r
+<li><b><tt>backBoth</tt></b></li>\r
+<li><b><tt>backIn</tt></b></li>\r
+<li><b><tt>backOut</tt></b></li>\r
+<li><b><tt>bounceBoth</tt></b></li>\r
+<li><b><tt>bounceIn</tt></b></li>\r
+<li><b><tt>bounceOut</tt></b></li>\r
+<li><b><tt>easeBoth</tt></b></li>\r
+<li><b><tt>easeBothStrong</tt></b></li>\r
+<li><b><tt>easeIn</tt></b></li>\r
+<li><b><tt>easeInStrong</tt></b></li>\r
+<li><b><tt>easeNone</tt></b></li>\r
+<li><b><tt>easeOut</tt></b></li>\r
+<li><b><tt>easeOutStrong</tt></b></li>\r
+<li><b><tt>elasticBoth</tt></b></li>\r
+<li><b><tt>elasticIn</tt></b></li>\r
+<li><b><tt>elasticOut</tt></b></li>\r
+</ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="config-row  "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-endOpacity"></a><b><a href="source/Fx.html#cfg-Ext.Fx-endOpacity">endOpacity</a></b> : Number<div class="mdesc">Only applicable for <a href="output/Ext.Fx.html#Ext.Fx-fadeIn" ext:member="fadeIn" ext:cls="Ext.Fx">fadeIn</a> or <a href="output/Ext.Fx.html#Ext.Fx-fadeOut" ext:member="fadeOut" ext:cls="Ext.Fx">fadeOut</a>, a number between\r
+<tt>0</tt> and <tt>1</tt> inclusive to configure the ending opacity value.</div></td><td class="msource">Fx</td></tr><tr class="config-row  "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-remove"></a><b><a href="source/Fx.html#cfg-Ext.Fx-remove">remove</a></b> : Boolean<div class="mdesc">Whether the Element should be removed from the DOM and destroyed after the effect finishes</div></td><td class="msource">Fx</td></tr><tr class="config-row  "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-scope"></a><b><a href="source/Fx.html#cfg-Ext.Fx-scope">scope</a></b> : Object<div class="mdesc">The scope (<code>this</code> reference) in which the <tt><a href="output/Ext.Fx.html#Ext.Fx-callback" ext:member="callback" ext:cls="Ext.Fx">callback</a></tt> function is executed. Defaults to the browser window.</div></td><td class="msource">Fx</td></tr><tr class="config-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-stopFx"></a><b><a href="source/Fx.html#cfg-Ext.Fx-stopFx">stopFx</a></b> : Boolean<div class="mdesc"><div class="short">Whether preceding effects should be stopped and removed before running current effect (only applies to non blocking e...</div><div class="long">Whether preceding effects should be stopped and removed before running current effect (only applies to non blocking effects)</div></div></td><td class="msource">Fx</td></tr><tr class="config-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-useDisplay"></a><b><a href="source/Fx.html#cfg-Ext.Fx-useDisplay">useDisplay</a></b> : Boolean<div class="mdesc"><div class="short">Whether to use the display CSS property instead of visibility when hiding Elements (only applies to &#13;\r
+effects that en...</div><div class="long">Whether to use the <i>display</i> CSS property instead of <i>visibility</i> when hiding Elements (only applies to \r
+effects that end with the element being visually hidden, ignored otherwise)</div></div></td><td class="msource">Fx</td></tr></tbody></table><a id="Ext.Fx-props"></a><h2>Public Properties</h2><div class="no-members">This class has no public properties.</div><a id="Ext.Fx-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">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-fadeIn"></a><b><a href="source/Fx.html#method-Ext.Fx-fadeIn">fadeIn</a></b>(&nbsp;<span title="Optional" class="optional">[<code>Object&nbsp;options</code>]</span>&nbsp;)\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Fade an element in (from transparent to opaque).  The ending opacity can be specified&#13;\r
+using the endOpacity config op...</div><div class="long">Fade an element in (from transparent to opaque).  The ending opacity can be specified\r
+using the <tt><a href="output/Ext.Fx.html#Ext.Fx-endOpacity" ext:member="endOpacity" ext:cls="Ext.Fx">endOpacity</a></tt> config option.\r
 Usage:\r
-<pre><code><i>// <b>default</b>: fade <b>in</b> from opacity 0 to 100%</i>
-el.fadeIn();
-
-<i>// custom: fade <b>in</b> from opacity 0 to 75% over 2 seconds</i>
-el.fadeIn({ endOpacity: .75, duration: 2});
-
-<i>// common config options shown <b>with</b> default values</i>
-el.fadeIn({
-    endOpacity: 1, <i>//can be any value between 0 and 1 (e.g. .5)</i>
-    easing: <em>'easeOut'</em>,
-    duration: .5
-});</code></pre>    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row alt expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-fadeOut"></a>\r
-            <b>fadeOut</b>(&nbsp;<span class="optional" title="Optional">[<code>Object options</code>]</span>&nbsp;) : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Fade an element out (from opaque to transparent).  The ending opacity can be specified
-using the "endOpacity" config ...</div>\r
-            <div class="long">\r
-                Fade an element out (from opaque to transparent).  The ending opacity can be specified
-using the "endOpacity" config option.  Note that IE may require useDisplay:true in order
-to redisplay correctly.
+<pre><code><i>// <b>default</b>: fade <b>in</b> from opacity 0 to 100%\r</i>
+el.fadeIn();\r
+\r
+<i>// custom: fade <b>in</b> from opacity 0 to 75% over 2 seconds\r</i>
+el.fadeIn({ endOpacity: .75, duration: 2});\r
+\r
+<i>// common config options shown <b>with</b> <b>default</b> values\r</i>
+el.fadeIn({\r
+    endOpacity: 1, <i>//can be any value between 0 and 1 (e.g. .5)\r</i>
+    easing: <em>'easeOut'</em>,\r
+    duration: .5\r
+});</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-fadeOut"></a><b><a href="source/Fx.html#method-Ext.Fx-fadeOut">fadeOut</a></b>(&nbsp;<span title="Optional" class="optional">[<code>Object&nbsp;options</code>]</span>&nbsp;)\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Fade an element out (from opaque to transparent).  The ending opacity can be specified&#13;\r
+using the endOpacity config o...</div><div class="long">Fade an element out (from opaque to transparent).  The ending opacity can be specified\r
+using the <tt><a href="output/Ext.Fx.html#Ext.Fx-endOpacity" ext:member="endOpacity" ext:cls="Ext.Fx">endOpacity</a></tt> config option.  Note that IE may require\r
+<tt><a href="output/Ext.Fx.html#Ext.Fx-useDisplay" ext:member="useDisplay" ext:cls="Ext.Fx">useDisplay</a>:true</tt> in order to redisplay correctly.\r
 Usage:\r
-<pre><code><i>// <b>default</b>: fade out from the element's current opacity to 0</i>
-el.fadeOut();
-
-<i>// custom: fade out from the element's current opacity to 25% over 2 seconds</i>
-el.fadeOut({ endOpacity: .25, duration: 2});
-
-<i>// common config options shown <b>with</b> default values</i>
-el.fadeOut({
-    endOpacity: 0, <i>//can be any value between 0 and 1 (e.g. .5)</i>
-    easing: <em>'easeOut'</em>,
-    duration: .5,
-    remove: false,
-    useDisplay: false
-});</code></pre>    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-frame"></a>\r
-            <b>frame</b>(&nbsp;<span class="optional" title="Optional">[<code>String color</code>]</span>, <span class="optional" title="Optional">[<code>Number count</code>]</span>, <span class="optional" title="Optional">[<code>Object options</code>]</span>&nbsp;) : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Shows a ripple of exploding, attenuating borders to draw attention to an Element.
+<pre><code><i>// <b>default</b>: fade out from the element<em>'s current opacity to 0\r</i>
+el.fadeOut();\r
+\r
+<i>// custom: fade out from the element'</em>s current opacity to 25% over 2 seconds\r</i>
+el.fadeOut({ endOpacity: .25, duration: 2});\r
+\r
+<i>// common config options shown <b>with</b> <b>default</b> values\r</i>
+el.fadeOut({\r
+    endOpacity: 0, <i>//can be any value between 0 and 1 (e.g. .5)\r</i>
+    easing: <em>'easeOut'</em>,\r
+    duration: .5,\r
+    remove: false,\r
+    useDisplay: false\r
+});</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-frame"></a><b><a href="source/Fx.html#method-Ext.Fx-frame">frame</a></b>(&nbsp;<span title="Optional" class="optional">[<code>String&nbsp;color</code>]</span>,&nbsp;<span title="Optional" class="optional">[<code>Number&nbsp;count</code>]</span>,&nbsp;<span title="Optional" class="optional">[<code>Object&nbsp;options</code>]</span>&nbsp;)\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Shows a ripple of exploding, attenuating borders to draw attention to an Element.&#13;\r
+Usage:&#13;\r
+// default: a single light...</div><div class="long">Shows a ripple of exploding, attenuating borders to draw attention to an Element.\r
 Usage:\r
-// default: a single light ...</div>\r
-            <div class="long">\r
-                Shows a ripple of exploding, attenuating borders to draw attention to an Element.
+<pre><code><i>// <b>default</b>: a single light blue ripple\r</i>
+el.frame();\r
+\r
+<i>// custom: 3 red ripples lasting 3 seconds total\r</i>
+el.frame(<em>"ff0000"</em>, 3, { duration: 3 });\r
+\r
+<i>// common config options shown <b>with</b> <b>default</b> values\r</i>
+el.frame(<em>"C3DAF9"</em>, 1, {\r
+    duration: 1 <i>//duration of each individual ripple.\r</i>
+    <i>// Note: Easing is not configurable and will be ignored <b>if</b> included\r</i>
+});</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>color</code> : String<div class="sub-desc">(optional) The color of the border.  Should be a 6 char hex color without the leading # (defaults to light blue: 'C3DAF9').</div></li><li><code>count</code> : Number<div class="sub-desc">(optional) The number of ripples to display (defaults to 1)</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-ghost"></a><b><a href="source/Fx.html#method-Ext.Fx-ghost">ghost</a></b>(&nbsp;<span title="Optional" class="optional">[<code>String&nbsp;anchor</code>]</span>,&nbsp;<span title="Optional" class="optional">[<code>Object&nbsp;options</code>]</span>&nbsp;)\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Slides the element while fading it out of view.  An anchor point can be optionally passed to set the &#13;\r
+ending point o...</div><div class="long">Slides the element while fading it out of view.  An anchor point can be optionally passed to set the \r
+ending point of the effect.\r
 Usage:\r
-<pre><code><i>// <b>default</b>: a single light blue ripple</i>
-el.frame();
-
-<i>// custom: 3 red ripples lasting 3 seconds total</i>
-el.frame(<em>"ff0000"</em>, 3, { duration: 3 });
-
-<i>// common config options shown <b>with</b> default values</i>
-el.frame(<em>"C3DAF9"</em>, 1, {
-    duration: 1 <i>//duration of each individual ripple.</i>
-    <i>// Note: Easing is not configurable and will be ignored <b>if</b> included</i>
-});</code></pre>    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li><code>color</code> : String<div class="sub-desc">(optional) The color of the border. Should be a 6 char hex color without the leading # (defaults to light blue: 'C3DAF9').</div></li><li><code>count</code> : Number<div class="sub-desc">(optional) The number of ripples to display (defaults to 1)</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row alt expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-ghost"></a>\r
-            <b>ghost</b>(&nbsp;<span class="optional" title="Optional">[<code>String anchor</code>]</span>, <span class="optional" title="Optional">[<code>Object options</code>]</span>&nbsp;) : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Slides the element while fading it out of view.  An anchor point can be optionally passed to set the 
-ending point of...</div>\r
-            <div class="long">\r
-                Slides the element while fading it out of view.  An anchor point can be optionally passed to set the 
-ending point of the effect.
-Usage:
-<pre><code><i>// <b>default</b>: slide the element downward <b>while</b> fading out</i>
-el.ghost();
-
-<i>// custom: slide the element out to the right <b>with</b> a 2-second duration</i>
-el.ghost(<em>'r'</em>, { duration: 2 });
-
-<i>// common config options shown <b>with</b> default values</i>
-el.ghost(<em>'b'</em>, {
-    easing: <em>'easeOut'</em>,
-    duration: .5,
-    remove: false,
-    useDisplay: false
-});</code></pre>    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li><code>anchor</code> : String<div class="sub-desc">(optional) One of the valid Fx anchor positions (defaults to bottom: 'b')</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-hasActiveFx"></a>\r
-            <b>hasActiveFx</b>() : Boolean            <div class="mdesc">\r
-                        <div class="short">Returns true if the element has any effects actively running or queued, else returns false.</div>\r
-            <div class="long">\r
-                Returns true if the element has any effects actively running or queued, else returns false.    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li>None.</li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Boolean</code><div class="sub-desc">True if element has active effects, else false</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row alt expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-hasFxBlock"></a>\r
-            <b>hasFxBlock</b>() : Boolean            <div class="mdesc">\r
-                        <div class="short">Returns true if the element is currently blocking so that no other effect can be queued
-until this effect is finished...</div>\r
-            <div class="long">\r
-                Returns true if the element is currently blocking so that no other effect can be queued
-until this effect is finished, else returns false if blocking is not set.  This is commonly
-used to ensure that an effect initiated by a user action runs to completion prior to the
-same effect being restarted (e.g., firing only one effect even if the user clicks several times).    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li>None.</li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Boolean</code><div class="sub-desc">True if blocking, else false</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-highlight"></a>\r
-            <b>highlight</b>(&nbsp;<span class="optional" title="Optional">[<code>String color</code>]</span>, <span class="optional" title="Optional">[<code>Object options</code>]</span>&nbsp;) : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Highlights the Element by setting a color (applies to the background-color by default, but can be
-changed using the "...</div>\r
-            <div class="long">\r
-                Highlights the Element by setting a color (applies to the background-color by default, but can be
-changed using the "attr" config option) and then fading back to the original color. If no original
-color is available, you should provide the "endColor" config option which will be cleared after the animation.
+<pre><code><i>// <b>default</b>: slide the element downward <b>while</b> fading out\r</i>
+el.ghost();\r
+\r
+<i>// custom: slide the element out to the right <b>with</b> a 2-second duration\r</i>
+el.ghost(<em>'r'</em>, { duration: 2 });\r
+\r
+<i>// common config options shown <b>with</b> <b>default</b> values\r</i>
+el.ghost(<em>'b'</em>, {\r
+    easing: <em>'easeOut'</em>,\r
+    duration: .5,\r
+    remove: false,\r
+    useDisplay: false\r
+});</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>anchor</code> : String<div class="sub-desc">(optional) One of the valid Fx anchor positions (defaults to bottom: 'b')</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-hasActiveFx"></a><b><a href="source/Fx.html#method-Ext.Fx-hasActiveFx">hasActiveFx</a></b>()\r
+    :\r
+                                        Boolean<div class="mdesc"><div class="short">Returns true if the element has any effects actively running or queued, else returns false.</div><div class="long">Returns true if the element has any effects actively running or queued, else returns false.<div class="mdetail-params"><strong>Parameters:</strong><ul><li>None.</li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc">True if element has active effects, else false</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-hasFxBlock"></a><b><a href="source/Fx.html#method-Ext.Fx-hasFxBlock">hasFxBlock</a></b>()\r
+    :\r
+                                        Boolean<div class="mdesc"><div class="short">Returns true if the element is currently blocking so that no other effect can be queued&#13;\r
+until this effect is finishe...</div><div class="long">Returns true if the element is currently blocking so that no other effect can be queued\r
+until this effect is finished, else returns false if blocking is not set.  This is commonly\r
+used to ensure that an effect initiated by a user action runs to completion prior to the\r
+same effect being restarted (e.g., firing only one effect even if the user clicks several times).<div class="mdetail-params"><strong>Parameters:</strong><ul><li>None.</li></ul><strong>Returns:</strong><ul><li><code>Boolean</code><div class="sub-desc">True if blocking, else false</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-highlight"></a><b><a href="source/Fx.html#method-Ext.Fx-highlight">highlight</a></b>(&nbsp;<span title="Optional" class="optional">[<code>String&nbsp;color</code>]</span>,&nbsp;<span title="Optional" class="optional">[<code>Object&nbsp;options</code>]</span>&nbsp;)\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Highlights the Element by setting a color (applies to the background-color by default, but can be&#13;\r
+changed using the ...</div><div class="long">Highlights the Element by setting a color (applies to the background-color by default, but can be\r
+changed using the "attr" config option) and then fading back to the original color. If no original\r
+color is available, you should provide the "endColor" config option which will be cleared after the animation.\r
 Usage:\r
-<pre><code><i>// <b>default</b>: highlight background to yellow</i>
-el.highlight();
-
-<i>// custom: highlight foreground text to blue <b>for</b> 2 seconds</i>
-el.highlight(<em>"0000ff"</em>, { attr: <em>'color'</em>, duration: 2 });
-
-<i>// common config options shown <b>with</b> default values</i>
-el.highlight(<em>"ffff9c"</em>, {
-    attr: <em>"background-color"</em>, <i>//can be any valid CSS property (attribute) that supports a color value</i>
-    endColor: (current color) or <em>"ffffff"</em>,
-    easing: <em>'easeIn'</em>,
-    duration: 1
-});</code></pre>    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li><code>color</code> : String<div class="sub-desc">(optional) The highlight color. Should be a 6 char hex color without the leading # (defaults to yellow: 'ffff9c')</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row alt expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-pause"></a>\r
-            <b>pause</b>(&nbsp;<code>Number seconds</code>&nbsp;) : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Creates a pause before any subsequent queued effects begin.  If there are
-no effects queued after the pause it will h...</div>\r
-            <div class="long">\r
-                Creates a pause before any subsequent queued effects begin.  If there are
-no effects queued after the pause it will have no effect.
+<pre><code><i>// <b>default</b>: highlight background to yellow\r</i>
+el.highlight();\r
+\r
+<i>// custom: highlight foreground text to blue <b>for</b> 2 seconds\r</i>
+el.highlight(<em>"0000ff"</em>, { attr: <em>'color'</em>, duration: 2 });\r
+\r
+<i>// common config options shown <b>with</b> <b>default</b> values\r</i>
+el.highlight(<em>"ffff9c"</em>, {\r
+    attr: <em>"background-color"</em>, <i>//can be any valid CSS property (attribute) that supports a color value\r</i>
+    endColor: (current color) or <em>"ffffff"</em>,\r
+    easing: <em>'easeIn'</em>,\r
+    duration: 1\r
+});</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>color</code> : String<div class="sub-desc">(optional) The highlight color. Should be a 6 char hex color without the leading # (defaults to yellow: 'ffff9c')</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-pause"></a><b><a href="source/Fx.html#method-Ext.Fx-pause">pause</a></b>(&nbsp;<code>Number&nbsp;seconds</code>&nbsp;)\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Creates a pause before any subsequent queued effects begin.  If there are&#13;\r
+no effects queued after the pause it will ...</div><div class="long">Creates a pause before any subsequent queued effects begin.  If there are\r
+no effects queued after the pause it will have no effect.\r
 Usage:\r
-<pre><code>el.pause(1);</code></pre>    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li><code>seconds</code> : Number<div class="sub-desc">The length of time to pause (in seconds)</div></li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-puff"></a>\r
-            <b>puff</b>(&nbsp;<span class="optional" title="Optional">[<code>Object options</code>]</span>&nbsp;) : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Fades the element out while slowly expanding it in all directions.  When the effect is completed, the 
-element will b...</div>\r
-            <div class="long">\r
-                Fades the element out while slowly expanding it in all directions.  When the effect is completed, the 
-element will be hidden (visibility = 'hidden') but block elements will still take up space in the document. 
-The element must be removed from the DOM using the 'remove' config option if desired.
-Usage:
-<pre><code><i>// <b>default</b></i>
-el.puff();
-
-<i>// common config options shown <b>with</b> default values</i>
-el.puff({
-    easing: <em>'easeOut'</em>,
-    duration: .5,
-    remove: false,
-    useDisplay: false
-});</code></pre>    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row alt expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-scale"></a>\r
-            <b>scale</b>(&nbsp;<code>Number width</code>, <code>Number height</code>, <span class="optional" title="Optional">[<code>Object options</code>]</span>&nbsp;) : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Animates the transition of an element's dimensions from a starting height/width
-to an ending height/width.
+<pre><code>el.pause(1);</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>seconds</code> : Number<div class="sub-desc">The length of time to pause (in seconds)</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-puff"></a><b><a href="source/Fx.html#method-Ext.Fx-puff">puff</a></b>(&nbsp;<span title="Optional" class="optional">[<code>Object&nbsp;options</code>]</span>&nbsp;)\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Fades the element out while slowly expanding it in all directions.  When the effect is completed, the &#13;\r
+element will ...</div><div class="long">Fades the element out while slowly expanding it in all directions.  When the effect is completed, the \r
+element will be hidden (visibility = 'hidden') but block elements will still take up space in the document. \r
+The element must be removed from the DOM using the 'remove' config option if desired.\r
 Usage:\r
-//...</div>\r
-            <div class="long">\r
-                Animates the transition of an element's dimensions from a starting height/width
-to an ending height/width.
+<pre><code><i>// <b>default</b>\r</i>
+el.puff();\r
+\r
+<i>// common config options shown <b>with</b> <b>default</b> values\r</i>
+el.puff({\r
+    easing: <em>'easeOut'</em>,\r
+    duration: .5,\r
+    remove: false,\r
+    useDisplay: false\r
+});</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-scale"></a><b><a href="source/Fx.html#method-Ext.Fx-scale">scale</a></b>(&nbsp;<code>Number&nbsp;width</code>,&nbsp;<code>Number&nbsp;height</code>,&nbsp;<span title="Optional" class="optional">[<code>Object&nbsp;options</code>]</span>&nbsp;)\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Animates the transition of an element's dimensions from a starting height/width&#13;\r
+to an ending height/width.  This met...</div><div class="long">Animates the transition of an element's dimensions from a starting height/width\r
+to an ending height/width.  This method is a convenience implementation of <a href="output/shift.html" ext:cls="shift">shift</a>.\r
 Usage:\r
-<pre><code><i>// change height and width to 100x100 pixels</i>
-el.scale(100, 100);
-
-<i>// common config options shown <b>with</b> default values.  The height and width will <b>default</b> to</i>
-<i>// the element's existing values <b>if</b> passed as null.</i>
-el.scale(
-    [element's width],
-    [element's height], {
-           easing: <em>'easeOut'</em>,
-           duration: .35
-       }
-);</code></pre>    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li><code>width</code> : Number<div class="sub-desc">The new width (pass undefined to keep the original width)</div></li><li><code>height</code> : Number<div class="sub-desc">The new height (pass undefined to keep the original height)</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-sequenceFx"></a>\r
-            <b>sequenceFx</b>() : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Ensures that all effects queued after sequenceFx is called on the element are
-run in sequence.  This is the opposite ...</div>\r
-            <div class="long">\r
-                Ensures that all effects queued after sequenceFx is called on the element are
-run in sequence.  This is the opposite of <a ext:cls="Ext.Fx" ext:member="syncFx" href="output/Ext.Fx.html#syncFx">syncFx</a>.    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li>None.</li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row alt expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-shift"></a>\r
-            <b>shift</b>(&nbsp;<code>Object options</code>&nbsp;) : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Animates the transition of any combination of an element's dimensions, xy position and/or opacity.
-Any of these prope...</div>\r
-            <div class="long">\r
-                Animates the transition of any combination of an element's dimensions, xy position and/or opacity.
-Any of these properties not specified in the config object will not be changed.  This effect 
-requires that at least one new dimension, position or opacity setting must be passed in on
-the config object in order for the function to have any effect.
+<pre><code><i>// change height and width to 100x100 pixels\r</i>
+el.scale(100, 100);\r
+\r
+<i>// common config options shown <b>with</b> <b>default</b> values.  The height and width will <b>default</b> to\r</i>
+<i>// the element&#39;s existing values <b>if</b> passed as null.\r</i>
+el.scale(\r
+    [element&#39;s width],\r
+    [element&#39;s height], {\r
+        easing: <em>'easeOut'</em>,\r
+        duration: .35\r
+    }\r
+);</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>width</code> : Number<div class="sub-desc">The new width (pass undefined to keep the original width)</div></li><li><code>height</code> : Number<div class="sub-desc">The new height (pass undefined to keep the original height)</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-sequenceFx"></a><b><a href="source/Fx.html#method-Ext.Fx-sequenceFx">sequenceFx</a></b>()\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Ensures that all effects queued after sequenceFx is called on the element are&#13;\r
+run in sequence.  This is the opposite...</div><div class="long">Ensures that all effects queued after sequenceFx is called on the element are\r
+run in sequence.  This is the opposite of <a href="output/Ext.Fx.html#Ext.Fx-syncFx" ext:member="syncFx" ext:cls="Ext.Fx">syncFx</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 Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-shift"></a><b><a href="source/Fx.html#method-Ext.Fx-shift">shift</a></b>(&nbsp;<code>Object&nbsp;options</code>&nbsp;)\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Animates the transition of any combination of an element's dimensions, xy position and/or opacity.&#13;\r
+Any of these prop...</div><div class="long">Animates the transition of any combination of an element's dimensions, xy position and/or opacity.\r
+Any of these properties not specified in the config object will not be changed.  This effect \r
+requires that at least one new dimension, position or opacity setting must be passed in on\r
+the config object in order for the function to have any effect.\r
 Usage:\r
-<pre><code><i>// slide the element horizontally to x position 200 <b>while</b> changing the height and opacity</i>
-el.shift({ x: 200, height: 50, opacity: .8 });
-
-<i>// common config options shown <b>with</b> default values.</i>
-el.shift({
-    width: [element's width],
-    height: [element's height],
-    x: [element's x position],
-    y: [element's y position],
-    opacity: [element's opacity],
-    easing: <em>'easeOut'</em>,
-    duration: .35
-});</code></pre>    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li><code>options</code> : Object<div class="sub-desc">Object literal with any of the Fx config options</div></li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-slideIn"></a>\r
-            <b>slideIn</b>(&nbsp;<span class="optional" title="Optional">[<code>String anchor</code>]</span>, <span class="optional" title="Optional">[<code>Object options</code>]</span>&nbsp;) : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Slides the element into view.  An anchor point can be optionally passed to set the point of
-origin for the slide effe...</div>\r
-            <div class="long">\r
-                Slides the element into view.  An anchor point can be optionally passed to set the point of
-origin for the slide effect.  This function automatically handles wrapping the element with
-a fixed-size container if needed.  See the Fx class overview for valid anchor point options.
-Usage:
-<pre><code><i>// <b>default</b>: slide the element <b>in</b> from the top</i>
-el.slideIn();
-
-<i>// custom: slide the element <b>in</b> from the right <b>with</b> a 2-second duration</i>
-el.slideIn(<em>'r'</em>, { duration: 2 });
-
-<i>// common config options shown <b>with</b> default values</i>
-el.slideIn(<em>'t'</em>, {
-    easing: <em>'easeOut'</em>,
-    duration: .5
-});</code></pre>    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li><code>anchor</code> : String<div class="sub-desc">(optional) One of the valid Fx anchor positions (defaults to top: 't')</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row alt expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-slideOut"></a>\r
-            <b>slideOut</b>(&nbsp;<span class="optional" title="Optional">[<code>String anchor</code>]</span>, <span class="optional" title="Optional">[<code>Object options</code>]</span>&nbsp;) : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Slides the element out of view.  An anchor point can be optionally passed to set the end point
-for the slide effect. ...</div>\r
-            <div class="long">\r
-                Slides the element out of view.  An anchor point can be optionally passed to set the end point
-for the slide effect.  When the effect is completed, the element will be hidden (visibility = 
-'hidden') but block elements will still take up space in the document.  The element must be removed
-from the DOM using the 'remove' config option if desired.  This function automatically handles 
-wrapping the element with a fixed-size container if needed.  See the Fx class overview for valid anchor point options.
-Usage:
-<pre><code><i>// <b>default</b>: slide the element out to the top</i>
-el.slideOut();
-
-<i>// custom: slide the element out to the right <b>with</b> a 2-second duration</i>
-el.slideOut(<em>'r'</em>, { duration: 2 });
-
-<i>// common config options shown <b>with</b> default values</i>
-el.slideOut(<em>'t'</em>, {
-    easing: <em>'easeOut'</em>,
-    duration: .5,
-    remove: false,
-    useDisplay: false
-});</code></pre>    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li><code>anchor</code> : String<div class="sub-desc">(optional) One of the valid Fx anchor positions (defaults to top: 't')</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-stopFx"></a>\r
-            <b>stopFx</b>() : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Stops any running effects and clears the element's internal effects queue if it contains
-any additional effects that ...</div>\r
-            <div class="long">\r
-                Stops any running effects and clears the element's internal effects queue if it contains
-any additional effects that haven't started yet.    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li>None.</li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row alt expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-switchOff"></a>\r
-            <b>switchOff</b>(&nbsp;<span class="optional" title="Optional">[<code>Object options</code>]</span>&nbsp;) : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Blinks the element as if it was clicked and then collapses on its center (similar to switching off a television).
-Whe...</div>\r
-            <div class="long">\r
-                Blinks the element as if it was clicked and then collapses on its center (similar to switching off a television).
-When the effect is completed, the element will be hidden (visibility = 'hidden') but block elements will still 
-take up space in the document. The element must be removed from the DOM using the 'remove' config option if desired.
-Usage:
-<pre><code><i>// <b>default</b></i>
-el.switchOff();
-
-<i>// all config options shown <b>with</b> default values</i>
-el.switchOff({
-    easing: <em>'easeIn'</em>,
-    duration: .3,
-    remove: false,
-    useDisplay: false
-});</code></pre>    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-        <tr class="method-row expandable">\r
-        <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>\r
-        <td class="sig">\r
-        <a id="Ext.Fx-syncFx"></a>\r
-            <b>syncFx</b>() : Ext.Element            <div class="mdesc">\r
-                        <div class="short">Ensures that all effects queued after syncFx is called on the element are
-run concurrently.  This is the opposite of ...</div>\r
-            <div class="long">\r
-                Ensures that all effects queued after syncFx is called on the element are
-run concurrently.  This is the opposite of <a ext:cls="Ext.Fx" ext:member="sequenceFx" href="output/Ext.Fx.html#sequenceFx">sequenceFx</a>.    <div class="mdetail-params">\r
-        <strong>Parameters:</strong>\r
-        <ul><li>None.</li>        </ul>\r
-        <strong>Returns:</strong>\r
-        <ul>\r
-            <li><code>Ext.Element</code><div class="sub-desc">The Element</div></li>\r
-        </ul>\r
-    </div>\r
-                </div>\r
-                        </div>\r
-        </td>\r
-        <td class="msource">Fx</td>\r
-    </tr>\r
-            </table>
-                <a id="Ext.Fx-events"></a>
-        <h2>Public Events</h2>
-        <div class="no-members">This class has no public events.</div>
-        </div>
\ No newline at end of file
+<pre><code><i>// slide the element horizontally to x position 200 <b>while</b> changing the height and opacity\r</i>
+el.shift({ x: 200, height: 50, opacity: .8 });\r
+\r
+<i>// common config options shown <b>with</b> <b>default</b> values.\r</i>
+el.shift({\r
+    width: [element&#39;s width],\r
+    height: [element&#39;s height],\r
+    x: [element&#39;s x position],\r
+    y: [element&#39;s y position],\r
+    opacity: [element&#39;s opacity],\r
+    easing: <em>'easeOut'</em>,\r
+    duration: .35\r
+});</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>options</code> : Object<div class="sub-desc">Object literal with any of the Fx config options</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-slideIn"></a><b><a href="source/Fx.html#method-Ext.Fx-slideIn">slideIn</a></b>(&nbsp;<span title="Optional" class="optional">[<code>String&nbsp;anchor</code>]</span>,&nbsp;<span title="Optional" class="optional">[<code>Object&nbsp;options</code>]</span>&nbsp;)\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Slides the element into view.  An anchor point can be optionally passed to set the point of&#13;\r
+origin for the slide eff...</div><div class="long">Slides the element into view.  An anchor point can be optionally passed to set the point of\r
+origin for the slide effect.  This function automatically handles wrapping the element with\r
+a fixed-size container if needed.  See the Fx class overview for valid anchor point options.\r
+Usage:\r
+<pre><code><i>// <b>default</b>: slide the element <b>in</b> from the top\r</i>
+el.slideIn();\r
+\r
+<i>// custom: slide the element <b>in</b> from the right <b>with</b> a 2-second duration\r</i>
+el.slideIn(<em>'r'</em>, { duration: 2 });\r
+\r
+<i>// common config options shown <b>with</b> <b>default</b> values\r</i>
+el.slideIn(<em>'t'</em>, {\r
+    easing: <em>'easeOut'</em>,\r
+    duration: .5\r
+});</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>anchor</code> : String<div class="sub-desc">(optional) One of the valid Fx anchor positions (defaults to top: 't')</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-slideOut"></a><b><a href="source/Fx.html#method-Ext.Fx-slideOut">slideOut</a></b>(&nbsp;<span title="Optional" class="optional">[<code>String&nbsp;anchor</code>]</span>,&nbsp;<span title="Optional" class="optional">[<code>Object&nbsp;options</code>]</span>&nbsp;)\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Slides the element out of view.  An anchor point can be optionally passed to set the end point&#13;\r
+for the slide effect....</div><div class="long">Slides the element out of view.  An anchor point can be optionally passed to set the end point\r
+for the slide effect.  When the effect is completed, the element will be hidden (visibility = \r
+'hidden') but block elements will still take up space in the document.  The element must be removed\r
+from the DOM using the 'remove' config option if desired.  This function automatically handles \r
+wrapping the element with a fixed-size container if needed.  See the Fx class overview for valid anchor point options.\r
+Usage:\r
+<pre><code><i>// <b>default</b>: slide the element out to the top\r</i>
+el.slideOut();\r
+\r
+<i>// custom: slide the element out to the right <b>with</b> a 2-second duration\r</i>
+el.slideOut(<em>'r'</em>, { duration: 2 });\r
+\r
+<i>// common config options shown <b>with</b> <b>default</b> values\r</i>
+el.slideOut(<em>'t'</em>, {\r
+    easing: <em>'easeOut'</em>,\r
+    duration: .5,\r
+    remove: false,\r
+    useDisplay: false\r
+});</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>anchor</code> : String<div class="sub-desc">(optional) One of the valid Fx anchor positions (defaults to top: 't')</div></li><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-stopFx"></a><b><a href="source/Fx.html#method-Ext.Fx-stopFx">stopFx</a></b>()\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Stops any running effects and clears the element's internal effects queue if it contains&#13;\r
+any additional effects that...</div><div class="long">Stops any running effects and clears the element's internal effects queue if it contains\r
+any additional effects that haven't started yet.<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 Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-switchOff"></a><b><a href="source/Fx.html#method-Ext.Fx-switchOff">switchOff</a></b>(&nbsp;<span title="Optional" class="optional">[<code>Object&nbsp;options</code>]</span>&nbsp;)\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Blinks the element as if it was clicked and then collapses on its center (similar to switching off a television).&#13;\r
+Wh...</div><div class="long">Blinks the element as if it was clicked and then collapses on its center (similar to switching off a television).\r
+When the effect is completed, the element will be hidden (visibility = 'hidden') but block elements will still \r
+take up space in the document. The element must be removed from the DOM using the 'remove' config option if desired.\r
+Usage:\r
+<pre><code><i>// <b>default</b>\r</i>
+el.switchOff();\r
+\r
+<i>// all config options shown <b>with</b> <b>default</b> values\r</i>
+el.switchOff({\r
+    easing: <em>'easeIn'</em>,\r
+    duration: .3,\r
+    remove: false,\r
+    useDisplay: false\r
+});</code></pre><div class="mdetail-params"><strong>Parameters:</strong><ul><li><code>options</code> : Object<div class="sub-desc">(optional) Object literal with any of the Fx config options</div></li></ul><strong>Returns:</strong><ul><li><code>Ext.Element</code><div class="sub-desc">The Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr><tr class="method-row expandable "><td class="micon"><a href="#expand" class="exi">&nbsp;</a></td><td class="sig"><a id="Ext.Fx-syncFx"></a><b><a href="source/Fx.html#method-Ext.Fx-syncFx">syncFx</a></b>()\r
+    :\r
+                                        Ext.Element<div class="mdesc"><div class="short">Ensures that all effects queued after syncFx is called on the element are&#13;\r
+run concurrently.  This is the opposite of...</div><div class="long">Ensures that all effects queued after syncFx is called on the element are\r
+run concurrently.  This is the opposite of <a href="output/Ext.Fx.html#Ext.Fx-sequenceFx" ext:member="sequenceFx" ext:cls="Ext.Fx">sequenceFx</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 Element</div></li></ul></div></div></div></td><td class="msource">Fx</td></tr></tbody></table><a id="Ext.Fx-events"></a><h2>Public Events</h2><div class="no-members">This class has no public events.</div></div>
\ No newline at end of file