Upgrade to ExtJS 4.0.0 - Released 04/26/2011
[extjs.git] / docs / api / Ext.form.field.Text.html
1 <!DOCTYPE html><html><head><title>Ext.form.field.Text | Ext JS 4.0 Documentation</title><script type="text/javascript" src="../ext-all.js"></script><link rel="stylesheet" href="../reset.css" type="text/css"><link rel="stylesheet" href="../scrollbars.css" type="text/css"><link rel="stylesheet" href="../docs.css" type="text/css"><link id="styleCss" rel="stylesheet" href="../style.css" type="text/css"><script type="text/javascript" src="../prettify.js"></script><link rel="stylesheet" href="../prettify.css" type="text/css"><!-- link(rel: 'stylesheet', href: req.baseURL + '/css/ext4.css', type: 'text/css')--><link rel="shortcut icon" type="image/ico" href="../favicon.ico"><!--[if IE]>
2 <style type="text/css">.head-band { display: none; }
3 .header { border: 0; top: 0; left: 0px; background: url(../header.gif) repeat-x; }
4 .doc-tab .members .member a.more { background-color: #efefef; }
5 </style><link rel="stylesheet" href="/new/css/ie.css" type="text/css"><![endif]-->
6 </head><body id="ext-body" class="iScroll"><div id="notice" class="notice">For up to date documentation and features, visit 
7 <a href="http://docs.sencha.com/ext-js/4-0">http://docs.sencha.com/ext-js/4-0</a></div><div class="wrapper"><div class="head-band"></div><div class="header"><h2><a href="../index.html">Sencha Documentation</a></h2></div><div id="search"><form><input type="text" placeholder="Search" id="search-field" autocomplete="off" name="q"></form><div id="search-box"></div></div><div id="treePanel"></div><div id="container"><script type="text/javascript">
8
9     req = {
10         liveURL: '.',
11         standAloneMode: true,
12         origDocClass: 'Ext.form.field.Text',
13         docClass: 'Ext.form.field.Text',
14         docReq: 'Ext.form.field.Text',
15         version: '4.0',
16         baseURL: '.',
17         baseDocURL: '.',
18         baseProdURL: '.'
19     };
20
21     clsInfo = {};
22
23
24
25 </script>
26
27 <script type="text/javascript" src="../search.js"></script>
28 <!--script type="text/javascript" src="/new/javascripts/app/examples.js"></script-->
29 <script type="text/javascript" src="../class_tree.js"></script>
30 <script type="text/javascript" src="../class_doc.js"></script>
31 <script type="text/javascript">
32     req.source = 'Text.html#Ext-form.field.Text';
33     clsInfo = {"methods":["Text","addClass","addCls","addClsWithUI","addEvents","addListener","addManagedListener","addStateEvents","afterComponentLayout","alignTo","animate","applyState","autoSize","batchChanges","beforeComponentLayout","bubble","capture","center","checkChange","checkDirty","clearInvalid","clearListeners","clearManagedListeners","cloneConfig","destroy","disable","doAutoRender","doComponentLayout","doConstrain","enable","enableBubble","extractFileInput","findLayoutController","findParentBy","findParentByType","fireEvent","focus","getActiveAnimation","getActiveError","getActiveErrors","getBox","getBubbleTarget","getEl","getErrors","getFieldLabel","getHeight","getId","getInputId","getInsertPosition","getLoader","getModelData","getName","getPlugin","getPosition","getRawValue","getSize","getState","getStateId","getSubmitData","getSubmitValue","getValue","getWidth","getXType","getXTypes","hasActiveError","hasListener","hasUICls","hide","initField","initLabelable","is","isDescendantOf","isDirty","isDisabled","isDraggable","isDroppable","isEqual","isFileUpload","isFloating","isHidden","isValid","isVisible","isXType","markInvalid","nextNode","nextSibling","observe","on","previousNode","previousSibling","processRawValue","rawToValue","relayEvents","releaseCapture","removeCls","removeClsWithUI","removeListener","removeManagedListener","reset","resetOriginalValue","resumeEvents","selectText","sequenceFx","setActive","setActiveError","setActiveErrors","setAutoScroll","setDisabled","setDocked","setFieldDefaults","setFieldStyle","setHeight","setLoading","setPagePosition","setPosition","setRawValue","setReadOnly","setSize","setUI","setValue","setVisible","setWidth","show","stopAnimation","suspendEvents","syncFx","toBack","toFront","un","unsetActiveError","up","update","updateBox","validate","validateValue","valueToRaw"],"cfgs":["activeError","activeErrorsTpl","allowBlank","autoEl","autoFitErrors","autoRender","autoScroll","autoShow","baseBodyCls","baseCls","blankText","border","checkChangeBuffer","checkChangeEvents","clearCls","cls","componentCls","componentLayout","contentEl","data","dirtyCls","disableKeyFilter","disabled","disabledCls","draggable","emptyCls","emptyText","enableKeyEvents","enforceMaxLength","errorMsgCls","fieldBodyCls","fieldCls","fieldLabel","fieldStyle","floating","focusCls","focusOnToFront","formItemCls","frame","grow","growAppend","growMax","growMin","height","hidden","hideEmptyLabel","hideLabel","hideMode","html","id","inputId","inputType","invalidCls","invalidText","itemId","labelAlign","labelCls","labelPad","labelSeparator","labelStyle","labelWidth","labelableRenderTpl","listeners","loader","maintainFlex","margin","maskRe","maxHeight","maxLength","maxLengthText","maxWidth","minHeight","minLength","minLengthText","minWidth","msgTarget","name","overCls","padding","plugins","preventMark","readOnly","readOnlyCls","regex","regexText","renderSelectors","renderTo","renderTpl","resizable","resizeHandles","saveBuffer","selectOnFocus","shadow","size","stateEvents","stateId","stateful","stripCharsRe","style","styleHtmlCls","styleHtmlContent","submitValue","tabIndex","toFrontOnShow","tpl","tplWriteMode","ui","validateOnBlur","validateOnChange","validator","value","vtype","vtypeText","width"],"properties":["bodyEl","clearInvalid","draggable","errorEl","floatParent","frameSize","hasActiveFx","inputEl","isFieldLabelable","isFormField","labelEl","markInvalid","maskOnDisable","originalValue","ownerCt","rendered","stopFx","zIndexManager"],"events":["activate","added","afterrender","autosize","beforeactivate","beforedeactivate","beforedestroy","beforehide","beforerender","beforeshow","beforestaterestore","beforestatesave","blur","change","deactivate","destroy","dirtychange","disable","enable","errorchange","focus","hide","keydown","keypress","keyup","move","removed","render","resize","show","specialkey","staterestore","statesave","validitychange"],"subclasses":["Ext.form.field.File","Ext.form.field.TextArea","Ext.form.field.Trigger"]};
34     Ext.onReady(function() {
35         Ext.create('Docs.classPanel');
36     });
37 </script><div id="top-block" class="top-block"><h1 id="clsTitle" class="comp"><a href="../source/Text.html#Ext-form.field.Text" target="_blank">Ext.form.field.Text</a><span>xtype: textfield</span></h1></div><div id="docContent"><div id="doc-overview-content"><div class="lft"><pre class="subclasses"><h4>Hierarchy</h4><div class="subclass f"><a href="Ext.AbstractComponent.html" rel="Ext.AbstractComponent" class="cls docClass">Ext.AbstractComponent</a><div class="subclass"><a href="Ext.Component.html" rel="Ext.Component" class="cls docClass">Ext.Component</a><div class="subclass"><a href="Ext.form.field.Base.html" rel="Ext.form.field.Base" class="cls docClass">Ext.form.field.Base</a><div class="subclass"><strong>Ext.form.field.Text</strong></div></div></div></div><h4>Mixins</h4><div class="mixin"><a href="Ext.util.Observable.html" rel="Ext.util.Observable" class="cls docClass">Ext.util.Observable</a></div><div class="mixin"><a href="Ext.util.Animate.html" rel="Ext.util.Animate" class="cls docClass">Ext.util.Animate</a></div><div class="mixin"><a href="Ext.state.Stateful.html" rel="Ext.state.Stateful" class="cls docClass">Ext.state.Stateful</a></div><div class="mixin"><a href="Ext.util.Floating.html" rel="Ext.util.Floating" class="cls docClass">Ext.util.Floating</a></div><div class="mixin"><a href="Ext.form.Labelable.html" rel="Ext.form.Labelable" class="cls docClass">Ext.form.Labelable</a></div><div class="mixin"><a href="Ext.form.field.Field.html" rel="Ext.form.field.Field" class="cls docClass">Ext.form.field.Field</a></div></pre><p>A basic text field.  Can be used as a direct replacement for traditional text inputs,
38 or as the base class for more sophisticated input controls (like <a href="Ext.form.field.TextArea.html" rel="Ext.form.field.TextArea" class="docClass">Ext.form.field.TextArea</a>
39 and <a href="Ext.form.field.ComboBox.html" rel="Ext.form.field.ComboBox" class="docClass">Ext.form.field.ComboBox</a>). Has support for empty-field placeholder values (see <a href="Ext.form.field.Text.html#emptyText" rel="Ext.form.field.Text#emptyText" class="docClass">emptyText</a>).</p>
40
41 <h1>Validation</h1>
42
43 <p>The Text field has a useful set of validations built in:</p>
44
45 <ul>
46 <li><a href="Ext.form.field.Text.html#allowBlank" rel="Ext.form.field.Text#allowBlank" class="docClass">allowBlank</a> for making the field required</li>
47 <li><a href="Ext.form.field.Text.html#minLength" rel="Ext.form.field.Text#minLength" class="docClass">minLength</a> for requiring a minimum value length</li>
48 <li><a href="Ext.form.field.Text.html#maxLength" rel="Ext.form.field.Text#maxLength" class="docClass">maxLength</a> for setting a maximum value length (with <a href="Ext.form.field.Text.html#enforceMaxLength" rel="Ext.form.field.Text#enforceMaxLength" class="docClass">enforceMaxLength</a> to add it
49 as the <code>maxlength</code> attribute on the input element)</li>
50 <li><a href="regex.html" rel="regex" class="docClass">regex</a> to specify a custom regular expression for validation</li>
51 </ul>
52
53
54 <p>In addition, custom validations may be added:</p>
55
56 <ul>
57 <li><a href="Ext.form.field.Text.html#vtype" rel="Ext.form.field.Text#vtype" class="docClass">vtype</a> specifies a virtual type implementation from <a href="Ext.form.field.VTypes.html" rel="Ext.form.field.VTypes" class="docClass">Ext.form.field.VTypes</a> which can contain
58 custom validation logic</li>
59 <li><a href="Ext.form.field.Text.html#validator" rel="Ext.form.field.Text#validator" class="docClass">validator</a> allows a custom arbitrary function to be called during validation</li>
60 </ul>
61
62
63 <p>The details around how and when each of these validation options get used are described in the
64 documentation for <a href="Ext.form.field.Text.html#getErrors" rel="Ext.form.field.Text#getErrors" class="docClass">getErrors</a>.</p>
65
66 <p>By default, the field value is checked for validity immediately while the user is typing in the
67 field. This can be controlled with the <a href="Ext.form.field.Text.html#validateOnChange" rel="Ext.form.field.Text#validateOnChange" class="docClass">validateOnChange</a>, <a href="Ext.form.field.Text.html#checkChangeEvents" rel="Ext.form.field.Text#checkChangeEvents" class="docClass">checkChangeEvents</a>, and
68 <a href="Ext.form.field.Text.html#checkChangeBugger" rel="Ext.form.field.Text#checkChangeBugger" class="docClass">checkChangeBugger</a> configurations. Also see the details on Form Validation in the
69 <a href="Ext.form.Panel.html" rel="Ext.form.Panel" class="docClass">Ext.form.Panel</a> class documentation.</p>
70
71 <h1>Masking and Character Stripping</h1>
72
73 <p>Text fields can be configured with custom regular expressions to be applied to entered values before
74 validation: see <a href="Ext.form.field.Text.html#maskRe" rel="Ext.form.field.Text#maskRe" class="docClass">maskRe</a> and <a href="Ext.form.field.Text.html#stripCharsRe" rel="Ext.form.field.Text#stripCharsRe" class="docClass">stripCharsRe</a> for details.
75 <img class="screenshot" src="../Ext.form.Text.png" alt="Ext.form.Text component" /></p>
76
77 <h1>Example usage:</h1>
78
79 <pre class="prettyprint"><code>Ext.create('Ext.form.Panel', {
80     title: 'Contact Info',
81     width: 300,
82     bodyPadding: 10,
83     renderTo: Ext.getBody(),        
84     items: [{
85         xtype: 'textfield',
86         name: 'name',
87         fieldLabel: 'Name',
88         allowBlank: false  // requires a non-empty value
89     }, {
90         xtype: 'textfield',
91         name: 'email',
92         fieldLabel: 'Email Address',
93         vtype: 'email'  // requires value to be a valid email address format
94     }]
95 });
96 </code></pre>
97 <div class="members"><div class="m-cfgs"><div class="definedBy">Defined By</div><a name="configs"></a><h3 class="cfg p">Config Options</h3><h4 class="cfgGroup">CSS Class configs</h4><div id="config-baseBodyCls" class="member f inherited"><a href="Ext.form.field.Text.html#config-baseBodyCls" rel="config-baseBodyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-baseBodyCls" class="viewSource">view source</a></div><a name="baseBodyCls"></a><a name="config-baseBodyCls"></a><a href="Ext.form.field.Text.html#" rel="config-baseBodyCls" class="cls expand">baseBodyCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to be applied to the body content element. Defaults to 'x-form-item-body'.</p>
98 </div><div class="long"><p>The CSS class to be applied to the body content element. Defaults to 'x-form-item-body'.</p>
99 </div></div></div><div id="config-baseCls" class="member inherited"><a href="Ext.form.field.Text.html#config-baseCls" rel="config-baseCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-baseCls" class="viewSource">view source</a></div><a name="baseCls"></a><a name="config-baseCls"></a><a href="Ext.form.field.Text.html#" rel="config-baseCls" class="cls expand">baseCls</a><span> : String</span></div><div class="description"><div class="short">The base CSS class to apply to this components's element. This will also be prepended to
100 elements within this compone...</div><div class="long"><p>The base CSS class to apply to this components's element. This will also be prepended to
101 elements within this component like Panel's body will get a class x-panel-body. This means
102 that if you create a subclass of Panel, and you want it to get all the Panels styling for the
103 element and the body, you leave the baseCls x-panel and use componentCls to add specific styling for this
104 component.</p>
105 </div></div></div><div id="config-clearCls" class="member inherited"><a href="Ext.form.field.Text.html#config-clearCls" rel="config-clearCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-clearCls" class="viewSource">view source</a></div><a name="clearCls"></a><a name="config-clearCls"></a><a href="Ext.form.field.Text.html#" rel="config-clearCls" class="cls expand">clearCls</a><span> : String</span></div><div class="description"><div class="short">The CSS class to be applied to the special clearing div rendered directly after the field
106 contents wrapper to provide...</div><div class="long"><p>The CSS class to be applied to the special clearing div rendered directly after the field
107 contents wrapper to provide field clearing (defaults to <tt>'x-clear'</tt>).</p>
108 </div></div></div><div id="config-cls" class="member inherited"><a href="Ext.form.field.Text.html#config-cls" rel="config-cls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-cls" class="viewSource">view source</a></div><a name="cls"></a><a name="config-cls"></a><a href="Ext.form.field.Text.html#" rel="config-cls" class="cls expand">cls</a><span> : String</span></div><div class="description"><div class="short">An optional extra CSS class that will be added to this component's Element (defaults to '').  This can be
109 useful for ...</div><div class="long"><p>An optional extra CSS class that will be added to this component's Element (defaults to '').  This can be
110 useful for adding customized styles to the component or any of its children using standard CSS rules.</p>
111 </div></div></div><div id="config-componentCls" class="member inherited"><a href="Ext.form.field.Text.html#config-componentCls" rel="config-componentCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-componentCls" class="viewSource">view source</a></div><a name="componentCls"></a><a name="config-componentCls"></a><a href="Ext.form.field.Text.html#" rel="config-componentCls" class="cls expand">componentCls</a><span> : String</span></div><div class="description"><div class="short"><p>CSS Class to be added to a components root level element to give distinction to it
112 via styling.</p>
113 </div><div class="long"><p>CSS Class to be added to a components root level element to give distinction to it
114 via styling.</p>
115 </div></div></div><div id="config-dirtyCls" class="member inherited"><a href="Ext.form.field.Text.html#config-dirtyCls" rel="config-dirtyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-dirtyCls" class="viewSource">view source</a></div><a name="dirtyCls"></a><a name="config-dirtyCls"></a><a href="Ext.form.field.Text.html#" rel="config-dirtyCls" class="cls expand">dirtyCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to use when the field value <a href="Ext.form.field.Text.html#isDirty" rel="Ext.form.field.Text#isDirty" class="docClass">is dirty</a>.</p>
116 </div><div class="long"><p>The CSS class to use when the field value <a href="Ext.form.field.Text.html#isDirty" rel="Ext.form.field.Text#isDirty" class="docClass">is dirty</a>.</p>
117 </div></div></div><div id="config-disabledCls" class="member inherited"><a href="Ext.form.field.Text.html#config-disabledCls" rel="config-disabledCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-disabledCls" class="viewSource">view source</a></div><a name="disabledCls"></a><a name="config-disabledCls"></a><a href="Ext.form.field.Text.html#" rel="config-disabledCls" class="cls expand">disabledCls</a><span> : String</span></div><div class="description"><div class="short"><p>CSS class to add when the Component is disabled. Defaults to 'x-item-disabled'.</p>
118 </div><div class="long"><p>CSS class to add when the Component is disabled. Defaults to 'x-item-disabled'.</p>
119 </div></div></div><div id="config-emptyCls" class="member ni"><a href="Ext.form.field.Text.html#config-emptyCls" rel="config-emptyCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-emptyCls" class="viewSource">view source</a></div><a name="emptyCls"></a><a name="config-emptyCls"></a><a href="Ext.form.field.Text.html#" rel="config-emptyCls" class="cls expand">emptyCls</a><span> : String</span></div><div class="description"><div class="short">The CSS class to apply to an empty field to style the emptyText
120 (defaults to 'x-form-empty-field').  This class is au...</div><div class="long"><p>The CSS class to apply to an empty field to style the <b><tt><a href="Ext.form.field.Text.html#emptyText" rel="Ext.form.field.Text#emptyText" class="docClass">emptyText</a></tt></b>
121 (defaults to <tt>'x-form-empty-field'</tt>).  This class is automatically added and removed as needed
122 depending on the current field value.</p>
123 </div></div></div><div id="config-errorMsgCls" class="member inherited"><a href="Ext.form.field.Text.html#config-errorMsgCls" rel="config-errorMsgCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-errorMsgCls" class="viewSource">view source</a></div><a name="errorMsgCls"></a><a name="config-errorMsgCls"></a><a href="Ext.form.field.Text.html#" rel="config-errorMsgCls" class="cls expand">errorMsgCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to be applied to the error message element. Defaults to 'x-form-error-msg'.</p>
124 </div><div class="long"><p>The CSS class to be applied to the error message element. Defaults to 'x-form-error-msg'.</p>
125 </div></div></div><div id="config-fieldBodyCls" class="member inherited"><a href="Ext.form.field.Text.html#config-fieldBodyCls" rel="config-fieldBodyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-fieldBodyCls" class="viewSource">view source</a></div><a name="fieldBodyCls"></a><a name="config-fieldBodyCls"></a><a href="Ext.form.field.Text.html#" rel="config-fieldBodyCls" class="cls expand">fieldBodyCls</a><span> : String</span></div><div class="description"><div class="short"><p>An extra CSS class to be applied to the body content element in addition to <a href="Ext.form.field.Text.html#fieldBodyCls" rel="Ext.form.field.Text#fieldBodyCls" class="docClass">fieldBodyCls</a>.
126 Defaults to empty.</p>
127 </div><div class="long"><p>An extra CSS class to be applied to the body content element in addition to <a href="Ext.form.field.Text.html#fieldBodyCls" rel="Ext.form.field.Text#fieldBodyCls" class="docClass">fieldBodyCls</a>.
128 Defaults to empty.</p>
129 </div></div></div><div id="config-fieldCls" class="member inherited"><a href="Ext.form.field.Text.html#config-fieldCls" rel="config-fieldCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-fieldCls" class="viewSource">view source</a></div><a name="fieldCls"></a><a name="config-fieldCls"></a><a href="Ext.form.field.Text.html#" rel="config-fieldCls" class="cls expand">fieldCls</a><span> : String</span></div><div class="description"><div class="short"><p>The default CSS class for the field input (defaults to 'x-form-field')</p>
130 </div><div class="long"><p>The default CSS class for the field input (defaults to 'x-form-field')</p>
131 </div></div></div><div id="config-focusCls" class="member inherited"><a href="Ext.form.field.Text.html#config-focusCls" rel="config-focusCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-focusCls" class="viewSource">view source</a></div><a name="focusCls"></a><a name="config-focusCls"></a><a href="Ext.form.field.Text.html#" rel="config-focusCls" class="cls expand">focusCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to use when the field receives focus (defaults to 'x-form-focus')</p>
132 </div><div class="long"><p>The CSS class to use when the field receives focus (defaults to 'x-form-focus')</p>
133 </div></div></div><div id="config-formItemCls" class="member inherited"><a href="Ext.form.field.Text.html#config-formItemCls" rel="config-formItemCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-formItemCls" class="viewSource">view source</a></div><a name="formItemCls"></a><a name="config-formItemCls"></a><a href="Ext.form.field.Text.html#" rel="config-formItemCls" class="cls expand">formItemCls</a><span> : String</span></div><div class="description"><div class="short">A CSS class to be applied to the outermost element to denote that it is participating in the form
134 field layout. Defau...</div><div class="long"><p>A CSS class to be applied to the outermost element to denote that it is participating in the form
135 field layout. Defaults to 'x-form-item'.</p>
136 </div></div></div><div id="config-invalidCls" class="member inherited"><a href="Ext.form.field.Text.html#config-invalidCls" rel="config-invalidCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-invalidCls" class="viewSource">view source</a></div><a name="invalidCls"></a><a name="config-invalidCls"></a><a href="Ext.form.field.Text.html#" rel="config-invalidCls" class="cls expand">invalidCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to use when marking the component invalid (defaults to 'x-form-invalid')</p>
137 </div><div class="long"><p>The CSS class to use when marking the component invalid (defaults to 'x-form-invalid')</p>
138 </div></div></div><div id="config-labelCls" class="member inherited"><a href="Ext.form.field.Text.html#config-labelCls" rel="config-labelCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelCls" class="viewSource">view source</a></div><a name="labelCls"></a><a name="config-labelCls"></a><a href="Ext.form.field.Text.html#" rel="config-labelCls" class="cls expand">labelCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to be applied to the label element. Defaults to 'x-form-item-label'.</p>
139 </div><div class="long"><p>The CSS class to be applied to the label element. Defaults to 'x-form-item-label'.</p>
140 </div></div></div><div id="config-overCls" class="member inherited"><a href="Ext.form.field.Text.html#config-overCls" rel="config-overCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-overCls" class="viewSource">view source</a></div><a name="overCls"></a><a name="config-overCls"></a><a href="Ext.form.field.Text.html#" rel="config-overCls" class="cls expand">overCls</a><span> : String</span></div><div class="description"><div class="short">An optional extra CSS class that will be added to this component's Element when the mouse moves
141 over the Element, and...</div><div class="long"><p>An optional extra CSS class that will be added to this component's Element when the mouse moves
142 over the Element, and removed when the mouse moves out. (defaults to '').  This can be
143 useful for adding customized 'active' or 'hover' styles to the component or any of its children using standard CSS rules.</p>
144 </div></div></div><div id="config-readOnlyCls" class="member inherited"><a href="Ext.form.field.Text.html#config-readOnlyCls" rel="config-readOnlyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-readOnlyCls" class="viewSource">view source</a></div><a name="readOnlyCls"></a><a name="config-readOnlyCls"></a><a href="Ext.form.field.Text.html#" rel="config-readOnlyCls" class="cls expand">readOnlyCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class applied to the component's main element when it is <a href="Ext.form.field.Text.html#readOnly" rel="Ext.form.field.Text#readOnly" class="docClass">readOnly</a>.</p>
145 </div><div class="long"><p>The CSS class applied to the component's main element when it is <a href="Ext.form.field.Text.html#readOnly" rel="Ext.form.field.Text#readOnly" class="docClass">readOnly</a>.</p>
146 </div></div></div><div id="config-styleHtmlCls" class="member inherited"><a href="Ext.form.field.Text.html#config-styleHtmlCls" rel="config-styleHtmlCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-styleHtmlCls" class="viewSource">view source</a></div><a name="styleHtmlCls"></a><a name="config-styleHtmlCls"></a><a href="Ext.form.field.Text.html#" rel="config-styleHtmlCls" class="cls expand">styleHtmlCls</a><span> : String</span></div><div class="description"><div class="short"><p>The class that is added to the content target when you set styleHtmlContent to true.
147 Defaults to 'x-html'</p>
148 </div><div class="long"><p>The class that is added to the content target when you set styleHtmlContent to true.
149 Defaults to 'x-html'</p>
150 </div></div></div><h4 class="cfgGroup">Other Configs</h4><div id="config-activeError" class="member f inherited"><a href="Ext.form.field.Text.html#config-activeError" rel="config-activeError" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-activeError" class="viewSource">view source</a></div><a name="activeError"></a><a name="config-activeError"></a><a href="Ext.form.field.Text.html#" rel="config-activeError" class="cls expand">activeError</a><span> : String</span></div><div class="description"><div class="short">If specified, then the component will be displayed with this value as its active error when
151 first rendered. Defaults ...</div><div class="long"><p>If specified, then the component will be displayed with this value as its active error when
152 first rendered. Defaults to undefined. Use <a href="Ext.form.field.Text.html#setActiveError" rel="Ext.form.field.Text#setActiveError" class="docClass">setActiveError</a> or <a href="Ext.form.field.Text.html#unsetActiveError" rel="Ext.form.field.Text#unsetActiveError" class="docClass">unsetActiveError</a> to
153 change it after component creation.</p>
154 </div></div></div><div id="config-activeErrorsTpl" class="member inherited"><a href="Ext.form.field.Text.html#config-activeErrorsTpl" rel="config-activeErrorsTpl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-activeErrorsTpl" class="viewSource">view source</a></div><a name="activeErrorsTpl"></a><a name="config-activeErrorsTpl"></a><a href="Ext.form.field.Text.html#" rel="config-activeErrorsTpl" class="cls expand">activeErrorsTpl</a><span> : Ext.XTemplate</span></div><div class="description"><div class="short">The template used to format the Array of error messages passed to setActiveErrors
155 into a single HTML string. By defau...</div><div class="long"><p>The template used to format the Array of error messages passed to <a href="Ext.form.field.Text.html#setActiveErrors" rel="Ext.form.field.Text#setActiveErrors" class="docClass">setActiveErrors</a>
156 into a single HTML string. By default this renders each message as an item in an unordered list.</p>
157 </div></div></div><div id="config-allowBlank" class="member ni"><a href="Ext.form.field.Text.html#config-allowBlank" rel="config-allowBlank" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-allowBlank" class="viewSource">view source</a></div><a name="allowBlank"></a><a name="config-allowBlank"></a><a href="Ext.form.field.Text.html#" rel="config-allowBlank" class="cls expand">allowBlank</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Specify <tt>false</tt> to validate that the value's length is > 0 (defaults to
158 <tt>true</tt>)</p>
159 </div><div class="long"><p>Specify <tt>false</tt> to validate that the value's length is > 0 (defaults to
160 <tt>true</tt>)</p>
161 </div></div></div><div id="config-autoEl" class="member inherited"><a href="Ext.form.field.Text.html#config-autoEl" rel="config-autoEl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-autoEl" class="viewSource">view source</a></div><a name="autoEl"></a><a name="config-autoEl"></a><a href="Ext.form.field.Text.html#" rel="config-autoEl" class="cls expand">autoEl</a><span> : Mixed</span></div><div class="description"><div class="short">A tag name or DomHelper spec used to create the Element which will
162 encapsulate this Component.
163
164
165 You do not normally ...</div><div class="long"><p>A tag name or <a href="Ext.core.DomHelper.html" rel="Ext.core.DomHelper" class="docClass">DomHelper</a> spec used to create the <a href="Ext.form.field.Text.html#getEl" rel="Ext.form.field.Text#getEl" class="docClass">Element</a> which will
166 encapsulate this Component.</p>
167
168
169 <p>You do not normally need to specify this. For the base classes <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> and <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Ext.container.Container</a>,
170 this defaults to <b><tt>'div'</tt></b>. The more complex Sencha classes use a more complex
171 DOM structure specified by their own <a href="Ext.form.field.Text.html#renderTpl" rel="Ext.form.field.Text#renderTpl" class="docClass">renderTpl</a>s.</p>
172
173
174 <p>This is intended to allow the developer to create application-specific utility Components encapsulated by
175 different DOM elements. Example usage:</p>
176
177
178 <pre><code>{
179     xtype: 'component',
180     autoEl: {
181         tag: 'img',
182         src: 'http://www.example.com/example.jpg'
183     }
184 }, {
185     xtype: 'component',
186     autoEl: {
187         tag: 'blockquote',
188         html: 'autoEl is cool!'
189     }
190 }, {
191     xtype: 'container',
192     autoEl: 'ul',
193     cls: 'ux-unordered-list',
194     items: {
195         xtype: 'component',
196         autoEl: 'li',
197         html: 'First list item'
198     }
199 }
200 </code></pre>
201
202 </div></div></div><div id="config-autoFitErrors" class="member inherited"><a href="Ext.form.field.Text.html#config-autoFitErrors" rel="config-autoFitErrors" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-autoFitErrors" class="viewSource">view source</a></div><a name="autoFitErrors"></a><a name="config-autoFitErrors"></a><a href="Ext.form.field.Text.html#" rel="config-autoFitErrors" class="cls expand">autoFitErrors</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Whether to adjust the component's body area to make room for 'side' or 'under'
203 <a href="Ext.form.field.Text.html#msgTarget" rel="Ext.form.field.Text#msgTarget" class="docClass">error messages</a>. Defaults to <tt>true</tt>.</p>
204 </div><div class="long"><p>Whether to adjust the component's body area to make room for 'side' or 'under'
205 <a href="Ext.form.field.Text.html#msgTarget" rel="Ext.form.field.Text#msgTarget" class="docClass">error messages</a>. Defaults to <tt>true</tt>.</p>
206 </div></div></div><div id="config-autoRender" class="member inherited"><a href="Ext.form.field.Text.html#config-autoRender" rel="config-autoRender" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-autoRender" class="viewSource">view source</a></div><a name="autoRender"></a><a name="config-autoRender"></a><a href="Ext.form.field.Text.html#" rel="config-autoRender" class="cls expand">autoRender</a><span> : Mixed</span></div><div class="description"><div class="short">This config is intended mainly for floating Components which may or may not be shown. Instead
207 of using renderTo in th...</div><div class="long"><p>This config is intended mainly for <a href="Ext.form.field.Text.html#floating" rel="Ext.form.field.Text#floating" class="docClass">floating</a> Components which may or may not be shown. Instead
208 of using <a href="Ext.form.field.Text.html#renderTo" rel="Ext.form.field.Text#renderTo" class="docClass">renderTo</a> in the configuration, and rendering upon construction, this allows a Component
209 to render itself upon first <i><a href="Ext.form.field.Text.html#show" rel="Ext.form.field.Text#show" class="docClass">show</a></i>.</p>
210
211
212 <p>Specify as <code>true</code> to have this Component render to the document body upon first show.</p>
213
214
215 <p>Specify as an element, or the ID of an element to have this Component render to a specific element upon first show.</p>
216
217
218 <p><b>This defaults to <code>true</code> for the <a href="Ext.window.Window.html" rel="Ext.window.Window" class="docClass">Window</a> class.</b></p>
219
220 </div></div></div><div id="config-autoScroll" class="member inherited"><a href="Ext.form.field.Text.html#config-autoScroll" rel="config-autoScroll" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-autoScroll" class="viewSource">view source</a></div><a name="autoScroll"></a><a name="config-autoScroll"></a><a href="Ext.form.field.Text.html#" rel="config-autoScroll" class="cls expand">autoScroll</a><span> : Boolean</span></div><div class="description"><div class="short">true to use overflow:'auto' on the components layout element and show scroll bars automatically when
221 necessary, false...</div><div class="long"><p><code>true</code> to use overflow:'auto' on the components layout element and show scroll bars automatically when
222 necessary, <code>false</code> to clip any overflowing content (defaults to <code>false</code>).</p>
223 </div></div></div><div id="config-autoShow" class="member inherited"><a href="Ext.form.field.Text.html#config-autoShow" rel="config-autoShow" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-autoShow" class="viewSource">view source</a></div><a name="autoShow"></a><a name="config-autoShow"></a><a href="Ext.form.field.Text.html#" rel="config-autoShow" class="cls expand">autoShow</a><span> : Boolean</span></div><div class="description"><div class="short">True to automatically show the component upon creation.
224 This config option may only be used for floating components o...</div><div class="long"><p>True to automatically show the component upon creation.
225 This config option may only be used for <a href="Ext.form.field.Text.html#floating" rel="Ext.form.field.Text#floating" class="docClass">floating</a> components or components
226 that use <a href="Ext.form.field.Text.html#autoRender" rel="Ext.form.field.Text#autoRender" class="docClass">autoRender</a>. Defaults to <tt>false</tt>.</p>
227 </div></div></div><div id="config-baseBodyCls" class="member inherited"><a href="Ext.form.field.Text.html#config-baseBodyCls" rel="config-baseBodyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-baseBodyCls" class="viewSource">view source</a></div><a name="baseBodyCls"></a><a name="config-baseBodyCls"></a><a href="Ext.form.field.Text.html#" rel="config-baseBodyCls" class="cls expand">baseBodyCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to be applied to the body content element. Defaults to 'x-form-item-body'.</p>
228 </div><div class="long"><p>The CSS class to be applied to the body content element. Defaults to 'x-form-item-body'.</p>
229 </div></div></div><div id="config-baseCls" class="member inherited"><a href="Ext.form.field.Text.html#config-baseCls" rel="config-baseCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-baseCls" class="viewSource">view source</a></div><a name="baseCls"></a><a name="config-baseCls"></a><a href="Ext.form.field.Text.html#" rel="config-baseCls" class="cls expand">baseCls</a><span> : String</span></div><div class="description"><div class="short">The base CSS class to apply to this components's element. This will also be prepended to
230 elements within this compone...</div><div class="long"><p>The base CSS class to apply to this components's element. This will also be prepended to
231 elements within this component like Panel's body will get a class x-panel-body. This means
232 that if you create a subclass of Panel, and you want it to get all the Panels styling for the
233 element and the body, you leave the baseCls x-panel and use componentCls to add specific styling for this
234 component.</p>
235 </div></div></div><div id="config-blankText" class="member ni"><a href="Ext.form.field.Text.html#config-blankText" rel="config-blankText" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-blankText" class="viewSource">view source</a></div><a name="blankText"></a><a name="config-blankText"></a><a href="Ext.form.field.Text.html#" rel="config-blankText" class="cls expand">blankText</a><span> : String</span></div><div class="description"><div class="short"><p>The error text to display if the <b><tt><a href="Ext.form.field.Text.html#allowBlank" rel="Ext.form.field.Text#allowBlank" class="docClass">allowBlank</a></tt></b> validation
236 fails (defaults to <tt>'This field is required'</tt>)</p>
237 </div><div class="long"><p>The error text to display if the <b><tt><a href="Ext.form.field.Text.html#allowBlank" rel="Ext.form.field.Text#allowBlank" class="docClass">allowBlank</a></tt></b> validation
238 fails (defaults to <tt>'This field is required'</tt>)</p>
239 </div></div></div><div id="config-border" class="member inherited"><a href="Ext.form.field.Text.html#config-border" rel="config-border" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-border" class="viewSource">view source</a></div><a name="border"></a><a name="config-border"></a><a href="Ext.form.field.Text.html#" rel="config-border" class="cls expand">border</a><span> : Number/String</span></div><div class="description"><div class="short">Specifies the border for this component. The border can be a single numeric value to apply to all sides or
240 it can be ...</div><div class="long"><p>Specifies the border for this component. The border can be a single numeric value to apply to all sides or
241 it can be a CSS style specification for each style, for example: '10 5 3 10'.</p>
242 </div></div></div><div id="config-checkChangeBuffer" class="member inherited"><a href="Ext.form.field.Text.html#config-checkChangeBuffer" rel="config-checkChangeBuffer" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-checkChangeBuffer" class="viewSource">view source</a></div><a name="checkChangeBuffer"></a><a name="config-checkChangeBuffer"></a><a href="Ext.form.field.Text.html#" rel="config-checkChangeBuffer" class="cls expand">checkChangeBuffer</a><span> : Number</span></div><div class="description"><div class="short">Defines a timeout in milliseconds for buffering checkChangeEvents that fire in rapid succession.
243 Defaults to 50 milli...</div><div class="long"><p>Defines a timeout in milliseconds for buffering <a href="Ext.form.field.Text.html#checkChangeEvents" rel="Ext.form.field.Text#checkChangeEvents" class="docClass">checkChangeEvents</a> that fire in rapid succession.
244 Defaults to 50 milliseconds.</p>
245 </div></div></div><div id="config-checkChangeEvents" class="member inherited"><a href="Ext.form.field.Text.html#config-checkChangeEvents" rel="config-checkChangeEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-checkChangeEvents" class="viewSource">view source</a></div><a name="checkChangeEvents"></a><a name="config-checkChangeEvents"></a><a href="Ext.form.field.Text.html#" rel="config-checkChangeEvents" class="cls expand">checkChangeEvents</a><span> : Array</span></div><div class="description"><div class="short">A list of event names that will be listened for on the field's input element, which
246 will cause the field's value to b...</div><div class="long"><p>A list of event names that will be listened for on the field's <a href="Ext.form.field.Text.html#inputEl" rel="Ext.form.field.Text#inputEl" class="docClass">input element</a>, which
247 will cause the field's value to be checked for changes. If a change is detected, the
248 <a href="Ext.form.field.Text.html#change" rel="Ext.form.field.Text#change" class="docClass">change event</a> will be fired, followed by validation if the <a href="Ext.form.field.Text.html#validateOnChange" rel="Ext.form.field.Text#validateOnChange" class="docClass">validateOnChange</a>
249 option is enabled.</p>
250
251
252 <p>Defaults to <tt>['change', 'propertychange']</tt> in Internet Explorer, and <tt>['change', 'input',
253 'textInput', 'keyup', 'dragdrop']</tt> in other browsers. This catches all the ways that field values
254 can be changed in most supported browsers; the only known exceptions at the time of writing are:</p>
255
256
257 <ul>
258 <li>Safari 3.2 and older: cut/paste in textareas via the context menu, and dragging text into textareas</li>
259 <li>Opera 10 and 11: dragging text into text fields and textareas, and cut via the context menu in text
260 fields and textareas</li>
261 <li>Opera 9: Same as Opera 10 and 11, plus paste from context menu in text fields and textareas</li>
262 </ul>
263
264
265 <p>If you need to guarantee on-the-fly change notifications including these edge cases, you can call the
266 <a href="Ext.form.field.Text.html#checkChange" rel="Ext.form.field.Text#checkChange" class="docClass">checkChange</a> method on a repeating interval, e.g. using <a href="Ext.TaskManager.html" rel="Ext.TaskManager" class="docClass">Ext.TaskManager</a>, or if the field is
267 within a <a href="Ext.form.Panel.html" rel="Ext.form.Panel" class="docClass">Ext.form.Panel</a>, you can use the FormPanel's <a href="Ext.form.Panel.html#pollForChanges" rel="Ext.form.Panel#pollForChanges" class="docClass">Ext.form.Panel.pollForChanges</a>
268 configuration to set up such a task automatically.</p>
269
270 </div></div></div><div id="config-clearCls" class="member inherited"><a href="Ext.form.field.Text.html#config-clearCls" rel="config-clearCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-clearCls" class="viewSource">view source</a></div><a name="clearCls"></a><a name="config-clearCls"></a><a href="Ext.form.field.Text.html#" rel="config-clearCls" class="cls expand">clearCls</a><span> : String</span></div><div class="description"><div class="short">The CSS class to be applied to the special clearing div rendered directly after the field
271 contents wrapper to provide...</div><div class="long"><p>The CSS class to be applied to the special clearing div rendered directly after the field
272 contents wrapper to provide field clearing (defaults to <tt>'x-clear'</tt>).</p>
273 </div></div></div><div id="config-cls" class="member inherited"><a href="Ext.form.field.Text.html#config-cls" rel="config-cls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-cls" class="viewSource">view source</a></div><a name="cls"></a><a name="config-cls"></a><a href="Ext.form.field.Text.html#" rel="config-cls" class="cls expand">cls</a><span> : String</span></div><div class="description"><div class="short">An optional extra CSS class that will be added to this component's Element (defaults to '').  This can be
274 useful for ...</div><div class="long"><p>An optional extra CSS class that will be added to this component's Element (defaults to '').  This can be
275 useful for adding customized styles to the component or any of its children using standard CSS rules.</p>
276 </div></div></div><div id="config-componentCls" class="member inherited"><a href="Ext.form.field.Text.html#config-componentCls" rel="config-componentCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-componentCls" class="viewSource">view source</a></div><a name="componentCls"></a><a name="config-componentCls"></a><a href="Ext.form.field.Text.html#" rel="config-componentCls" class="cls expand">componentCls</a><span> : String</span></div><div class="description"><div class="short"><p>CSS Class to be added to a components root level element to give distinction to it
277 via styling.</p>
278 </div><div class="long"><p>CSS Class to be added to a components root level element to give distinction to it
279 via styling.</p>
280 </div></div></div><div id="config-componentLayout" class="member inherited"><a href="Ext.form.field.Text.html#config-componentLayout" rel="config-componentLayout" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-componentLayout" class="viewSource">view source</a></div><a name="componentLayout"></a><a name="config-componentLayout"></a><a href="Ext.form.field.Text.html#" rel="config-componentLayout" class="cls expand">componentLayout</a><span> : String/Object</span></div><div class="description"><div class="short">The sizing and positioning of a Component's internal Elements is the responsibility of
281 the Component's layout manager...</div><div class="long"><p>The sizing and positioning of a Component's internal Elements is the responsibility of
282 the Component's layout manager which sizes a Component's internal structure in response to the Component being sized.</p>
283
284
285 <p>Generally, developers will not use this configuration as all provided Components which need their internal
286 elements sizing (Such as <a href="Ext.form.field.Base.html" rel="Ext.form.field.Base" class="docClass">input fields</a>) come with their own componentLayout managers.</p>
287
288
289 <p>The <a href="Ext.layout.container.Auto.html" rel="Ext.layout.container.Auto" class="docClass">default layout manager</a> will be used on instances of the base <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> class
290 which simply sizes the Component's encapsulating element to the height and width specified in the <a href="Ext.form.field.Text.html#setSize" rel="Ext.form.field.Text#setSize" class="docClass">setSize</a> method.</p>
291
292 </div></div></div><div id="config-contentEl" class="member inherited"><a href="Ext.form.field.Text.html#config-contentEl" rel="config-contentEl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-contentEl" class="viewSource">view source</a></div><a name="contentEl"></a><a name="config-contentEl"></a><a href="Ext.form.field.Text.html#" rel="config-contentEl" class="cls expand">contentEl</a><span> : String</span></div><div class="description"><div class="short">Optional. Specify an existing HTML element, or the id of an existing HTML element to use as the content
293 for this comp...</div><div class="long"><p>Optional. Specify an existing HTML element, or the <code>id</code> of an existing HTML element to use as the content
294 for this component.</p>
295
296
297 <ul>
298 <li><b>Description</b> :
299 <div class="sub-desc">This config option is used to take an existing HTML element and place it in the layout element
300 of a new component (it simply moves the specified DOM element <i>after the Component is rendered</i> to use as the content.</div></li>
301 <li><b>Notes</b> :
302 <div class="sub-desc">The specified HTML element is appended to the layout element of the component <i>after any configured
303 <a href="Ext.form.field.Text.html#html" rel="Ext.form.field.Text#html" class="docClass">HTML</a> has been inserted</i>, and so the document will not contain this element at the time the <a href="Ext.form.field.Text.html#render" rel="Ext.form.field.Text#render" class="docClass">render</a> event is fired.</div>
304 <div class="sub-desc">The specified HTML element used will not participate in any <code><b><a href="Ext.container.Container.html#layout" rel="Ext.container.Container#layout" class="docClass">layout</a></b></code>
305 scheme that the Component may use. It is just HTML. Layouts operate on child <code><b><a href="Ext.container.Container.html#items" rel="Ext.container.Container#items" class="docClass">items</a></b></code>.</div>
306 <div class="sub-desc">Add either the <code>x-hidden</code> or the <code>x-hide-display</code> CSS class to
307 prevent a brief flicker of the content before it is rendered to the panel.</div></li>
308 </ul>
309
310 </div></div></div><div id="config-data" class="member inherited"><a href="Ext.form.field.Text.html#config-data" rel="config-data" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-data" class="viewSource">view source</a></div><a name="data"></a><a name="config-data"></a><a href="Ext.form.field.Text.html#" rel="config-data" class="cls expand">data</a><span> : Mixed</span></div><div class="description"><div class="short"><p>The initial set of data to apply to the <code><a href="Ext.form.field.Text.html#tpl" rel="Ext.form.field.Text#tpl" class="docClass">tpl</a></code> to
311 update the content area of the Component.</p>
312 </div><div class="long"><p>The initial set of data to apply to the <code><a href="Ext.form.field.Text.html#tpl" rel="Ext.form.field.Text#tpl" class="docClass">tpl</a></code> to
313 update the content area of the Component.</p>
314 </div></div></div><div id="config-dirtyCls" class="member inherited"><a href="Ext.form.field.Text.html#config-dirtyCls" rel="config-dirtyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-dirtyCls" class="viewSource">view source</a></div><a name="dirtyCls"></a><a name="config-dirtyCls"></a><a href="Ext.form.field.Text.html#" rel="config-dirtyCls" class="cls expand">dirtyCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to use when the field value <a href="Ext.form.field.Text.html#isDirty" rel="Ext.form.field.Text#isDirty" class="docClass">is dirty</a>.</p>
315 </div><div class="long"><p>The CSS class to use when the field value <a href="Ext.form.field.Text.html#isDirty" rel="Ext.form.field.Text#isDirty" class="docClass">is dirty</a>.</p>
316 </div></div></div><div id="config-disableKeyFilter" class="member ni"><a href="Ext.form.field.Text.html#config-disableKeyFilter" rel="config-disableKeyFilter" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-disableKeyFilter" class="viewSource">view source</a></div><a name="disableKeyFilter"></a><a name="config-disableKeyFilter"></a><a href="Ext.form.field.Text.html#" rel="config-disableKeyFilter" class="cls expand">disableKeyFilter</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Specify <tt>true</tt> to disable input keystroke filtering (defaults
317 to <tt>false</tt>)</p>
318 </div><div class="long"><p>Specify <tt>true</tt> to disable input keystroke filtering (defaults
319 to <tt>false</tt>)</p>
320 </div></div></div><div id="config-disabled" class="member inherited"><a href="Ext.form.field.Text.html#config-disabled" rel="config-disabled" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-cfg-disabled" class="viewSource">view source</a></div><a name="disabled"></a><a name="config-disabled"></a><a href="Ext.form.field.Text.html#" rel="config-disabled" class="cls expand">disabled</a><span> : Boolean</span></div><div class="description"><div class="short"><p>True to disable the field (defaults to false). Disabled Fields will not be
321 <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">submitted</a>.</p></p>
322 </div><div class="long"><p>True to disable the field (defaults to false). Disabled Fields will not be
323 <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">submitted</a>.</p></p>
324 </div></div></div><div id="config-disabledCls" class="member inherited"><a href="Ext.form.field.Text.html#config-disabledCls" rel="config-disabledCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-disabledCls" class="viewSource">view source</a></div><a name="disabledCls"></a><a name="config-disabledCls"></a><a href="Ext.form.field.Text.html#" rel="config-disabledCls" class="cls expand">disabledCls</a><span> : String</span></div><div class="description"><div class="short"><p>CSS class to add when the Component is disabled. Defaults to 'x-item-disabled'.</p>
325 </div><div class="long"><p>CSS class to add when the Component is disabled. Defaults to 'x-item-disabled'.</p>
326 </div></div></div><div id="config-draggable" class="member inherited"><a href="Ext.form.field.Text.html#config-draggable" rel="config-draggable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-draggable" class="viewSource">view source</a></div><a name="draggable"></a><a name="config-draggable"></a><a href="Ext.form.field.Text.html#" rel="config-draggable" class="cls expand">draggable</a><span> : Mixed</span></div><div class="description"><div class="short">Specify as true to make a floating Component draggable using the Component's encapsulating element as the drag handle...</div><div class="long"><p>Specify as true to make a <a href="Ext.form.field.Text.html#floating" rel="Ext.form.field.Text#floating" class="docClass">floating</a> Component draggable using the Component's encapsulating element as the drag handle.</p>
327
328
329 <p>This may also be specified as a config object for the <a href="Ext.util.ComponentDragger.html" rel="Ext.util.ComponentDragger" class="docClass">ComponentDragger</a> which is instantiated to perform dragging.</p>
330
331
332 <p>For example to create a Component which may only be dragged around using a certain internal element as the drag handle,
333 use the delegate option:</p>
334
335
336 <p><code></p>
337
338 <pre>new Ext.Component({
339     constrain: true,
340     floating:true,
341     style: {
342         backgroundColor: '#fff',
343         border: '1px solid black'
344     },
345     html: '&lt;h1 style="cursor:move"&gt;The title&lt;/h1&gt;&lt;p&gt;The content&lt;/p&gt;',
346     draggable: {
347         delegate: 'h1'
348     }
349 }).show();
350 </pre>
351
352
353 <p></code></p>
354 </div></div></div><div id="config-emptyCls" class="member ni"><a href="Ext.form.field.Text.html#config-emptyCls" rel="config-emptyCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-emptyCls" class="viewSource">view source</a></div><a name="emptyCls"></a><a name="config-emptyCls"></a><a href="Ext.form.field.Text.html#" rel="config-emptyCls" class="cls expand">emptyCls</a><span> : String</span></div><div class="description"><div class="short">The CSS class to apply to an empty field to style the emptyText
355 (defaults to 'x-form-empty-field').  This class is au...</div><div class="long"><p>The CSS class to apply to an empty field to style the <b><tt><a href="Ext.form.field.Text.html#emptyText" rel="Ext.form.field.Text#emptyText" class="docClass">emptyText</a></tt></b>
356 (defaults to <tt>'x-form-empty-field'</tt>).  This class is automatically added and removed as needed
357 depending on the current field value.</p>
358 </div></div></div><div id="config-emptyText" class="member ni"><a href="Ext.form.field.Text.html#config-emptyText" rel="config-emptyText" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-emptyText" class="viewSource">view source</a></div><a name="emptyText"></a><a name="config-emptyText"></a><a href="Ext.form.field.Text.html#" rel="config-emptyText" class="cls expand">emptyText</a><span> : String</span></div><div class="description"><div class="short">The default text to place into an empty field (defaults to undefined).
359
360
361 Note that normally this value will be submit...</div><div class="long"><p>The default text to place into an empty field (defaults to <tt>undefined</tt>).</p>
362
363
364 <p>Note that normally this value will be submitted to the server if this field is enabled; to prevent this
365 you can set the <a href="Ext.form.action.Action.html#submitEmptyText" rel="Ext.form.action.Action#submitEmptyText" class="docClass">submitEmptyText</a> option of
366 <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">Ext.form.Basic.submit</a> to <tt>false</tt>.</p>
367
368
369 <p>Also note that if you use <tt><a href="Ext.form.field.Text.html#inputType" rel="Ext.form.field.Text#inputType" class="docClass">inputType</a>:'file'</tt>, <a href="Ext.form.field.Text.html#emptyText" rel="Ext.form.field.Text#emptyText" class="docClass">emptyText</a> is not
370 supported and should be avoided.</p>
371
372 </div></div></div><div id="config-enableKeyEvents" class="member ni"><a href="Ext.form.field.Text.html#config-enableKeyEvents" rel="config-enableKeyEvents" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-enableKeyEvents" class="viewSource">view source</a></div><a name="enableKeyEvents"></a><a name="config-enableKeyEvents"></a><a href="Ext.form.field.Text.html#" rel="config-enableKeyEvents" class="cls expand">enableKeyEvents</a><span> : Boolean</span></div><div class="description"><div class="short"><p><tt>true</tt> to enable the proxying of key events for the HTML input field (defaults to <tt>false</tt>)</p>
373 </div><div class="long"><p><tt>true</tt> to enable the proxying of key events for the HTML input field (defaults to <tt>false</tt>)</p>
374 </div></div></div><div id="config-enforceMaxLength" class="member ni"><a href="Ext.form.field.Text.html#config-enforceMaxLength" rel="config-enforceMaxLength" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-enforceMaxLength" class="viewSource">view source</a></div><a name="enforceMaxLength"></a><a name="config-enforceMaxLength"></a><a href="Ext.form.field.Text.html#" rel="config-enforceMaxLength" class="cls expand">enforceMaxLength</a><span> : Boolean</span></div><div class="description"><div class="short"><p>True to set the maxLength property on the underlying input field. Defaults to <tt>false</tt></p>
375 </div><div class="long"><p>True to set the maxLength property on the underlying input field. Defaults to <tt>false</tt></p>
376 </div></div></div><div id="config-errorMsgCls" class="member inherited"><a href="Ext.form.field.Text.html#config-errorMsgCls" rel="config-errorMsgCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-errorMsgCls" class="viewSource">view source</a></div><a name="errorMsgCls"></a><a name="config-errorMsgCls"></a><a href="Ext.form.field.Text.html#" rel="config-errorMsgCls" class="cls expand">errorMsgCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to be applied to the error message element. Defaults to 'x-form-error-msg'.</p>
377 </div><div class="long"><p>The CSS class to be applied to the error message element. Defaults to 'x-form-error-msg'.</p>
378 </div></div></div><div id="config-fieldBodyCls" class="member inherited"><a href="Ext.form.field.Text.html#config-fieldBodyCls" rel="config-fieldBodyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-fieldBodyCls" class="viewSource">view source</a></div><a name="fieldBodyCls"></a><a name="config-fieldBodyCls"></a><a href="Ext.form.field.Text.html#" rel="config-fieldBodyCls" class="cls expand">fieldBodyCls</a><span> : String</span></div><div class="description"><div class="short"><p>An extra CSS class to be applied to the body content element in addition to <a href="Ext.form.field.Text.html#fieldBodyCls" rel="Ext.form.field.Text#fieldBodyCls" class="docClass">fieldBodyCls</a>.
379 Defaults to empty.</p>
380 </div><div class="long"><p>An extra CSS class to be applied to the body content element in addition to <a href="Ext.form.field.Text.html#fieldBodyCls" rel="Ext.form.field.Text#fieldBodyCls" class="docClass">fieldBodyCls</a>.
381 Defaults to empty.</p>
382 </div></div></div><div id="config-fieldCls" class="member inherited"><a href="Ext.form.field.Text.html#config-fieldCls" rel="config-fieldCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-fieldCls" class="viewSource">view source</a></div><a name="fieldCls"></a><a name="config-fieldCls"></a><a href="Ext.form.field.Text.html#" rel="config-fieldCls" class="cls expand">fieldCls</a><span> : String</span></div><div class="description"><div class="short"><p>The default CSS class for the field input (defaults to 'x-form-field')</p>
383 </div><div class="long"><p>The default CSS class for the field input (defaults to 'x-form-field')</p>
384 </div></div></div><div id="config-fieldLabel" class="member inherited"><a href="Ext.form.field.Text.html#config-fieldLabel" rel="config-fieldLabel" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-fieldLabel" class="viewSource">view source</a></div><a name="fieldLabel"></a><a name="config-fieldLabel"></a><a href="Ext.form.field.Text.html#" rel="config-fieldLabel" class="cls expand">fieldLabel</a><span> : String</span></div><div class="description"><div class="short">The label for the field. It gets appended with the labelSeparator, and its position
385 and sizing is determined by the l...</div><div class="long"><p>The label for the field. It gets appended with the <a href="Ext.form.field.Text.html#labelSeparator" rel="Ext.form.field.Text#labelSeparator" class="docClass">labelSeparator</a>, and its position
386 and sizing is determined by the <a href="Ext.form.field.Text.html#labelAlign" rel="Ext.form.field.Text#labelAlign" class="docClass">labelAlign</a>, <a href="Ext.form.field.Text.html#labelWidth" rel="Ext.form.field.Text#labelWidth" class="docClass">labelWidth</a>, and <a href="Ext.form.field.Text.html#labelPad" rel="Ext.form.field.Text#labelPad" class="docClass">labelPad</a>
387 configs. Defaults to undefined.</p>
388 </div></div></div><div id="config-fieldStyle" class="member inherited"><a href="Ext.form.field.Text.html#config-fieldStyle" rel="config-fieldStyle" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-fieldStyle" class="viewSource">view source</a></div><a name="fieldStyle"></a><a name="config-fieldStyle"></a><a href="Ext.form.field.Text.html#" rel="config-fieldStyle" class="cls expand">fieldStyle</a><span> : String</span></div><div class="description"><div class="short">Optional CSS style(s) to be applied to the field input element.
389 Should be a valid argument to Ext.core.Element.applyS...</div><div class="long"><p>Optional CSS style(s) to be applied to the <a href="Ext.form.field.Text.html#inputEl" rel="Ext.form.field.Text#inputEl" class="docClass">field input element</a>.
390 Should be a valid argument to <a href="Ext.core.Element.html#applyStyles" rel="Ext.core.Element#applyStyles" class="docClass">Ext.core.Element.applyStyles</a>. Defaults to undefined. See also the
391 <a href="Ext.form.field.Text.html#setFieldStyle" rel="Ext.form.field.Text#setFieldStyle" class="docClass">setFieldStyle</a> method for changing the style after initialization.</p>
392 </div></div></div><div id="config-floating" class="member inherited"><a href="Ext.form.field.Text.html#config-floating" rel="config-floating" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-floating" class="viewSource">view source</a></div><a name="floating"></a><a name="config-floating"></a><a href="Ext.form.field.Text.html#" rel="config-floating" class="cls expand">floating</a><span> : Boolean</span></div><div class="description"><div class="short">Specify as true to float the Component outside of the document flow using CSS absolute positioning.
393
394
395 Components such...</div><div class="long"><p>Specify as true to float the Component outside of the document flow using CSS absolute positioning.</p>
396
397
398 <p>Components such as <a href="Ext.window.Window.html" rel="Ext.window.Window" class="docClass">Window</a>s and <a href="Ext.menu.Menu.html" rel="Ext.menu.Menu" class="docClass">Menu</a>s are floating
399 by default.</p>
400
401
402 <p>Floating Components that are programatically <a href="Ext.Component.html#render" rel="Ext.Component#render" class="docClass">rendered</a> will register themselves with the global
403 <a href="Ext.WindowManager.html" rel="Ext.WindowManager" class="docClass">ZIndexManager</a></p>
404
405
406 <h3 class="pa">Floating Components as child items of a Container</h3>
407
408
409 <p>A floating Component may be used as a child item of a Container. This just allows the floating Component to seek a ZIndexManager by
410 examining the ownerCt chain.</p>
411
412
413 <p>When configured as floating, Components acquire, at render time, a <a href="Ext.ZIndexManager.html" rel="Ext.ZIndexManager" class="docClass">ZIndexManager</a> which manages a stack
414 of related floating Components. The ZIndexManager brings a single floating Component to the top of its stack when
415 the Component's <a href="Ext.form.field.Text.html#toFront" rel="Ext.form.field.Text#toFront" class="docClass">toFront</a> method is called.</p>
416
417
418 <p>The ZIndexManager is found by traversing up the <a href="Ext.form.field.Text.html#ownerCt" rel="Ext.form.field.Text#ownerCt" class="docClass">ownerCt</a> chain to find an ancestor which itself is floating. This is so that
419 descendant floating Components of floating <i>Containers</i> (Such as a ComboBox dropdown within a Window) can have its zIndex managed relative
420 to any siblings, but always <b>above</b> that floating ancestor Container.</p>
421
422
423 <p>If no floating ancestor is found, a floating Component registers itself with the default <a href="Ext.WindowManager.html" rel="Ext.WindowManager" class="docClass">ZIndexManager</a>.</p>
424
425
426 <p>Floating components <i>do not participate in the Container's layout</i>. Because of this, they are not rendered until you explicitly
427 <a href="Ext.form.field.Text.html#show" rel="Ext.form.field.Text#show" class="docClass">show</a> them.</p>
428
429
430 <p>After rendering, the ownerCt reference is deleted, and the <a href="Ext.form.field.Text.html#floatParent" rel="Ext.form.field.Text#floatParent" class="docClass">floatParent</a> property is set to the found floating ancestor Container.
431 If no floating ancestor Container was found the <a href="Ext.form.field.Text.html#floatParent" rel="Ext.form.field.Text#floatParent" class="docClass">floatParent</a> property will not be set.</p>
432
433 </div></div></div><div id="config-focusCls" class="member inherited"><a href="Ext.form.field.Text.html#config-focusCls" rel="config-focusCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-focusCls" class="viewSource">view source</a></div><a name="focusCls"></a><a name="config-focusCls"></a><a href="Ext.form.field.Text.html#" rel="config-focusCls" class="cls expand">focusCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to use when the field receives focus (defaults to 'x-form-focus')</p>
434 </div><div class="long"><p>The CSS class to use when the field receives focus (defaults to 'x-form-focus')</p>
435 </div></div></div><div id="config-focusOnToFront" class="member inherited"><a href="Ext.form.field.Text.html#config-focusOnToFront" rel="config-focusOnToFront" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-cfg-focusOnToFront" class="viewSource">view source</a></div><a name="focusOnToFront"></a><a name="config-focusOnToFront"></a><a href="Ext.form.field.Text.html#" rel="config-focusOnToFront" class="cls expand">focusOnToFront</a><span> : Boolean</span></div><div class="description"><div class="short">Specifies whether the floated component should be automatically focused when it is
436 brought to the front. Defaults to ...</div><div class="long"><p>Specifies whether the floated component should be automatically <a href="Ext.form.field.Text.html#focus" rel="Ext.form.field.Text#focus" class="docClass">focused</a> when it is
437 <a href="Ext.form.field.Text.html#toFront" rel="Ext.form.field.Text#toFront" class="docClass">brought to the front</a>. Defaults to true.</p>
438 </div></div></div><div id="config-formItemCls" class="member inherited"><a href="Ext.form.field.Text.html#config-formItemCls" rel="config-formItemCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-formItemCls" class="viewSource">view source</a></div><a name="formItemCls"></a><a name="config-formItemCls"></a><a href="Ext.form.field.Text.html#" rel="config-formItemCls" class="cls expand">formItemCls</a><span> : String</span></div><div class="description"><div class="short">A CSS class to be applied to the outermost element to denote that it is participating in the form
439 field layout. Defau...</div><div class="long"><p>A CSS class to be applied to the outermost element to denote that it is participating in the form
440 field layout. Defaults to 'x-form-item'.</p>
441 </div></div></div><div id="config-frame" class="member inherited"><a href="Ext.form.field.Text.html#config-frame" rel="config-frame" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-frame" class="viewSource">view source</a></div><a name="frame"></a><a name="config-frame"></a><a href="Ext.form.field.Text.html#" rel="config-frame" class="cls expand">frame</a><span> : Boolean</span></div><div class="description"><div class="short">Specify as true to have the Component inject framing elements within the Component at render time to
442 provide a graphi...</div><div class="long"><p>Specify as <code>true</code> to have the Component inject framing elements within the Component at render time to
443 provide a graphical rounded frame around the Component content.</p>
444
445
446 <p>This is only necessary when running on outdated, or non standard-compliant browsers such as Microsoft's Internet Explorer
447 prior to version 9 which do not support rounded corners natively.</p>
448
449
450 <p>The extra space taken up by this framing is available from the read only property <a href="Ext.form.field.Text.html#frameSize" rel="Ext.form.field.Text#frameSize" class="docClass">frameSize</a>.</p>
451
452 </div></div></div><div id="config-grow" class="member ni"><a href="Ext.form.field.Text.html#config-grow" rel="config-grow" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-grow" class="viewSource">view source</a></div><a name="grow"></a><a name="config-grow"></a><a href="Ext.form.field.Text.html#" rel="config-grow" class="cls expand">grow</a><span> : Boolean</span></div><div class="description"><div class="short"><p><tt>true</tt> if this field should automatically grow and shrink to its content
453 (defaults to <tt>false</tt>)</p>
454 </div><div class="long"><p><tt>true</tt> if this field should automatically grow and shrink to its content
455 (defaults to <tt>false</tt>)</p>
456 </div></div></div><div id="config-growAppend" class="member ni"><a href="Ext.form.field.Text.html#config-growAppend" rel="config-growAppend" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-growAppend" class="viewSource">view source</a></div><a name="growAppend"></a><a name="config-growAppend"></a><a href="Ext.form.field.Text.html#" rel="config-growAppend" class="cls expand">growAppend</a><span> : String</span></div><div class="description"><div class="short">A string that will be appended to the field's current value for the purposes of calculating the target
457 field size. On...</div><div class="long"><p>A string that will be appended to the field's current value for the purposes of calculating the target
458 field size. Only used when the <a href="Ext.form.field.Text.html#grow" rel="Ext.form.field.Text#grow" class="docClass">grow</a> config is <tt>true</tt>. Defaults to a single capital "W"
459 (the widest character in common fonts) to leave enough space for the next typed character and avoid the
460 field value shifting before the width is adjusted.</p>
461 </div></div></div><div id="config-growMax" class="member ni"><a href="Ext.form.field.Text.html#config-growMax" rel="config-growMax" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-growMax" class="viewSource">view source</a></div><a name="growMax"></a><a name="config-growMax"></a><a href="Ext.form.field.Text.html#" rel="config-growMax" class="cls expand">growMax</a><span> : Number</span></div><div class="description"><div class="short"><p>The maximum width to allow when <code><b><a href="Ext.form.field.Text.html#grow" rel="Ext.form.field.Text#grow" class="docClass">grow</a></b> = true</code> (defaults
462 to <tt>800</tt>)</p>
463 </div><div class="long"><p>The maximum width to allow when <code><b><a href="Ext.form.field.Text.html#grow" rel="Ext.form.field.Text#grow" class="docClass">grow</a></b> = true</code> (defaults
464 to <tt>800</tt>)</p>
465 </div></div></div><div id="config-growMin" class="member ni"><a href="Ext.form.field.Text.html#config-growMin" rel="config-growMin" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-growMin" class="viewSource">view source</a></div><a name="growMin"></a><a name="config-growMin"></a><a href="Ext.form.field.Text.html#" rel="config-growMin" class="cls expand">growMin</a><span> : Number</span></div><div class="description"><div class="short"><p>The minimum width to allow when <code><b><a href="Ext.form.field.Text.html#grow" rel="Ext.form.field.Text#grow" class="docClass">grow</a></b> = true</code> (defaults
466 to <tt>30</tt>)</p>
467 </div><div class="long"><p>The minimum width to allow when <code><b><a href="Ext.form.field.Text.html#grow" rel="Ext.form.field.Text#grow" class="docClass">grow</a></b> = true</code> (defaults
468 to <tt>30</tt>)</p>
469 </div></div></div><div id="config-height" class="member inherited"><a href="Ext.form.field.Text.html#config-height" rel="config-height" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-height" class="viewSource">view source</a></div><a name="height"></a><a name="config-height"></a><a href="Ext.form.field.Text.html#" rel="config-height" class="cls expand">height</a><span> : Number</span></div><div class="description"><div class="short"><p>The height of this component in pixels.</p>
470 </div><div class="long"><p>The height of this component in pixels.</p>
471 </div></div></div><div id="config-hidden" class="member inherited"><a href="Ext.form.field.Text.html#config-hidden" rel="config-hidden" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-hidden" class="viewSource">view source</a></div><a name="hidden"></a><a name="config-hidden"></a><a href="Ext.form.field.Text.html#" rel="config-hidden" class="cls expand">hidden</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Defaults to false.</p>
472 </div><div class="long"><p>Defaults to false.</p>
473 </div></div></div><div id="config-hideEmptyLabel" class="member inherited"><a href="Ext.form.field.Text.html#config-hideEmptyLabel" rel="config-hideEmptyLabel" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-hideEmptyLabel" class="viewSource">view source</a></div><a name="hideEmptyLabel"></a><a name="config-hideEmptyLabel"></a><a href="Ext.form.field.Text.html#" rel="config-hideEmptyLabel" class="cls expand">hideEmptyLabel</a><span> : Boolean</span></div><div class="description"><div class="short">When set to true, the label element (fieldLabel and labelSeparator) will be
474 automatically hidden if the fieldLabel is...</div><div class="long"><p>When set to <tt>true</tt>, the label element (<a href="Ext.form.field.Text.html#fieldLabel" rel="Ext.form.field.Text#fieldLabel" class="docClass">fieldLabel</a> and <a href="Ext.form.field.Text.html#labelSeparator" rel="Ext.form.field.Text#labelSeparator" class="docClass">labelSeparator</a>) will be
475 automatically hidden if the <a href="Ext.form.field.Text.html#fieldLabel" rel="Ext.form.field.Text#fieldLabel" class="docClass">fieldLabel</a> is empty. Setting this to <tt>false</tt> will cause the empty
476 label element to be rendered and space to be reserved for it; this is useful if you want a field without a label
477 to line up with other labeled fields in the same form. Defaults to <tt>true</tt>.</p>
478
479
480 <p>If you wish to unconditionall hide the label even if a non-empty fieldLabel is configured, then set
481 the <a href="Ext.form.field.Text.html#hideLabel" rel="Ext.form.field.Text#hideLabel" class="docClass">hideLabel</a> config to <tt>true</tt>.</p>
482
483 </div></div></div><div id="config-hideLabel" class="member inherited"><a href="Ext.form.field.Text.html#config-hideLabel" rel="config-hideLabel" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-hideLabel" class="viewSource">view source</a></div><a name="hideLabel"></a><a name="config-hideLabel"></a><a href="Ext.form.field.Text.html#" rel="config-hideLabel" class="cls expand">hideLabel</a><span> : Boolean</span></div><div class="description"><div class="short">Set to true to completely hide the label element (fieldLabel and labelSeparator).
484 Defaults to false.
485
486
487 Also see hideE...</div><div class="long"><p>Set to <tt>true</tt> to completely hide the label element (<a href="Ext.form.field.Text.html#fieldLabel" rel="Ext.form.field.Text#fieldLabel" class="docClass">fieldLabel</a> and <a href="Ext.form.field.Text.html#labelSeparator" rel="Ext.form.field.Text#labelSeparator" class="docClass">labelSeparator</a>).
488 Defaults to <tt>false</tt>.</p>
489
490
491 <p>Also see <a href="Ext.form.field.Text.html#hideEmptyLabel" rel="Ext.form.field.Text#hideEmptyLabel" class="docClass">hideEmptyLabel</a>, which controls whether space will be reserved for an empty fieldLabel.</p>
492
493 </div></div></div><div id="config-hideMode" class="member inherited"><a href="Ext.form.field.Text.html#config-hideMode" rel="config-hideMode" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-hideMode" class="viewSource">view source</a></div><a name="hideMode"></a><a name="config-hideMode"></a><a href="Ext.form.field.Text.html#" rel="config-hideMode" class="cls expand">hideMode</a><span> : String</span></div><div class="description"><div class="short">A String which specifies how this Component's encapsulating DOM element will be hidden.
494 Values may be
495 'display' : The...</div><div class="long"><p>A String which specifies how this Component's encapsulating DOM element will be hidden.
496 Values may be<div class="mdetail-params"><ul>
497 <li><code>'display'</code> : The Component will be hidden using the <code>display: none</code> style.</li>
498 <li><code>'visibility'</code> : The Component will be hidden using the <code>visibility: hidden</code> style.</li>
499 <li><code>'offsets'</code> : The Component will be hidden by absolutely positioning it out of the visible area of the document. This
500 is useful when a hidden Component must maintain measurable dimensions. Hiding using <code>display</code> results
501 in a Component having zero dimensions.</li></ul></div>
502 Defaults to <code>'display'</code>.</p>
503 </div></div></div><div id="config-html" class="member inherited"><a href="Ext.form.field.Text.html#config-html" rel="config-html" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-html" class="viewSource">view source</a></div><a name="html"></a><a name="config-html"></a><a href="Ext.form.field.Text.html#" rel="config-html" class="cls expand">html</a><span> : String/Object</span></div><div class="description"><div class="short">An HTML fragment, or a DomHelper specification to use as the layout element
504 content (defaults to ''). The HTML conten...</div><div class="long"><p>An HTML fragment, or a <a href="Ext.core.DomHelper.html" rel="Ext.core.DomHelper" class="docClass">DomHelper</a> specification to use as the layout element
505 content (defaults to ''). The HTML content is added after the component is rendered,
506 so the document will not contain this HTML at the time the <a href="Ext.form.field.Text.html#render" rel="Ext.form.field.Text#render" class="docClass">render</a> event is fired.
507 This content is inserted into the body <i>before</i> any configured <a href="Ext.form.field.Text.html#contentEl" rel="Ext.form.field.Text#contentEl" class="docClass">contentEl</a> is appended.</p>
508 </div></div></div><div id="config-id" class="member inherited"><a href="Ext.form.field.Text.html#config-id" rel="config-id" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-id" class="viewSource">view source</a></div><a name="id"></a><a name="config-id"></a><a href="Ext.form.field.Text.html#" rel="config-id" class="cls expand">id</a><span> : String</span></div><div class="description"><div class="short">The unique id of this component instance (defaults to an auto-assigned id).
509
510
511 It should not be necessary to use this ...</div><div class="long"><p>The <b><u>unique id of this component instance</u></b> (defaults to an <a href="Ext.form.field.Text.html#getId" rel="Ext.form.field.Text#getId" class="docClass">auto-assigned id</a>).</p>
512
513
514 <p>It should not be necessary to use this configuration except for singleton objects in your application.
515 Components created with an id may be accessed globally using <a href="Ext.html#getCmp" rel="Ext#getCmp" class="docClass">Ext.getCmp</a>.</p>
516
517
518 <p>Instead of using assigned ids, use the <a href="Ext.form.field.Text.html#itemId" rel="Ext.form.field.Text#itemId" class="docClass">itemId</a> config, and <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> which
519 provides selector-based searching for Sencha Components analogous to DOM querying. The <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Container</a>
520 class contains <a href="Ext.container.Container.html#down" rel="Ext.container.Container#down" class="docClass">shortcut methods</a> to query its descendant Components by selector.</p>
521
522
523 <p>Note that this id will also be used as the element id for the containing HTML element
524 that is rendered to the page for this component. This allows you to write id-based CSS
525 rules to style the specific instance of this component uniquely, and also to select
526 sub-elements using this component's id as the parent.</p>
527
528
529 <p><b>Note</b>: to avoid complications imposed by a unique <tt>id</tt> also see <code><a href="Ext.form.field.Text.html#itemId" rel="Ext.form.field.Text#itemId" class="docClass">itemId</a></code>.</p>
530
531
532 <p><b>Note</b>: to access the container of a Component see <code><a href="Ext.form.field.Text.html#ownerCt" rel="Ext.form.field.Text#ownerCt" class="docClass">ownerCt</a></code>.</p>
533
534 </div></div></div><div id="config-inputId" class="member inherited"><a href="Ext.form.field.Text.html#config-inputId" rel="config-inputId" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-inputId" class="viewSource">view source</a></div><a name="inputId"></a><a name="config-inputId"></a><a href="Ext.form.field.Text.html#" rel="config-inputId" class="cls expand">inputId</a><span> : String</span></div><div class="description"><div class="short">The id that will be given to the generated input DOM element. Defaults to an automatically generated id.
535 If you confi...</div><div class="long"><p>The id that will be given to the generated input DOM element. Defaults to an automatically generated id.
536 If you configure this manually, you must make sure it is unique in the document.</p>
537 </div></div></div><div id="config-inputType" class="member inherited"><a href="Ext.form.field.Text.html#config-inputType" rel="config-inputType" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-inputType" class="viewSource">view source</a></div><a name="inputType"></a><a name="config-inputType"></a><a href="Ext.form.field.Text.html#" rel="config-inputType" class="cls expand">inputType</a><span> : String</span></div><div class="description"><div class="short">The type attribute for input fields -- e.g. radio, text, password, file (defaults to 'text').
538 The extended types supp...</div><div class="long"><p>The type attribute for input fields -- e.g. radio, text, password, file (defaults to <tt>'text'</tt>).
539 The extended types supported by HTML5 inputs (url, email, etc.) may also be used, though using them
540 will cause older browsers to fall back to 'text'.</p>
541
542
543 <p>The type 'password' must be used to render that field type currently -- there is no separate <a href="Ext.html" rel="Ext" class="docClass">Ext</a>
544 component for that. You can use <a href="Ext.form.field.File.html" rel="Ext.form.field.File" class="docClass">Ext.form.field.File</a> which creates a custom-rendered file upload
545 field, but if you want a plain unstyled file input you can use a BaseField with inputType:'file'.</p>
546
547 </div></div></div><div id="config-invalidCls" class="member inherited"><a href="Ext.form.field.Text.html#config-invalidCls" rel="config-invalidCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-invalidCls" class="viewSource">view source</a></div><a name="invalidCls"></a><a name="config-invalidCls"></a><a href="Ext.form.field.Text.html#" rel="config-invalidCls" class="cls expand">invalidCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to use when marking the component invalid (defaults to 'x-form-invalid')</p>
548 </div><div class="long"><p>The CSS class to use when marking the component invalid (defaults to 'x-form-invalid')</p>
549 </div></div></div><div id="config-invalidText" class="member inherited"><a href="Ext.form.field.Text.html#config-invalidText" rel="config-invalidText" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-invalidText" class="viewSource">view source</a></div><a name="invalidText"></a><a name="config-invalidText"></a><a href="Ext.form.field.Text.html#" rel="config-invalidText" class="cls expand">invalidText</a><span> : String</span></div><div class="description"><div class="short">The error text to use when marking a field invalid and no message is provided
550 (defaults to 'The value in this field i...</div><div class="long"><p>The error text to use when marking a field invalid and no message is provided
551 (defaults to 'The value in this field is invalid')</p>
552 </div></div></div><div id="config-itemId" class="member inherited"><a href="Ext.form.field.Text.html#config-itemId" rel="config-itemId" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-itemId" class="viewSource">view source</a></div><a name="itemId"></a><a name="config-itemId"></a><a href="Ext.form.field.Text.html#" rel="config-itemId" class="cls expand">itemId</a><span> : String</span></div><div class="description"><div class="short">An itemId can be used as an alternative way to get a reference to a component
553 when no object reference is available. ...</div><div class="long"><p>An <tt>itemId</tt> can be used as an alternative way to get a reference to a component
554 when no object reference is available.  Instead of using an <code><a href="Ext.form.field.Text.html#id" rel="Ext.form.field.Text#id" class="docClass">id</a></code> with
555 <a href="Ext.html" rel="Ext" class="docClass">Ext</a>.<a href="Ext.html#getCmp" rel="Ext#getCmp" class="docClass">getCmp</a>, use <code>itemId</code> with
556 <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Ext.container.Container</a>.<a href="Ext.container.Container.html#getComponent" rel="Ext.container.Container#getComponent" class="docClass">getComponent</a> which will retrieve
557 <code>itemId</code>'s or <tt><a href="Ext.form.field.Text.html#id" rel="Ext.form.field.Text#id" class="docClass">id</a></tt>'s. Since <code>itemId</code>'s are an index to the
558 container's internal MixedCollection, the <code>itemId</code> is scoped locally to the container --
559 avoiding potential conflicts with <a href="Ext.ComponentManager.html" rel="Ext.ComponentManager" class="docClass">Ext.ComponentManager</a> which requires a <b>unique</b>
560 <code><a href="Ext.form.field.Text.html#id" rel="Ext.form.field.Text#id" class="docClass">id</a></code>.</p>
561
562
563 <pre><code>var c = new Ext.panel.Panel({ //
564     <a href="Ext.Component.html#height" rel="Ext.Component#height" class="docClass">height</a>: 300,
565     <a href="Ext.form.field.Text.html#renderTo" rel="Ext.form.field.Text#renderTo" class="docClass">renderTo</a>: document.body,
566     <a href="Ext.container.Container.html#layout" rel="Ext.container.Container#layout" class="docClass">layout</a>: 'auto',
567     <a href="Ext.container.Container.html#items" rel="Ext.container.Container#items" class="docClass">items</a>: [
568         {
569             itemId: 'p1',
570             <a href="Ext.panel.Panel.html#title" rel="Ext.panel.Panel#title" class="docClass">title</a>: 'Panel 1',
571             <a href="Ext.Component.html#height" rel="Ext.Component#height" class="docClass">height</a>: 150
572         },
573         {
574             itemId: 'p2',
575             <a href="Ext.panel.Panel.html#title" rel="Ext.panel.Panel#title" class="docClass">title</a>: 'Panel 2',
576             <a href="Ext.Component.html#height" rel="Ext.Component#height" class="docClass">height</a>: 150
577         }
578     ]
579 })
580 p1 = c.<a href="Ext.container.Container.html#getComponent" rel="Ext.container.Container#getComponent" class="docClass">getComponent</a>('p1'); // not the same as <a href="Ext.html#getCmp" rel="Ext#getCmp" class="docClass">Ext.getCmp()</a>
581 p2 = p1.<a href="Ext.form.field.Text.html#ownerCt" rel="Ext.form.field.Text#ownerCt" class="docClass">ownerCt</a>.<a href="Ext.container.Container.html#getComponent" rel="Ext.container.Container#getComponent" class="docClass">getComponent</a>('p2'); // reference via a sibling
582 </code></pre>
583
584
585 <p>Also see <tt><a href="Ext.form.field.Text.html#id" rel="Ext.form.field.Text#id" class="docClass">id</a></tt>, <code><a href="Ext.form.field.Text.html#query" rel="Ext.form.field.Text#query" class="docClass">query</a></code>, <code><a href="Ext.form.field.Text.html#down" rel="Ext.form.field.Text#down" class="docClass">down</a></code> and <code><a href="Ext.form.field.Text.html#child" rel="Ext.form.field.Text#child" class="docClass">child</a></code>.</p>
586
587
588 <p><b>Note</b>: to access the container of an item see <tt><a href="Ext.form.field.Text.html#ownerCt" rel="Ext.form.field.Text#ownerCt" class="docClass">ownerCt</a></tt>.</p>
589
590 </div></div></div><div id="config-labelAlign" class="member inherited"><a href="Ext.form.field.Text.html#config-labelAlign" rel="config-labelAlign" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelAlign" class="viewSource">view source</a></div><a name="labelAlign"></a><a name="config-labelAlign"></a><a href="Ext.form.field.Text.html#" rel="config-labelAlign" class="cls expand">labelAlign</a><span> : String</span></div><div class="description"><div class="short">Controls the position and alignment of the fieldLabel. Valid values are:
591
592
593
594 "left" (the default) - The label is posit...</div><div class="long"><p>Controls the position and alignment of the <a href="Ext.form.field.Text.html#fieldLabel" rel="Ext.form.field.Text#fieldLabel" class="docClass">fieldLabel</a>. Valid values are:</p>
595
596
597 <ul>
598 <li><tt>"left"</tt> (the default) - The label is positioned to the left of the field, with its text
599 aligned to the left. Its width is determined by the <a href="Ext.form.field.Text.html#labelWidth" rel="Ext.form.field.Text#labelWidth" class="docClass">labelWidth</a> config.</li>
600 <li><tt>"top"</tt> - The label is positioned above the field.</li>
601 <li><tt>"right"</tt> - The label is positioned to the left of the field, with its text aligned
602 to the right. Its width is determined by the <a href="Ext.form.field.Text.html#labelWidth" rel="Ext.form.field.Text#labelWidth" class="docClass">labelWidth</a> config.</li>
603 </ul>
604
605 </div></div></div><div id="config-labelCls" class="member inherited"><a href="Ext.form.field.Text.html#config-labelCls" rel="config-labelCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelCls" class="viewSource">view source</a></div><a name="labelCls"></a><a name="config-labelCls"></a><a href="Ext.form.field.Text.html#" rel="config-labelCls" class="cls expand">labelCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class to be applied to the label element. Defaults to 'x-form-item-label'.</p>
606 </div><div class="long"><p>The CSS class to be applied to the label element. Defaults to 'x-form-item-label'.</p>
607 </div></div></div><div id="config-labelPad" class="member inherited"><a href="Ext.form.field.Text.html#config-labelPad" rel="config-labelPad" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelPad" class="viewSource">view source</a></div><a name="labelPad"></a><a name="config-labelPad"></a><a href="Ext.form.field.Text.html#" rel="config-labelPad" class="cls expand">labelPad</a><span> : Number</span></div><div class="description"><div class="short"><p>The amount of space in pixels between the <a href="Ext.form.field.Text.html#fieldLabel" rel="Ext.form.field.Text#fieldLabel" class="docClass">fieldLabel</a> and the input field. Defaults to <tt>5</tt>.</p>
608 </div><div class="long"><p>The amount of space in pixels between the <a href="Ext.form.field.Text.html#fieldLabel" rel="Ext.form.field.Text#fieldLabel" class="docClass">fieldLabel</a> and the input field. Defaults to <tt>5</tt>.</p>
609 </div></div></div><div id="config-labelSeparator" class="member inherited"><a href="Ext.form.field.Text.html#config-labelSeparator" rel="config-labelSeparator" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelSeparator" class="viewSource">view source</a></div><a name="labelSeparator"></a><a name="config-labelSeparator"></a><a href="Ext.form.field.Text.html#" rel="config-labelSeparator" class="cls expand">labelSeparator</a><span> : String</span></div><div class="description"><div class="short"><p>Character(s) to be inserted at the end of the <a href="Ext.form.field.Text.html#fieldLabel" rel="Ext.form.field.Text#fieldLabel" class="docClass">label text</a>.</p>
610 </div><div class="long"><p>Character(s) to be inserted at the end of the <a href="Ext.form.field.Text.html#fieldLabel" rel="Ext.form.field.Text#fieldLabel" class="docClass">label text</a>.</p>
611 </div></div></div><div id="config-labelStyle" class="member inherited"><a href="Ext.form.field.Text.html#config-labelStyle" rel="config-labelStyle" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelStyle" class="viewSource">view source</a></div><a name="labelStyle"></a><a name="config-labelStyle"></a><a href="Ext.form.field.Text.html#" rel="config-labelStyle" class="cls expand">labelStyle</a><span> : String</span></div><div class="description"><div class="short"><p>A CSS style specification string to apply directly to this field's label. Defaults to undefined.</p>
612
613 </div><div class="long"><p>A CSS style specification string to apply directly to this field's label. Defaults to undefined.</p>
614
615 </div></div></div><div id="config-labelWidth" class="member inherited"><a href="Ext.form.field.Text.html#config-labelWidth" rel="config-labelWidth" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelWidth" class="viewSource">view source</a></div><a name="labelWidth"></a><a name="config-labelWidth"></a><a href="Ext.form.field.Text.html#" rel="config-labelWidth" class="cls expand">labelWidth</a><span> : Number</span></div><div class="description"><div class="short"><p>The width of the <a href="Ext.form.field.Text.html#fieldLabel" rel="Ext.form.field.Text#fieldLabel" class="docClass">fieldLabel</a> in pixels. Only applicable if the <a href="Ext.form.field.Text.html#labelAlign" rel="Ext.form.field.Text#labelAlign" class="docClass">labelAlign</a> is set
616 to "left" or "right". Defaults to <tt>100</tt>.</p>
617 </div><div class="long"><p>The width of the <a href="Ext.form.field.Text.html#fieldLabel" rel="Ext.form.field.Text#fieldLabel" class="docClass">fieldLabel</a> in pixels. Only applicable if the <a href="Ext.form.field.Text.html#labelAlign" rel="Ext.form.field.Text#labelAlign" class="docClass">labelAlign</a> is set
618 to "left" or "right". Defaults to <tt>100</tt>.</p>
619 </div></div></div><div id="config-labelableRenderTpl" class="member inherited"><a href="Ext.form.field.Text.html#config-labelableRenderTpl" rel="config-labelableRenderTpl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-labelableRenderTpl" class="viewSource">view source</a></div><a name="labelableRenderTpl"></a><a name="config-labelableRenderTpl"></a><a href="Ext.form.field.Text.html#" rel="config-labelableRenderTpl" class="cls expand">labelableRenderTpl</a><span> : Array/String/Ext.XTemplate</span></div><div class="description"><div class="short">The rendering template for the field decorations. Component classes using this mixin should include
620 logic to use this...</div><div class="long"><p>The rendering template for the field decorations. Component classes using this mixin should include
621 logic to use this as their <a href="Ext.AbstractComponent.html#renderTpl" rel="Ext.AbstractComponent#renderTpl" class="docClass">renderTpl</a>, and implement the
622 <a href="Ext.form.field.Text.html#getSubTplMarkup" rel="Ext.form.field.Text#getSubTplMarkup" class="docClass">getSubTplMarkup</a> method to generate the field body content.</p>
623 </div></div></div><div id="config-listeners" class="member inherited"><a href="Ext.form.field.Text.html#config-listeners" rel="config-listeners" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-cfg-listeners" class="viewSource">view source</a></div><a name="listeners"></a><a name="config-listeners"></a><a href="Ext.form.field.Text.html#" rel="config-listeners" class="cls expand">listeners</a><span> : Object</span></div><div class="description"><div class="short">(optional) A config object containing one or more event handlers to be added to this
624 object during initialization.  T...</div><div class="long"><p>(optional) <p>A config object containing one or more event handlers to be added to this
625 object during initialization.  This should be a valid listeners config object as specified in the
626 <a href="Ext.form.field.Text.html#addListener" rel="Ext.form.field.Text#addListener" class="docClass">addListener</a> example for attaching multiple handlers at once.</p></p>
627
628 <br><p><b><u>DOM events from ExtJs <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Components</a></u></b></p>
629
630
631 <br><p>While <i>some</i> ExtJs Component classes export selected DOM events (e.g. "click", "mouseover" etc), this
632
633
634 <p>is usually only done when extra value can be added. For example the <a href="Ext.view.View.html" rel="Ext.view.View" class="docClass">DataView</a>'s
635 <b><code><a href="Ext.view.View.html#click" rel="Ext.view.View#click" class="docClass">click</a></code></b> event passing the node clicked on. To access DOM
636 events directly from a child element of a Component, we need to specify the <code>element</code> option to
637 identify the Component property to add a DOM listener to:</p>
638
639 <pre><code>new Ext.panel.Panel({
640     width: 400,
641     height: 200,
642     dockedItems: [{
643         xtype: 'toolbar'
644     }],
645     listeners: {
646         click: {
647             element: 'el', //bind to the underlying el property on the panel
648             fn: function(){ console.log('click el'); }
649         },
650         dblclick: {
651             element: 'body', //bind to the underlying body property on the panel
652             fn: function(){ console.log('dblclick body'); }
653         }
654     }
655 });
656 </code></pre>
657
658
659 <p></p></p>
660 </div></div></div><div id="config-loader" class="member inherited"><a href="Ext.form.field.Text.html#config-loader" rel="config-loader" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-loader" class="viewSource">view source</a></div><a name="loader"></a><a name="config-loader"></a><a href="Ext.form.field.Text.html#" rel="config-loader" class="cls expand">loader</a><span> : Ext.ComponentLoader/Object</span></div><div class="description"><div class="short"><p>A configuration object or an instance of a <a href="Ext.ComponentLoader.html" rel="Ext.ComponentLoader" class="docClass">Ext.ComponentLoader</a> to load remote
661 content for this Component.</p>
662 </div><div class="long"><p>A configuration object or an instance of a <a href="Ext.ComponentLoader.html" rel="Ext.ComponentLoader" class="docClass">Ext.ComponentLoader</a> to load remote
663 content for this Component.</p>
664 </div></div></div><div id="config-maintainFlex" class="member inherited"><a href="Ext.form.field.Text.html#config-maintainFlex" rel="config-maintainFlex" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-maintainFlex" class="viewSource">view source</a></div><a name="maintainFlex"></a><a name="config-maintainFlex"></a><a href="Ext.form.field.Text.html#" rel="config-maintainFlex" class="cls expand">maintainFlex</a><span> : Boolean</span></div><div class="description"><div class="short">Only valid when a sibling element of a Splitter within a VBox or
665 HBox layout.
666
667
668 Specifies that if an immediate siblin...</div><div class="long"><p><b>Only valid when a sibling element of a <a href="Ext.resizer.Splitter.html" rel="Ext.resizer.Splitter" class="docClass">Splitter</a> within a <a href="Ext.layout.container.VBox.html" rel="Ext.layout.container.VBox" class="docClass">VBox</a> or
669 <a href="Ext.layout.container.HBox.html" rel="Ext.layout.container.HBox" class="docClass">HBox</a> layout.</b></p>
670
671
672 <p>Specifies that if an immediate sibling Splitter is moved, the Component on the <i>other</i> side is resized, and this
673 Component maintains its configured <a href="Ext.layout.container.Box.html#flex" rel="Ext.layout.container.Box#flex" class="docClass">flex</a> value.</p>
674
675 </div></div></div><div id="config-margin" class="member inherited"><a href="Ext.form.field.Text.html#config-margin" rel="config-margin" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-margin" class="viewSource">view source</a></div><a name="margin"></a><a name="config-margin"></a><a href="Ext.form.field.Text.html#" rel="config-margin" class="cls expand">margin</a><span> : Number/String</span></div><div class="description"><div class="short">Specifies the margin for this component. The margin can be a single numeric value to apply to all sides or
676 it can be ...</div><div class="long"><p>Specifies the margin for this component. The margin can be a single numeric value to apply to all sides or
677 it can be a CSS style specification for each style, for example: '10 5 3 10'.</p>
678 </div></div></div><div id="config-maskRe" class="member ni"><a href="Ext.form.field.Text.html#config-maskRe" rel="config-maskRe" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-maskRe" class="viewSource">view source</a></div><a name="maskRe"></a><a name="config-maskRe"></a><a href="Ext.form.field.Text.html#" rel="config-maskRe" class="cls expand">maskRe</a><span> : RegExp</span></div><div class="description"><div class="short"><p>An input mask regular expression that will be used to filter keystrokes that do
679 not match (defaults to <tt>undefined</tt>)</p>
680 </div><div class="long"><p>An input mask regular expression that will be used to filter keystrokes that do
681 not match (defaults to <tt>undefined</tt>)</p>
682 </div></div></div><div id="config-maxHeight" class="member inherited"><a href="Ext.form.field.Text.html#config-maxHeight" rel="config-maxHeight" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-maxHeight" class="viewSource">view source</a></div><a name="maxHeight"></a><a name="config-maxHeight"></a><a href="Ext.form.field.Text.html#" rel="config-maxHeight" class="cls expand">maxHeight</a><span> : Number</span></div><div class="description"><div class="short">The maximum value in pixels which this Component will set its height to.
683
684
685 Warning: This will override any size manag...</div><div class="long"><p>The maximum value in pixels which this Component will set its height to.</p>
686
687
688 <p><b>Warning:</b> This will override any size management applied by layout managers.</p>
689
690 </div></div></div><div id="config-maxLength" class="member ni"><a href="Ext.form.field.Text.html#config-maxLength" rel="config-maxLength" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-maxLength" class="viewSource">view source</a></div><a name="maxLength"></a><a name="config-maxLength"></a><a href="Ext.form.field.Text.html#" rel="config-maxLength" class="cls expand">maxLength</a><span> : Number</span></div><div class="description"><div class="short">Maximum input field length allowed by validation (defaults to Number.MAX_VALUE).
691 This behavior is intended to provide...</div><div class="long"><p>Maximum input field length allowed by validation (defaults to Number.MAX_VALUE).
692 This behavior is intended to provide instant feedback to the user by improving usability to allow pasting
693 and editing or overtyping and back tracking. To restrict the maximum number of characters that can be
694 entered into the field use the <tt><b><a href="Ext.form.field.Text.html#enforceMaxLength" rel="Ext.form.field.Text#enforceMaxLength" class="docClass">enforceMaxLength</a></b></tt> option.</p>
695 </div></div></div><div id="config-maxLengthText" class="member ni"><a href="Ext.form.field.Text.html#config-maxLengthText" rel="config-maxLengthText" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-maxLengthText" class="viewSource">view source</a></div><a name="maxLengthText"></a><a name="config-maxLengthText"></a><a href="Ext.form.field.Text.html#" rel="config-maxLengthText" class="cls expand">maxLengthText</a><span> : String</span></div><div class="description"><div class="short">Error text to display if the maximum length
696 validation fails (defaults to 'The maximum length for this field is {maxL...</div><div class="long"><p>Error text to display if the <b><tt><a href="Ext.form.field.Text.html#maxLength" rel="Ext.form.field.Text#maxLength" class="docClass">maximum length</a></tt></b>
697 validation fails (defaults to <tt>'The maximum length for this field is {maxLength}'</tt>)</p>
698 </div></div></div><div id="config-maxWidth" class="member inherited"><a href="Ext.form.field.Text.html#config-maxWidth" rel="config-maxWidth" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-maxWidth" class="viewSource">view source</a></div><a name="maxWidth"></a><a name="config-maxWidth"></a><a href="Ext.form.field.Text.html#" rel="config-maxWidth" class="cls expand">maxWidth</a><span> : Number</span></div><div class="description"><div class="short">The maximum value in pixels which this Component will set its width to.
699
700
701 Warning: This will override any size manage...</div><div class="long"><p>The maximum value in pixels which this Component will set its width to.</p>
702
703
704 <p><b>Warning:</b> This will override any size management applied by layout managers.</p>
705
706 </div></div></div><div id="config-minHeight" class="member inherited"><a href="Ext.form.field.Text.html#config-minHeight" rel="config-minHeight" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-minHeight" class="viewSource">view source</a></div><a name="minHeight"></a><a name="config-minHeight"></a><a href="Ext.form.field.Text.html#" rel="config-minHeight" class="cls expand">minHeight</a><span> : Number</span></div><div class="description"><div class="short">The minimum value in pixels which this Component will set its height to.
707
708
709 Warning: This will override any size manag...</div><div class="long"><p>The minimum value in pixels which this Component will set its height to.</p>
710
711
712 <p><b>Warning:</b> This will override any size management applied by layout managers.</p>
713
714 </div></div></div><div id="config-minLength" class="member ni"><a href="Ext.form.field.Text.html#config-minLength" rel="config-minLength" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-minLength" class="viewSource">view source</a></div><a name="minLength"></a><a name="config-minLength"></a><a href="Ext.form.field.Text.html#" rel="config-minLength" class="cls expand">minLength</a><span> : Number</span></div><div class="description"><div class="short"><p>Minimum input field length required (defaults to <tt>0</tt>)</p>
715 </div><div class="long"><p>Minimum input field length required (defaults to <tt>0</tt>)</p>
716 </div></div></div><div id="config-minLengthText" class="member ni"><a href="Ext.form.field.Text.html#config-minLengthText" rel="config-minLengthText" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-minLengthText" class="viewSource">view source</a></div><a name="minLengthText"></a><a name="config-minLengthText"></a><a href="Ext.form.field.Text.html#" rel="config-minLengthText" class="cls expand">minLengthText</a><span> : String</span></div><div class="description"><div class="short">Error text to display if the minimum length
717 validation fails (defaults to 'The minimum length for this field is {minL...</div><div class="long"><p>Error text to display if the <b><tt><a href="Ext.form.field.Text.html#minLength" rel="Ext.form.field.Text#minLength" class="docClass">minimum length</a></tt></b>
718 validation fails (defaults to <tt>'The minimum length for this field is {minLength}'</tt>)</p>
719 </div></div></div><div id="config-minWidth" class="member inherited"><a href="Ext.form.field.Text.html#config-minWidth" rel="config-minWidth" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-minWidth" class="viewSource">view source</a></div><a name="minWidth"></a><a name="config-minWidth"></a><a href="Ext.form.field.Text.html#" rel="config-minWidth" class="cls expand">minWidth</a><span> : Number</span></div><div class="description"><div class="short">The minimum value in pixels which this Component will set its width to.
720
721
722 Warning: This will override any size manage...</div><div class="long"><p>The minimum value in pixels which this Component will set its width to.</p>
723
724
725 <p><b>Warning:</b> This will override any size management applied by layout managers.</p>
726
727 </div></div></div><div id="config-msgTarget" class="member inherited"><a href="Ext.form.field.Text.html#config-msgTarget" rel="config-msgTarget" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-msgTarget" class="viewSource">view source</a></div><a name="msgTarget"></a><a name="config-msgTarget"></a><a href="Ext.form.field.Text.html#" rel="config-msgTarget" class="cls expand">msgTarget</a><span> : String</span></div><div class="description"><div class="short">The location where the error message text should display.
728 Must be one of the following values:
729
730
731
732 qtip Display a quic...</div><div class="long"><p>The location where the error message text should display.
733 Must be one of the following values:</p>
734
735
736 <div class="mdetail-params"><ul>
737 <li><code>qtip</code> Display a quick tip containing the message when the user hovers over the field. This is the default.
738 <div class="subdesc"><b><a href="Ext.tip.QuickTipManager.html#init" rel="Ext.tip.QuickTipManager#init" class="docClass">Ext.tip.QuickTipManager.init</a> must have been called for this setting to work.</b></div></li>
739 <li><code>title</code> Display the message in a default browser title attribute popup.</li>
740 <li><code>under</code> Add a block div beneath the field containing the error message.</li>
741 <li><code>side</code> Add an error icon to the right of the field, displaying the message in a popup on hover.</li>
742 <li><code>none</code> Don't display any error message. This might be useful if you are implementing custom error display.</li>
743 <li><code>[element id]</code> Add the error message directly to the innerHTML of the specified element.</li>
744 </ul></div>
745
746 </div></div></div><div id="config-name" class="member inherited"><a href="Ext.form.field.Text.html#config-name" rel="config-name" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-cfg-name" class="viewSource">view source</a></div><a name="name"></a><a name="config-name"></a><a href="Ext.form.field.Text.html#" rel="config-name" class="cls expand">name</a><span> : String</span></div><div class="description"><div class="short">The name of the field (defaults to undefined). By default this is used as the parameter
747 name when including the field...</div><div class="long"><p>The name of the field (defaults to undefined). By default this is used as the parameter
748 name when including the <a href="Ext.form.field.Text.html#getSubmitData" rel="Ext.form.field.Text#getSubmitData" class="docClass">field value</a> in a <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">form submit()</a>.
749 To prevent the field from being included in the form submit, set <a href="Ext.form.field.Text.html#submitValue" rel="Ext.form.field.Text#submitValue" class="docClass">submitValue</a> to <tt>false</tt>.</p>
750 </div></div></div><div id="config-overCls" class="member inherited"><a href="Ext.form.field.Text.html#config-overCls" rel="config-overCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-overCls" class="viewSource">view source</a></div><a name="overCls"></a><a name="config-overCls"></a><a href="Ext.form.field.Text.html#" rel="config-overCls" class="cls expand">overCls</a><span> : String</span></div><div class="description"><div class="short">An optional extra CSS class that will be added to this component's Element when the mouse moves
751 over the Element, and...</div><div class="long"><p>An optional extra CSS class that will be added to this component's Element when the mouse moves
752 over the Element, and removed when the mouse moves out. (defaults to '').  This can be
753 useful for adding customized 'active' or 'hover' styles to the component or any of its children using standard CSS rules.</p>
754 </div></div></div><div id="config-padding" class="member inherited"><a href="Ext.form.field.Text.html#config-padding" rel="config-padding" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-padding" class="viewSource">view source</a></div><a name="padding"></a><a name="config-padding"></a><a href="Ext.form.field.Text.html#" rel="config-padding" class="cls expand">padding</a><span> : Number/String</span></div><div class="description"><div class="short">Specifies the padding for this component. The padding can be a single numeric value to apply to all sides or
755 it can b...</div><div class="long"><p>Specifies the padding for this component. The padding can be a single numeric value to apply to all sides or
756 it can be a CSS style specification for each style, for example: '10 5 3 10'.</p>
757 </div></div></div><div id="config-plugins" class="member inherited"><a href="Ext.form.field.Text.html#config-plugins" rel="config-plugins" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-plugins" class="viewSource">view source</a></div><a name="plugins"></a><a name="config-plugins"></a><a href="Ext.form.field.Text.html#" rel="config-plugins" class="cls expand">plugins</a><span> : Object/Array</span></div><div class="description"><div class="short">An object or array of objects that will provide custom functionality for this component.  The only
758 requirement for a ...</div><div class="long"><p>An object or array of objects that will provide custom functionality for this component.  The only
759 requirement for a valid plugin is that it contain an init method that accepts a reference of type <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a>.
760 When a component is created, if any plugins are available, the component will call the init method on each
761 plugin, passing a reference to itself.  Each plugin can then call methods or respond to events on the
762 component as needed to provide its functionality.</p>
763 </div></div></div><div id="config-preventMark" class="member inherited"><a href="Ext.form.field.Text.html#config-preventMark" rel="config-preventMark" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-cfg-preventMark" class="viewSource">view source</a></div><a name="preventMark"></a><a name="config-preventMark"></a><a href="Ext.form.field.Text.html#" rel="config-preventMark" class="cls expand">preventMark</a><span> : Boolean</span></div><div class="description"><div class="short"><p><tt>true</tt> to disable displaying any <a href="Ext.form.field.Text.html#setActiveError" rel="Ext.form.field.Text#setActiveError" class="docClass">error message</a> set on this object.
764 Defaults to <tt>false</tt>.</p>
765 </div><div class="long"><p><tt>true</tt> to disable displaying any <a href="Ext.form.field.Text.html#setActiveError" rel="Ext.form.field.Text#setActiveError" class="docClass">error message</a> set on this object.
766 Defaults to <tt>false</tt>.</p>
767 </div></div></div><div id="config-readOnly" class="member inherited"><a href="Ext.form.field.Text.html#config-readOnly" rel="config-readOnly" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-readOnly" class="viewSource">view source</a></div><a name="readOnly"></a><a name="config-readOnly"></a><a href="Ext.form.field.Text.html#" rel="config-readOnly" class="cls expand">readOnly</a><span> : Boolean</span></div><div class="description"><div class="short">true to mark the field as readOnly in HTML
768 (defaults to false).
769
770 Note: this only sets the element's readOnly DOM attr...</div><div class="long"><p><tt>true</tt> to mark the field as readOnly in HTML
771 (defaults to <tt>false</tt>).</p>
772
773 <br><p><b>Note</b>: this only sets the element's readOnly DOM attribute.
774
775
776 <p>Setting <code>readOnly=true</code>, for example, will not disable triggering a
777 ComboBox or Date; it gives you the option of forcing the user to choose
778 via the trigger without typing in the text box. To hide the trigger use
779 <code><a href="Ext.form.field.Trigger.html#hideTrigger" rel="Ext.form.field.Trigger#hideTrigger" class="docClass">hideTrigger</a></code>.</p></p>
780 </div></div></div><div id="config-readOnlyCls" class="member inherited"><a href="Ext.form.field.Text.html#config-readOnlyCls" rel="config-readOnlyCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-readOnlyCls" class="viewSource">view source</a></div><a name="readOnlyCls"></a><a name="config-readOnlyCls"></a><a href="Ext.form.field.Text.html#" rel="config-readOnlyCls" class="cls expand">readOnlyCls</a><span> : String</span></div><div class="description"><div class="short"><p>The CSS class applied to the component's main element when it is <a href="Ext.form.field.Text.html#readOnly" rel="Ext.form.field.Text#readOnly" class="docClass">readOnly</a>.</p>
781 </div><div class="long"><p>The CSS class applied to the component's main element when it is <a href="Ext.form.field.Text.html#readOnly" rel="Ext.form.field.Text#readOnly" class="docClass">readOnly</a>.</p>
782 </div></div></div><div id="config-regex" class="member ni"><a href="Ext.form.field.Text.html#config-regex" rel="config-regex" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-regex" class="viewSource">view source</a></div><a name="regex"></a><a name="config-regex"></a><a href="Ext.form.field.Text.html#" rel="config-regex" class="cls expand">regex</a><span> : RegExp</span></div><div class="description"><div class="short">A JavaScript RegExp object to be tested against the field value during validation
783 (defaults to undefined). If the tes...</div><div class="long"><p>A JavaScript RegExp object to be tested against the field value during validation
784 (defaults to <tt>undefined</tt>). If the test fails, the field will be marked invalid using
785 <b><tt><a href="Ext.form.field.Text.html#regexText" rel="Ext.form.field.Text#regexText" class="docClass">regexText</a></tt></b>.</p>
786 </div></div></div><div id="config-regexText" class="member ni"><a href="Ext.form.field.Text.html#config-regexText" rel="config-regexText" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-regexText" class="viewSource">view source</a></div><a name="regexText"></a><a name="config-regexText"></a><a href="Ext.form.field.Text.html#" rel="config-regexText" class="cls expand">regexText</a><span> : String</span></div><div class="description"><div class="short"><p>The error text to display if <b><tt><a href="Ext.form.field.Text.html#regex" rel="Ext.form.field.Text#regex" class="docClass">regex</a></tt></b> is used and the
787 test fails during validation (defaults to <tt>''</tt>)</p>
788 </div><div class="long"><p>The error text to display if <b><tt><a href="Ext.form.field.Text.html#regex" rel="Ext.form.field.Text#regex" class="docClass">regex</a></tt></b> is used and the
789 test fails during validation (defaults to <tt>''</tt>)</p>
790 </div></div></div><div id="config-renderSelectors" class="member inherited"><a href="Ext.form.field.Text.html#config-renderSelectors" rel="config-renderSelectors" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-renderSelectors" class="viewSource">view source</a></div><a name="renderSelectors"></a><a name="config-renderSelectors"></a><a href="Ext.form.field.Text.html#" rel="config-renderSelectors" class="cls expand">renderSelectors</a><span> : Object</span></div><div class="description"><div class="short">An object containing properties specifying DomQuery selectors which identify child elements
791 created by the render pro...</div><div class="long"><p>An object containing properties specifying <a href="Ext.DomQuery.html" rel="Ext.DomQuery" class="docClass">DomQuery</a> selectors which identify child elements
792 created by the render process.</p>
793
794 <p>After the Component's internal structure is rendered according to the <a href="Ext.form.field.Text.html#renderTpl" rel="Ext.form.field.Text#renderTpl" class="docClass">renderTpl</a>, this object is iterated through,
795 and the found Elements are added as properties to the Component using the <code>renderSelector</code> property name.</p>
796
797 <p>For example, a Component which rendered an image, and description into its element might use the following properties
798 coded into its prototype:</p>
799
800 <pre><code>renderTpl: '&amp;lt;img src="{imageUrl}" class="x-image-component-img"&gt;&amp;lt;div class="x-image-component-desc"&gt;{description}&amp;gt;/div&amp;lt;',
801
802 renderSelectors: {
803     image: 'img.x-image-component-img',
804     descEl: 'div.x-image-component-desc'
805 }
806 </code></pre>
807
808 <p>After rendering, the Component would have a property <code>image</code> referencing its child <code>img</code> Element,
809 and a property <code>descEl</code> referencing the <code>div</code> Element which contains the description.</p>
810 </div></div></div><div id="config-renderTo" class="member inherited"><a href="Ext.form.field.Text.html#config-renderTo" rel="config-renderTo" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-renderTo" class="viewSource">view source</a></div><a name="renderTo"></a><a name="config-renderTo"></a><a href="Ext.form.field.Text.html#" rel="config-renderTo" class="cls expand">renderTo</a><span> : Mixed</span></div><div class="description"><div class="short">Specify the id of the element, a DOM element or an existing Element that this component
811 will be rendered into.
812
813
814
815 Not...</div><div class="long"><p>Specify the id of the element, a DOM element or an existing Element that this component
816 will be rendered into.</p>
817
818
819 <div><ul>
820 <li><b>Notes</b> : <ul>
821 <div class="sub-desc">Do <u>not</u> use this option if the Component is to be a child item of
822 a <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Container</a>. It is the responsibility of the
823 <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Container</a>'s <a href="Ext.container.Container.html#layout" rel="Ext.container.Container#layout" class="docClass">layout manager</a>
824 to render and manage its child items.</div>
825 <div class="sub-desc">When using this config, a call to render() is not required.</div>
826 </ul></li>
827 </ul></div>
828
829
830 <p>See <code><a href="Ext.form.field.Text.html#render" rel="Ext.form.field.Text#render" class="docClass">render</a></code> also.</p>
831
832 </div></div></div><div id="config-renderTpl" class="member inherited"><a href="Ext.form.field.Text.html#config-renderTpl" rel="config-renderTpl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-renderTpl" class="viewSource">view source</a></div><a name="renderTpl"></a><a name="config-renderTpl"></a><a href="Ext.form.field.Text.html#" rel="config-renderTpl" class="cls expand">renderTpl</a><span> : Mixed</span></div><div class="description"><div class="short">An XTemplate used to create the internal structure inside this Component's
833 encapsulating Element.
834
835
836 You do not normal...</div><div class="long"><p>An <a href="Ext.XTemplate.html" rel="Ext.XTemplate" class="docClass">XTemplate</a> used to create the internal structure inside this Component's
837 encapsulating <a href="Ext.form.field.Text.html#getEl" rel="Ext.form.field.Text#getEl" class="docClass">Element</a>.</p>
838
839
840 <p>You do not normally need to specify this. For the base classes <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a>
841 and <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Ext.container.Container</a>, this defaults to <b><code>null</code></b> which means that they will be initially rendered
842 with no internal structure; they render their <a href="Ext.form.field.Text.html#getEl" rel="Ext.form.field.Text#getEl" class="docClass">Element</a> empty. The more specialized ExtJS and Touch classes
843 which use a more complex DOM structure, provide their own template definitions.</p>
844
845
846 <p>This is intended to allow the developer to create application-specific utility Components with customized
847 internal structure.</p>
848
849
850 <p>Upon rendering, any created child elements may be automatically imported into object properties using the
851 <a href="Ext.form.field.Text.html#renderSelectors" rel="Ext.form.field.Text#renderSelectors" class="docClass">renderSelectors</a> option.</p>
852
853 </div></div></div><div id="config-resizable" class="member inherited"><a href="Ext.form.field.Text.html#config-resizable" rel="config-resizable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-resizable" class="viewSource">view source</a></div><a name="resizable"></a><a name="config-resizable"></a><a href="Ext.form.field.Text.html#" rel="config-resizable" class="cls expand">resizable</a><span> : Mixed</span></div><div class="description"><div class="short">Specify as true to apply a Resizer to this Component
854 after rendering.
855
856
857 May also be specified as a config object to b...</div><div class="long"><p>Specify as <code>true</code> to apply a <a href="Ext.resizer.Resizer.html" rel="Ext.resizer.Resizer" class="docClass">Resizer</a> to this Component
858 after rendering.</p>
859
860
861 <p>May also be specified as a config object to be passed to the constructor of <a href="Ext.resizer.Resizer.html" rel="Ext.resizer.Resizer" class="docClass">Resizer</a>
862 to override any defaults. By default the Component passes its minimum and maximum size, and uses
863 <code><a href="Ext.resizer.Resizer.html#dynamic" rel="Ext.resizer.Resizer#dynamic" class="docClass">Ext.resizer.Resizer.dynamic</a>: false</code></p>
864
865 </div></div></div><div id="config-resizeHandles" class="member inherited"><a href="Ext.form.field.Text.html#config-resizeHandles" rel="config-resizeHandles" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-resizeHandles" class="viewSource">view source</a></div><a name="resizeHandles"></a><a name="config-resizeHandles"></a><a href="Ext.form.field.Text.html#" rel="config-resizeHandles" class="cls expand">resizeHandles</a><span> : String</span></div><div class="description"><div class="short"><p>A valid <a href="Ext.resizer.Resizer.html" rel="Ext.resizer.Resizer" class="docClass">Ext.resizer.Resizer</a> handles config string (defaults to 'all').  Only applies when resizable = true.</p>
866 </div><div class="long"><p>A valid <a href="Ext.resizer.Resizer.html" rel="Ext.resizer.Resizer" class="docClass">Ext.resizer.Resizer</a> handles config string (defaults to 'all').  Only applies when resizable = true.</p>
867 </div></div></div><div id="config-saveBuffer" class="member inherited"><a href="Ext.form.field.Text.html#config-saveBuffer" rel="config-saveBuffer" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-cfg-saveBuffer" class="viewSource">view source</a></div><a name="saveBuffer"></a><a name="config-saveBuffer"></a><a href="Ext.form.field.Text.html#" rel="config-saveBuffer" class="cls expand">saveBuffer</a><span> : Number</span></div><div class="description"><div class="short"><p>A buffer to be applied if many state events are fired within
868 a short period. Defaults to 100.</p>
869 </div><div class="long"><p>A buffer to be applied if many state events are fired within
870 a short period. Defaults to 100.</p>
871 </div></div></div><div id="config-selectOnFocus" class="member ni"><a href="Ext.form.field.Text.html#config-selectOnFocus" rel="config-selectOnFocus" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-selectOnFocus" class="viewSource">view source</a></div><a name="selectOnFocus"></a><a name="config-selectOnFocus"></a><a href="Ext.form.field.Text.html#" rel="config-selectOnFocus" class="cls expand">selectOnFocus</a><span> : Boolean</span></div><div class="description"><div class="short"><p><tt>true</tt> to automatically select any existing field text when the field
872 receives input focus (defaults to <tt>false</tt>)</p>
873 </div><div class="long"><p><tt>true</tt> to automatically select any existing field text when the field
874 receives input focus (defaults to <tt>false</tt>)</p>
875 </div></div></div><div id="config-shadow" class="member inherited"><a href="Ext.form.field.Text.html#config-shadow" rel="config-shadow" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-cfg-shadow" class="viewSource">view source</a></div><a name="shadow"></a><a name="config-shadow"></a><a href="Ext.form.field.Text.html#" rel="config-shadow" class="cls expand">shadow</a><span> : String/Boolean</span></div><div class="description"><div class="short">Specifies whether the floating component should be given a shadow. Set to
876 true to automatically create an Ext.Shadow,...</div><div class="long"><p>Specifies whether the floating component should be given a shadow. Set to
877 <tt>true</tt> to automatically create an <a href="Ext.Shadow.html" rel="Ext.Shadow" class="docClass">Ext.Shadow</a>, or a string indicating the
878 shadow's display <a href="Ext.Shadow.html#mode" rel="Ext.Shadow#mode" class="docClass">Ext.Shadow.mode</a>. Set to <tt>false</tt> to disable the shadow.
879 (Defaults to <tt>'sides'</tt>.)</p>
880 </div></div></div><div id="config-size" class="member ni"><a href="Ext.form.field.Text.html#config-size" rel="config-size" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-size" class="viewSource">view source</a></div><a name="size"></a><a name="config-size"></a><a href="Ext.form.field.Text.html#" rel="config-size" class="cls expand">size</a><span> : Number</span></div><div class="description"><div class="short">An initial value for the 'size' attribute on the text input element. This is only
881 used if the field has no configured...</div><div class="long"><p>An initial value for the 'size' attribute on the text input element. This is only
882 used if the field has no configured <a href="Ext.form.field.Text.html#width" rel="Ext.form.field.Text#width" class="docClass">width</a> and is not given a width by its container's layout.
883 Defaults to <tt>20</tt>.</p>
884 </div></div></div><div id="config-stateEvents" class="member inherited"><a href="Ext.form.field.Text.html#config-stateEvents" rel="config-stateEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-cfg-stateEvents" class="viewSource">view source</a></div><a name="stateEvents"></a><a name="config-stateEvents"></a><a href="Ext.form.field.Text.html#" rel="config-stateEvents" class="cls expand">stateEvents</a><span> : Array</span></div><div class="description"><div class="short">An array of events that, when fired, should trigger this object to
885 save its state (defaults to none). stateEvents may...</div><div class="long"><p>An array of events that, when fired, should trigger this object to
886 save its state (defaults to none). <code>stateEvents</code> may be any type
887 of event supported by this object, including browser or custom events
888 (e.g., <tt>['click', 'customerchange']</tt>).</p>
889
890
891 <p>See <code><a href="Ext.form.field.Text.html#stateful" rel="Ext.form.field.Text#stateful" class="docClass">stateful</a></code> for an explanation of saving and
892 restoring object state.</p>
893
894 </div></div></div><div id="config-stateId" class="member inherited"><a href="Ext.form.field.Text.html#config-stateId" rel="config-stateId" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-cfg-stateId" class="viewSource">view source</a></div><a name="stateId"></a><a name="config-stateId"></a><a href="Ext.form.field.Text.html#" rel="config-stateId" class="cls expand">stateId</a><span> : String</span></div><div class="description"><div class="short">The unique id for this object to use for state management purposes.
895
896 See stateful for an explanation of saving and re...</div><div class="long"><p>The unique id for this object to use for state management purposes.</p>
897
898 <p>See <a href="Ext.form.field.Text.html#stateful" rel="Ext.form.field.Text#stateful" class="docClass">stateful</a> for an explanation of saving and restoring state.</p>
899
900 </div></div></div><div id="config-stateful" class="member inherited"><a href="Ext.form.field.Text.html#config-stateful" rel="config-stateful" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-cfg-stateful" class="viewSource">view source</a></div><a name="stateful"></a><a name="config-stateful"></a><a href="Ext.form.field.Text.html#" rel="config-stateful" class="cls expand">stateful</a><span> : Boolean</span></div><div class="description"><div class="short">A flag which causes the object to attempt to restore the state of
901 internal properties from a saved state on startup. ...</div><div class="long"><p>A flag which causes the object to attempt to restore the state of
902 internal properties from a saved state on startup. The object must have
903 a <code><a href="Ext.form.field.Text.html#stateId" rel="Ext.form.field.Text#stateId" class="docClass">stateId</a></code> for state to be managed. 
904 Auto-generated ids are not guaranteed to be stable across page loads and 
905 cannot be relied upon to save and restore the same state for a object.<p>
906 <p>For state saving to work, the state manager's provider must have been
907 set to an implementation of <a href="Ext.state.Provider.html" rel="Ext.state.Provider" class="docClass">Ext.state.Provider</a> which overrides the
908 <a href="Ext.state.Provider.html#set" rel="Ext.state.Provider#set" class="docClass">set</a> and <a href="Ext.state.Provider.html#get" rel="Ext.state.Provider#get" class="docClass">get</a>
909 methods to save and recall name/value pairs. A built-in implementation,
910 <a href="Ext.state.CookieProvider.html" rel="Ext.state.CookieProvider" class="docClass">Ext.state.CookieProvider</a> is available.</p>
911 <p>To set the state provider for the current page:</p>
912 <pre><code>Ext.state.Manager.setProvider(new Ext.state.CookieProvider({
913     expires: new Date(new Date().getTime()+(1000*60*60*24*7)), //7 days from now
914 }));
915 </code></pre>
916 <p>A stateful object attempts to save state when one of the events
917 listed in the <code><a href="Ext.form.field.Text.html#stateEvents" rel="Ext.form.field.Text#stateEvents" class="docClass">stateEvents</a></code> configuration fires.</p>
918 <p>To save state, a stateful object first serializes its state by
919 calling <b><code><a href="Ext.form.field.Text.html#getState" rel="Ext.form.field.Text#getState" class="docClass">getState</a></code></b>. By default, this function does
920 nothing. The developer must provide an implementation which returns an
921 object hash which represents the restorable state of the object.</p>
922 <p>The value yielded by getState is passed to <a href="Ext.state.Manager.html#set" rel="Ext.state.Manager#set" class="docClass">Ext.state.Manager.set</a>
923 which uses the configured <a href="Ext.state.Provider.html" rel="Ext.state.Provider" class="docClass">Ext.state.Provider</a> to save the object
924 keyed by the <code><a href="stateId.html" rel="stateId" class="docClass">stateId</a></code></p>.
925 <p>During construction, a stateful object attempts to <i>restore</i>
926 its state by calling <a href="Ext.state.Manager.html#get" rel="Ext.state.Manager#get" class="docClass">Ext.state.Manager.get</a> passing the
927 <code><a href="Ext.form.field.Text.html#stateId" rel="Ext.form.field.Text#stateId" class="docClass">stateId</a></code></p>
928 <p>The resulting object is passed to <b><code><a href="Ext.form.field.Text.html#applyState" rel="Ext.form.field.Text#applyState" class="docClass">applyState</a></code></b>.
929 The default implementation of <code><a href="Ext.form.field.Text.html#applyState" rel="Ext.form.field.Text#applyState" class="docClass">applyState</a></code> simply copies
930 properties into the object, but a developer may override this to support
931 more behaviour.</p>
932 <p>You can perform extra processing on state save and restore by attaching
933 handlers to the <a href="Ext.form.field.Text.html#beforestaterestore" rel="Ext.form.field.Text#beforestaterestore" class="docClass">beforestaterestore</a>, <a href="Ext.form.field.Text.html#staterestore" rel="Ext.form.field.Text#staterestore" class="docClass">staterestore</a>,
934 <a href="Ext.form.field.Text.html#beforestatesave" rel="Ext.form.field.Text#beforestatesave" class="docClass">beforestatesave</a> and <a href="Ext.form.field.Text.html#statesave" rel="Ext.form.field.Text#statesave" class="docClass">statesave</a> events.</p>
935
936 </div></div></div><div id="config-stripCharsRe" class="member ni"><a href="Ext.form.field.Text.html#config-stripCharsRe" rel="config-stripCharsRe" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-stripCharsRe" class="viewSource">view source</a></div><a name="stripCharsRe"></a><a name="config-stripCharsRe"></a><a href="Ext.form.field.Text.html#" rel="config-stripCharsRe" class="cls expand">stripCharsRe</a><span> : RegExp</span></div><div class="description"><div class="short"><p>A JavaScript RegExp object used to strip unwanted content from the value
937 before validation (defaults to <tt>undefined</tt>).</p>
938 </div><div class="long"><p>A JavaScript RegExp object used to strip unwanted content from the value
939 before validation (defaults to <tt>undefined</tt>).</p>
940 </div></div></div><div id="config-style" class="member inherited"><a href="Ext.form.field.Text.html#config-style" rel="config-style" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-style" class="viewSource">view source</a></div><a name="style"></a><a name="config-style"></a><a href="Ext.form.field.Text.html#" rel="config-style" class="cls expand">style</a><span> : String</span></div><div class="description"><div class="short">A custom style specification to be applied to this component's Element.  Should be a valid argument to
941 Ext.core.Eleme...</div><div class="long"><p>A custom style specification to be applied to this component's Element.  Should be a valid argument to
942 <a href="Ext.core.Element.html#applyStyles" rel="Ext.core.Element#applyStyles" class="docClass">Ext.core.Element.applyStyles</a>.</p>
943
944 <pre><code>        new Ext.panel.Panel({
945             title: 'Some Title',
946             renderTo: Ext.getBody(),
947             width: 400, height: 300,
948             layout: 'form',
949             items: [{
950                 xtype: 'textarea',
951                 style: {
952                     width: '95%',
953                     marginBottom: '10px'
954                 }
955             },
956             new Ext.button.Button({
957                 text: 'Send',
958                 minWidth: '100',
959                 style: {
960                     marginBottom: '10px'
961                 }
962             })
963             ]
964         });
965      </code></pre>
966
967 </div></div></div><div id="config-styleHtmlCls" class="member inherited"><a href="Ext.form.field.Text.html#config-styleHtmlCls" rel="config-styleHtmlCls" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-styleHtmlCls" class="viewSource">view source</a></div><a name="styleHtmlCls"></a><a name="config-styleHtmlCls"></a><a href="Ext.form.field.Text.html#" rel="config-styleHtmlCls" class="cls expand">styleHtmlCls</a><span> : String</span></div><div class="description"><div class="short"><p>The class that is added to the content target when you set styleHtmlContent to true.
968 Defaults to 'x-html'</p>
969 </div><div class="long"><p>The class that is added to the content target when you set styleHtmlContent to true.
970 Defaults to 'x-html'</p>
971 </div></div></div><div id="config-styleHtmlContent" class="member inherited"><a href="Ext.form.field.Text.html#config-styleHtmlContent" rel="config-styleHtmlContent" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-styleHtmlContent" class="viewSource">view source</a></div><a name="styleHtmlContent"></a><a name="config-styleHtmlContent"></a><a href="Ext.form.field.Text.html#" rel="config-styleHtmlContent" class="cls expand">styleHtmlContent</a><span> : String</span></div><div class="description"><div class="short"><p>True to automatically style the html inside the content target of this component (body for panels).
972 Defaults to false.</p>
973 </div><div class="long"><p>True to automatically style the html inside the content target of this component (body for panels).
974 Defaults to false.</p>
975 </div></div></div><div id="config-submitValue" class="member inherited"><a href="Ext.form.field.Text.html#config-submitValue" rel="config-submitValue" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-cfg-submitValue" class="viewSource">view source</a></div><a name="submitValue"></a><a name="config-submitValue"></a><a href="Ext.form.field.Text.html#" rel="config-submitValue" class="cls expand">submitValue</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Setting this to <tt>false</tt> will prevent the field from being
976 <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">submitted</a> even when it is not disabled. Defaults to <tt>true</tt>.</p>
977 </div><div class="long"><p>Setting this to <tt>false</tt> will prevent the field from being
978 <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">submitted</a> even when it is not disabled. Defaults to <tt>true</tt>.</p>
979 </div></div></div><div id="config-tabIndex" class="member inherited"><a href="Ext.form.field.Text.html#config-tabIndex" rel="config-tabIndex" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-tabIndex" class="viewSource">view source</a></div><a name="tabIndex"></a><a name="config-tabIndex"></a><a href="Ext.form.field.Text.html#" rel="config-tabIndex" class="cls expand">tabIndex</a><span> : Number</span></div><div class="description"><div class="short">The tabIndex for this field. Note this only applies to fields that are rendered,
980 not those which are built via applyT...</div><div class="long"><p>The tabIndex for this field. Note this only applies to fields that are rendered,
981 not those which are built via applyTo (defaults to undefined).</p>
982 </div></div></div><div id="config-toFrontOnShow" class="member inherited"><a href="Ext.form.field.Text.html#config-toFrontOnShow" rel="config-toFrontOnShow" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-cfg-toFrontOnShow" class="viewSource">view source</a></div><a name="toFrontOnShow"></a><a name="config-toFrontOnShow"></a><a href="Ext.form.field.Text.html#" rel="config-toFrontOnShow" class="cls expand">toFrontOnShow</a><span> : Boolean</span></div><div class="description"><div class="short">True to automatically call toFront when the show method is called
983 on an already visible, floating component (default ...</div><div class="long"><p>True to automatically call <a href="Ext.form.field.Text.html#toFront" rel="Ext.form.field.Text#toFront" class="docClass">toFront</a> when the <a href="Ext.form.field.Text.html#show" rel="Ext.form.field.Text#show" class="docClass">show</a> method is called
984 on an already visible, floating component (default is <code>true</code>).</p>
985
986 </div></div></div><div id="config-tpl" class="member inherited"><a href="Ext.form.field.Text.html#config-tpl" rel="config-tpl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-tpl" class="viewSource">view source</a></div><a name="tpl"></a><a name="config-tpl"></a><a href="Ext.form.field.Text.html#" rel="config-tpl" class="cls expand">tpl</a><span> : Mixed</span></div><div class="description"><div class="short">An Ext.Template, Ext.XTemplate
987 or an array of strings to form an Ext.XTemplate.
988 Used in conjunction with the data and...</div><div class="long"><p>An <bold><a href="Ext.Template.html" rel="Ext.Template" class="docClass">Ext.Template</a></bold>, <bold><a href="Ext.XTemplate.html" rel="Ext.XTemplate" class="docClass">Ext.XTemplate</a></bold>
989 or an array of strings to form an <a href="Ext.XTemplate.html" rel="Ext.XTemplate" class="docClass">Ext.XTemplate</a>.
990 Used in conjunction with the <code><a href="Ext.form.field.Text.html#data" rel="Ext.form.field.Text#data" class="docClass">data</a></code> and
991 <code><a href="Ext.form.field.Text.html#tplWriteMode" rel="Ext.form.field.Text#tplWriteMode" class="docClass">tplWriteMode</a></code> configurations.</p>
992 </div></div></div><div id="config-tplWriteMode" class="member inherited"><a href="Ext.form.field.Text.html#config-tplWriteMode" rel="config-tplWriteMode" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-tplWriteMode" class="viewSource">view source</a></div><a name="tplWriteMode"></a><a name="config-tplWriteMode"></a><a href="Ext.form.field.Text.html#" rel="config-tplWriteMode" class="cls expand">tplWriteMode</a><span> : String</span></div><div class="description"><div class="short">The Ext.(X)Template method to use when
993 updating the content area of the Component. Defaults to 'overwrite'
994 (see Ext.X...</div><div class="long"><p>The Ext.(X)Template method to use when
995 updating the content area of the Component. Defaults to <code>'overwrite'</code>
996 (see <code><a href="Ext.XTemplate.html#overwrite" rel="Ext.XTemplate#overwrite" class="docClass">Ext.XTemplate.overwrite</a></code>).</p>
997 </div></div></div><div id="config-ui" class="member inherited"><a href="Ext.form.field.Text.html#config-ui" rel="config-ui" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-ui" class="viewSource">view source</a></div><a name="ui"></a><a name="config-ui"></a><a href="Ext.form.field.Text.html#" rel="config-ui" class="cls expand">ui</a><span> : String/Array</span></div><div class="description"><div class="short"><p>A set style for a component. Can be a string or an Array of multiple strings (UIs)</p>
998 </div><div class="long"><p>A set style for a component. Can be a string or an Array of multiple strings (UIs)</p>
999 </div></div></div><div id="config-validateOnBlur" class="member inherited"><a href="Ext.form.field.Text.html#config-validateOnBlur" rel="config-validateOnBlur" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-cfg-validateOnBlur" class="viewSource">view source</a></div><a name="validateOnBlur"></a><a name="config-validateOnBlur"></a><a href="Ext.form.field.Text.html#" rel="config-validateOnBlur" class="cls expand">validateOnBlur</a><span> : Boolean</span></div><div class="description"><div class="short">Whether the field should validate when it loses focus (defaults to true). This will cause fields
1000 to be validated as t...</div><div class="long"><p>Whether the field should validate when it loses focus (defaults to <tt>true</tt>). This will cause fields
1001 to be validated as the user steps through the fields in the form regardless of whether they are making
1002 changes to those fields along the way. See also <a href="Ext.form.field.Text.html#validateOnChange" rel="Ext.form.field.Text#validateOnChange" class="docClass">validateOnChange</a>.</p>
1003 </div></div></div><div id="config-validateOnChange" class="member inherited"><a href="Ext.form.field.Text.html#config-validateOnChange" rel="config-validateOnChange" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-cfg-validateOnChange" class="viewSource">view source</a></div><a name="validateOnChange"></a><a name="config-validateOnChange"></a><a href="Ext.form.field.Text.html#" rel="config-validateOnChange" class="cls expand">validateOnChange</a><span> : Boolean</span></div><div class="description"><div class="short">Specifies whether this field should be validated immediately whenever a change in its value is detected.
1004 Defaults to ...</div><div class="long"><p>Specifies whether this field should be validated immediately whenever a change in its value is detected.
1005 Defaults to <tt>true</tt>. If the validation results in a change in the field's validity, a
1006 <a href="Ext.form.field.Text.html#validitychange" rel="Ext.form.field.Text#validitychange" class="docClass">validitychange</a> event will be fired. This allows the field to show feedback about the
1007 validity of its contents immediately as the user is typing.</p>
1008
1009
1010 <p>When set to <tt>false</tt>, feedback will not be immediate. However the form will still be validated
1011 before submitting if the <tt>clientValidation</tt> option to <a href="Ext.form.Basic.html#doAction" rel="Ext.form.Basic#doAction" class="docClass">Ext.form.Basic.doAction</a> is
1012 enabled, or if the field or form are validated manually.</p>
1013
1014
1015 <p>See also <a href="Ext.form.field.Base.html#checkChangeEvents" rel="Ext.form.field.Base#checkChangeEvents" class="docClass">Ext.form.field.Base.checkChangeEvents</a>for controlling how changes to the field's value are detected.</p>
1016
1017 </div></div></div><div id="config-validator" class="member ni"><a href="Ext.form.field.Text.html#config-validator" rel="config-validator" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-validator" class="viewSource">view source</a></div><a name="validator"></a><a name="config-validator"></a><a href="Ext.form.field.Text.html#" rel="config-validator" class="cls expand">validator</a><span> : Function</span></div><div class="description"><div class="short">A custom validation function to be called during field validation (getErrors)
1018 (defaults to undefined). If specified, ...</div><div class="long"><p>A custom validation function to be called during field validation (<a href="Ext.form.field.Text.html#getErrors" rel="Ext.form.field.Text#getErrors" class="docClass">getErrors</a>)
1019 (defaults to <tt>undefined</tt>). If specified, this function will be called first, allowing the
1020 developer to override the default validation process.</p>
1021
1022
1023 <br><p>This function will be passed the following Parameters:</p>
1024
1025
1026 <div class="mdetail-params"><ul>
1027 <li><code>value</code>: <i>Mixed</i>
1028 <div class="sub-desc">The current field value</div></li>
1029 </ul></div>
1030
1031
1032 <br><p>This function is to Return:</p>
1033
1034
1035 <div class="mdetail-params"><ul>
1036 <li><code>true</code>: <i>Boolean</i>
1037 <div class="sub-desc"><code>true</code> if the value is valid</div></li>
1038 <li><code>msg</code>: <i>String</i>
1039 <div class="sub-desc">An error message if the value is invalid</div></li>
1040 </ul></div>
1041
1042 </div></div></div><div id="config-value" class="member inherited"><a href="Ext.form.field.Text.html#config-value" rel="config-value" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-cfg-value" class="viewSource">view source</a></div><a name="value"></a><a name="config-value"></a><a href="Ext.form.field.Text.html#" rel="config-value" class="cls expand">value</a><span> : Mixed</span></div><div class="description"><div class="short"><p>A value to initialize this field with (defaults to undefined).</p>
1043 </div><div class="long"><p>A value to initialize this field with (defaults to undefined).</p>
1044 </div></div></div><div id="config-vtype" class="member ni"><a href="Ext.form.field.Text.html#config-vtype" rel="config-vtype" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-vtype" class="viewSource">view source</a></div><a name="vtype"></a><a name="config-vtype"></a><a href="Ext.form.field.Text.html#" rel="config-vtype" class="cls expand">vtype</a><span> : String</span></div><div class="description"><div class="short"><p>A validation type name as defined in <a href="Ext.form.field.VTypes.html" rel="Ext.form.field.VTypes" class="docClass">Ext.form.field.VTypes</a> (defaults to <tt>undefined</tt>)</p>
1045 </div><div class="long"><p>A validation type name as defined in <a href="Ext.form.field.VTypes.html" rel="Ext.form.field.VTypes" class="docClass">Ext.form.field.VTypes</a> (defaults to <tt>undefined</tt>)</p>
1046 </div></div></div><div id="config-vtypeText" class="member ni"><a href="Ext.form.field.Text.html#config-vtypeText" rel="config-vtypeText" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-cfg-vtypeText" class="viewSource">view source</a></div><a name="vtypeText"></a><a name="config-vtypeText"></a><a href="Ext.form.field.Text.html#" rel="config-vtypeText" class="cls expand">vtypeText</a><span> : String</span></div><div class="description"><div class="short">A custom error message to display in place of the default message provided
1047 for the vtype currently set for this field...</div><div class="long"><p>A custom error message to display in place of the default message provided
1048 for the <b><code><a href="Ext.form.field.Text.html#vtype" rel="Ext.form.field.Text#vtype" class="docClass">vtype</a></code></b> currently set for this field (defaults to <tt>undefined</tt>).
1049 <b>Note</b>: only applies if <b><code><a href="Ext.form.field.Text.html#vtype" rel="Ext.form.field.Text#vtype" class="docClass">vtype</a></code></b> is set, else ignored.</p>
1050 </div></div></div><div id="config-width" class="member inherited"><a href="Ext.form.field.Text.html#config-width" rel="config-width" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-cfg-width" class="viewSource">view source</a></div><a name="width"></a><a name="config-width"></a><a href="Ext.form.field.Text.html#" rel="config-width" class="cls expand">width</a><span> : Number</span></div><div class="description"><div class="short"><p>The width of this component in pixels.</p>
1051 </div><div class="long"><p>The width of this component in pixels.</p>
1052 </div></div></div></div><div class="m-properties"><a name="properties"></a><div class="definedBy">Defined By</div><h3 class="prp p">Properties</h3><div id="property-bodyEl" class="member f inherited"><a href="Ext.form.field.Text.html#property-bodyEl" rel="property-bodyEl" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-property-bodyEl" class="viewSource">view source</a></div><a name="bodyEl"></a><a name="property-bodyEl"></a><a href="Ext.form.field.Text.html#" rel="property-bodyEl" class="cls expand">bodyEl</a><span> : Ext.core.Element</span></div><div class="description"><div class="short"><p>The div Element wrapping the component's contents. Only available after the component has been rendered.</p>
1053 </div><div class="long"><p>The div Element wrapping the component's contents. Only available after the component has been rendered.</p>
1054 </div></div></div><div id="property-clearInvalid" class="member inherited"><a href="Ext.form.field.Text.html#property-clearInvalid" rel="property-clearInvalid" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-property-clearInvalid" class="viewSource">view source</a></div><a name="clearInvalid"></a><a name="property-clearInvalid"></a><a href="Ext.form.field.Text.html#" rel="property-clearInvalid" class="cls expand">clearInvalid</a><span> : Object</span></div><div class="description"><div class="short">Clear any invalid styles/messages for this field. Components using this mixin should implement
1055 this method to update ...</div><div class="long"><p>Clear any invalid styles/messages for this field. Components using this mixin should implement
1056 this method to update the components rendering to clear any existing messages.</p>
1057
1058
1059 <p><b>Note</b>: this method does not cause the Field's <a href="Ext.form.field.Text.html#validate" rel="Ext.form.field.Text#validate" class="docClass">validate</a> or <a href="Ext.form.field.Text.html#isValid" rel="Ext.form.field.Text#isValid" class="docClass">isValid</a> methods to
1060 return <code>true</code> if the value does not <i>pass</i> validation. So simply clearing a field's errors
1061 will not necessarily allow submission of forms submitted with the <a href="Ext.form.action.Submit.html#clientValidation" rel="Ext.form.action.Submit#clientValidation" class="docClass">Ext.form.action.Submit.clientValidation</a>
1062 option set.</p>
1063
1064 </div></div></div><div id="property-draggable" class="member inherited"><a href="Ext.form.field.Text.html#property-draggable" rel="property-draggable" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-property-draggable" class="viewSource">view source</a></div><a name="draggable"></a><a name="property-draggable"></a><a href="Ext.form.field.Text.html#" rel="property-draggable" class="cls expand">draggable</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Read-only property indicating whether or not the component can be dragged</p>
1065 </div><div class="long"><p>Read-only property indicating whether or not the component can be dragged</p>
1066 </div></div></div><div id="property-errorEl" class="member inherited"><a href="Ext.form.field.Text.html#property-errorEl" rel="property-errorEl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-property-errorEl" class="viewSource">view source</a></div><a name="errorEl"></a><a name="property-errorEl"></a><a href="Ext.form.field.Text.html#" rel="property-errorEl" class="cls expand">errorEl</a><span> : Ext.core.Element</span></div><div class="description"><div class="short">The div Element that will contain the component's error message(s). Note that depending on the
1067 configured msgTarget, ...</div><div class="long"><p>The div Element that will contain the component's error message(s). Note that depending on the
1068 configured <a href="Ext.form.field.Text.html#msgTarget" rel="Ext.form.field.Text#msgTarget" class="docClass">msgTarget</a>, this element may be hidden in favor of some other form of
1069 presentation, but will always be present in the DOM for use by assistive technologies.</p>
1070 </div></div></div><div id="property-floatParent" class="member inherited"><a href="Ext.form.field.Text.html#property-floatParent" rel="property-floatParent" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-property-floatParent" class="viewSource">view source</a></div><a name="floatParent"></a><a name="property-floatParent"></a><a href="Ext.form.field.Text.html#" rel="property-floatParent" class="cls expand">floatParent</a><span> : Ext.Container</span></div><div class="description"><div class="short">Optional. Only present for floating Components which were inserted as descendant items of floating Containers.
1071
1072
1073 Floa...</div><div class="long"><p>Optional. Only present for <a href="Ext.form.field.Text.html#floating" rel="Ext.form.field.Text#floating" class="docClass">floating</a> Components which were inserted as descendant items of floating Containers.</p>
1074
1075
1076 <p>Floating Components that are programatically <a href="Ext.Component.html#render" rel="Ext.Component#render" class="docClass">rendered</a> will not have a <code>floatParent</code> property.</p>
1077
1078
1079 <p>For <a href="Ext.form.field.Text.html#floating" rel="Ext.form.field.Text#floating" class="docClass">floating</a> Components which are child items of a Container, the floatParent will be the floating ancestor Container which is
1080 responsible for the base z-index value of all its floating descendants. It provides a <a href="Ext.ZIndexManager.html" rel="Ext.ZIndexManager" class="docClass">ZIndexManager</a> which provides
1081 z-indexing services for all its descendant floating Components.</p>
1082
1083
1084 <p>For example, the dropdown <a href="Ext.view.BoundList.html" rel="Ext.view.BoundList" class="docClass">BoundList</a> of a ComboBox which is in a Window will have the Window as its
1085 <code>floatParent</code></p>
1086
1087
1088 <p>See <a href="Ext.form.field.Text.html#floating" rel="Ext.form.field.Text#floating" class="docClass">floating</a> and <a href="Ext.form.field.Text.html#zIndexManager" rel="Ext.form.field.Text#zIndexManager" class="docClass">zIndexManager</a></p>
1089
1090 </div></div></div><div id="property-frameSize" class="member inherited"><a href="Ext.form.field.Text.html#property-frameSize" rel="property-frameSize" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-property-frameSize" class="viewSource">view source</a></div><a name="frameSize"></a><a name="property-frameSize"></a><a href="Ext.form.field.Text.html#" rel="property-frameSize" class="cls expand">frameSize</a><span> : Object</span></div><div class="description"><div class="short">Read-only property indicating the width of any framing elements which were added within the encapsulating element
1091 to ...</div><div class="long"><p>Read-only property indicating the width of any framing elements which were added within the encapsulating element
1092 to provide graphical, rounded borders. See the <a href="Ext.form.field.Text.html#frame" rel="Ext.form.field.Text#frame" class="docClass">frame</a> config.</p>
1093
1094
1095 <p> This is an object containing the frame width in pixels for all four sides of the Component containing
1096 the following properties:</p>
1097
1098
1099 <div class="mdetail-params"><ul>
1100 <li><code>top</code> The width of the top framing element in pixels.</li>
1101 <li><code>right</code> The width of the right framing element in pixels.</li>
1102 <li><code>bottom</code> The width of the bottom framing element in pixels.</li>
1103 <li><code>left</code> The width of the left framing element in pixels.</li>
1104 </ul></div>
1105
1106 </div></div></div><div id="property-hasActiveFx" class="member inherited"><a href="Ext.form.field.Text.html#property-hasActiveFx" rel="property-hasActiveFx" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-property-hasActiveFx" class="viewSource">view source</a></div><a name="hasActiveFx"></a><a name="property-hasActiveFx"></a><a href="Ext.form.field.Text.html#" rel="property-hasActiveFx" class="cls expand">hasActiveFx</a><span> : Object</span></div><div class="description"><div class="short">@deprecated 4.0 Replaced by getActiveAnimation
1107 Returns thq current animation if this object has any effects actively ...</div><div class="long"><p>@deprecated 4.0 Replaced by <a href="Ext.form.field.Text.html#getActiveAnimation" rel="Ext.form.field.Text#getActiveAnimation" class="docClass">getActiveAnimation</a>
1108 Returns thq current animation if this object has any effects actively running or queued, else returns false.</p>
1109 </div></div></div><div id="property-inputEl" class="member inherited"><a href="Ext.form.field.Text.html#property-inputEl" rel="property-inputEl" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-property-inputEl" class="viewSource">view source</a></div><a name="inputEl"></a><a name="property-inputEl"></a><a href="Ext.form.field.Text.html#" rel="property-inputEl" class="cls expand">inputEl</a><span> : Ext.core.Element</span></div><div class="description"><div class="short"><p>The input Element for this Field. Only available after the field has been rendered.</p>
1110 </div><div class="long"><p>The input Element for this Field. Only available after the field has been rendered.</p>
1111 </div></div></div><div id="property-isFieldLabelable" class="member inherited"><a href="Ext.form.field.Text.html#property-isFieldLabelable" rel="property-isFieldLabelable" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-property-isFieldLabelable" class="viewSource">view source</a></div><a name="isFieldLabelable"></a><a name="property-isFieldLabelable"></a><a href="Ext.form.field.Text.html#" rel="property-isFieldLabelable" class="cls expand">isFieldLabelable</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Flag denoting that this object is labelable as a field. Always true.</p>
1112 </div><div class="long"><p>Flag denoting that this object is labelable as a field. Always true.</p>
1113 </div></div></div><div id="property-isFormField" class="member inherited"><a href="Ext.form.field.Text.html#property-isFormField" rel="property-isFormField" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-property-isFormField" class="viewSource">view source</a></div><a name="isFormField"></a><a name="property-isFormField"></a><a href="Ext.form.field.Text.html#" rel="property-isFormField" class="cls expand">isFormField</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Flag denoting that this component is a Field. Always true.</p>
1114 </div><div class="long"><p>Flag denoting that this component is a Field. Always true.</p>
1115 </div></div></div><div id="property-labelEl" class="member inherited"><a href="Ext.form.field.Text.html#property-labelEl" rel="property-labelEl" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-property-labelEl" class="viewSource">view source</a></div><a name="labelEl"></a><a name="property-labelEl"></a><a href="Ext.form.field.Text.html#" rel="property-labelEl" class="cls expand">labelEl</a><span> : Ext.core.Element</span></div><div class="description"><div class="short"><p>The label Element for this component. Only available after the component has been rendered.</p>
1116 </div><div class="long"><p>The label Element for this component. Only available after the component has been rendered.</p>
1117 </div></div></div><div id="property-markInvalid" class="member inherited"><a href="Ext.form.field.Text.html#property-markInvalid" rel="property-markInvalid" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-property-markInvalid" class="viewSource">view source</a></div><a name="markInvalid"></a><a name="property-markInvalid"></a><a href="Ext.form.field.Text.html#" rel="property-markInvalid" class="cls expand">markInvalid</a><span> : Object</span></div><div class="description"><div class="short">Associate one or more error messages with this field. Components using this mixin should implement
1118 this method to upd...</div><div class="long"><p>Associate one or more error messages with this field. Components using this mixin should implement
1119 this method to update the component's rendering to display the messages.</p>
1120
1121
1122 <p><b>Note</b>: this method does not cause the Field's <a href="Ext.form.field.Text.html#validate" rel="Ext.form.field.Text#validate" class="docClass">validate</a> or <a href="Ext.form.field.Text.html#isValid" rel="Ext.form.field.Text#isValid" class="docClass">isValid</a> methods to
1123 return <code>false</code> if the value does <i>pass</i> validation. So simply marking a Field as invalid
1124 will not prevent submission of forms submitted with the <a href="Ext.form.action.Submit.html#clientValidation" rel="Ext.form.action.Submit#clientValidation" class="docClass">Ext.form.action.Submit.clientValidation</a>
1125 option set.</p>
1126
1127 </div></div></div><div id="property-maskOnDisable" class="member inherited"><a href="Ext.form.field.Text.html#property-maskOnDisable" rel="property-maskOnDisable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-property-maskOnDisable" class="viewSource">view source</a></div><a name="maskOnDisable"></a><a name="property-maskOnDisable"></a><a href="Ext.form.field.Text.html#" rel="property-maskOnDisable" class="cls expand">maskOnDisable</a><span> : Boolean</span></div><div class="description"><div class="short">This is an internal flag that you use when creating custom components.
1128 By default this is set to true which means tha...</div><div class="long"><p>This is an internal flag that you use when creating custom components.
1129 By default this is set to true which means that every component gets a mask when its disabled.
1130 Components like FieldContainer, FieldSet, Field, Button, Tab override this property to false
1131 since they want to implement custom disable logic.</p>
1132 </div></div></div><div id="property-originalValue" class="member inherited"><a href="Ext.form.field.Text.html#property-originalValue" rel="property-originalValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-property-originalValue" class="viewSource">view source</a></div><a name="originalValue"></a><a name="property-originalValue"></a><a href="Ext.form.field.Text.html#" rel="property-originalValue" class="cls expand">originalValue</a><span> : Mixed</span></div><div class="description"><div class="short">The original value of the field as configured in the value configuration, or as loaded by
1133 the last form load operatio...</div><div class="long"><p>The original value of the field as configured in the <a href="Ext.form.field.Text.html#value" rel="Ext.form.field.Text#value" class="docClass">value</a> configuration, or as loaded by
1134 the last form load operation if the form's <a href="Ext.form.Basic.html#trackResetOnLoad" rel="Ext.form.Basic#trackResetOnLoad" class="docClass">trackResetOnLoad</a>
1135 setting is <code>true</code>.</p>
1136 </div></div></div><div id="property-ownerCt" class="member inherited"><a href="Ext.form.field.Text.html#property-ownerCt" rel="property-ownerCt" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-property-ownerCt" class="viewSource">view source</a></div><a name="ownerCt"></a><a name="property-ownerCt"></a><a href="Ext.form.field.Text.html#" rel="property-ownerCt" class="cls expand">ownerCt</a><span> : Ext.Container</span></div><div class="description"><div class="short">This Component's owner Container (defaults to undefined, and is set automatically when
1137 this Component is added to a C...</div><div class="long"><p>This Component's owner <a href="Ext.container.Container.html" rel="Ext.container.Container" class="docClass">Container</a> (defaults to undefined, and is set automatically when
1138 this Component is added to a Container).  Read-only.</p>
1139
1140 <p><b>Note</b>: to access items within the Container see <tt><a href="Ext.form.field.Text.html#itemId" rel="Ext.form.field.Text#itemId" class="docClass">itemId</a></tt>.</p>
1141
1142 </div></div></div><div id="property-rendered" class="member inherited"><a href="Ext.form.field.Text.html#property-rendered" rel="property-rendered" class="expand more"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-property-rendered" class="viewSource">view source</a></div><a name="rendered"></a><a name="property-rendered"></a><a href="Ext.form.field.Text.html#" rel="property-rendered" class="cls expand">rendered</a><span> : Boolean</span></div><div class="description"><div class="short"><p>Read-only property indicating whether or not the component has been rendered.</p>
1143 </div><div class="long"><p>Read-only property indicating whether or not the component has been rendered.</p>
1144 </div></div></div><div id="property-stopFx" class="member inherited"><a href="Ext.form.field.Text.html#property-stopFx" rel="property-stopFx" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-property-stopFx" class="viewSource">view source</a></div><a name="stopFx"></a><a name="property-stopFx"></a><a href="Ext.form.field.Text.html#" rel="property-stopFx" class="cls expand">stopFx</a><span> : Object</span></div><div class="description"><div class="short">Stops any running effects and clears this object's internal effects queue if it contains
1145 any additional effects that ...</div><div class="long"><p>Stops any running effects and clears this object's internal effects queue if it contains
1146 any additional effects that haven't started yet.</p>
1147 </div></div></div><div id="property-zIndexManager" class="member inherited"><a href="Ext.form.field.Text.html#property-zIndexManager" rel="property-zIndexManager" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-property-zIndexManager" class="viewSource">view source</a></div><a name="zIndexManager"></a><a name="property-zIndexManager"></a><a href="Ext.form.field.Text.html#" rel="property-zIndexManager" class="cls expand">zIndexManager</a><span> : Ext.ZIndexManager</span></div><div class="description"><div class="short">Optional. Only present for floating Components after they have been rendered.
1148
1149
1150 A reference to the ZIndexManager whic...</div><div class="long"><p>Optional. Only present for <a href="Ext.form.field.Text.html#floating" rel="Ext.form.field.Text#floating" class="docClass">floating</a> Components after they have been rendered.</p>
1151
1152
1153 <p>A reference to the ZIndexManager which is managing this Component's z-index.</p>
1154
1155
1156 <p>The <a href="Ext.ZIndexManager.html" rel="Ext.ZIndexManager" class="docClass">ZIndexManager</a> maintains a stack of floating Component z-indices, and also provides a single modal
1157 mask which is insert just beneath the topmost visible modal floating Component.</p>
1158
1159
1160 <p>Floating Components may be <a href="Ext.form.field.Text.html#toFront" rel="Ext.form.field.Text#toFront" class="docClass">brought to the front</a> or <a href="Ext.form.field.Text.html#toBack" rel="Ext.form.field.Text#toBack" class="docClass">sent to the back</a> of the z-index stack.</p>
1161
1162
1163 <p>This defaults to the global <a href="Ext.WindowManager.html" rel="Ext.WindowManager" class="docClass">ZIndexManager</a> for floating Components that are programatically
1164 <a href="Ext.Component.html#render" rel="Ext.Component#render" class="docClass">rendered</a>.</p>
1165
1166
1167 <p>For <a href="Ext.form.field.Text.html#floating" rel="Ext.form.field.Text#floating" class="docClass">floating</a> Components which are added to a Container, the ZIndexManager is acquired from the first ancestor Container found
1168 which is floating, or if not found the global <a href="Ext.WindowManager.html" rel="Ext.WindowManager" class="docClass">ZIndexManager</a> is used.</p>
1169
1170
1171 <p>See <a href="Ext.form.field.Text.html#floating" rel="Ext.form.field.Text#floating" class="docClass">floating</a> and <a href="Ext.form.field.Text.html#floatParent" rel="Ext.form.field.Text#floatParent" class="docClass">floatParent</a></p>
1172
1173 </div></div></div></div><div class="m-methods"><a name="methods"></a><div class="definedBy">Defined By</div><h3 class="mth p">Methods</h3><div id="method-Text" class="member f ni"><a href="Ext.form.field.Text.html#method-Text" rel="method-Text" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-method-constructor" class="viewSource">view source</a></div><a name="Text"></a><a name="method-Text"></a><a href="Ext.form.field.Text.html#" rel="method-Text" class="cls expand">Text</a>(
1174 <span class="pre">Object config</span>)
1175  : void</div><div class="description"><div class="short"><p>Creates a new TextField</p>
1176 </div><div class="long"><p>Creates a new TextField</p>
1177 <h3 class="pa">Parameters</h3><ul><li><span class="pre">config</span> : Object<div class="sub-desc"><p>Configuration options</p>
1178 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1179 </li></ul></div></div></div><div id="method-addClass" class="member inherited"><a href="Ext.form.field.Text.html#method-addClass" rel="method-addClass" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-addClass" class="viewSource">view source</a></div><a name="addClass"></a><a name="method-addClass"></a><a href="Ext.form.field.Text.html#" rel="method-addClass" class="cls expand">addClass</a>(
1180 <span class="pre">String cls</span>)
1181  : Ext.Component</div><div class="description"><div class="short"><p>@deprecated 4.0 Replaced by {link:#addCls}
1182 Adds a CSS class to the top level element representing this component.</p>
1183 </div><div class="long"><p>@deprecated 4.0 Replaced by {link:#addCls}
1184 Adds a CSS class to the top level element representing this component.</p>
1185 <h3 class="pa">Parameters</h3><ul><li><span class="pre">cls</span> : String<div class="sub-desc"><p>The CSS class name to add</p>
1186 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>Returns the Component to allow method chaining.</p>
1187 </li></ul></div></div></div><div id="method-addCls" class="member inherited"><a href="Ext.form.field.Text.html#method-addCls" rel="method-addCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-addCls" class="viewSource">view source</a></div><a name="addCls"></a><a name="method-addCls"></a><a href="Ext.form.field.Text.html#" rel="method-addCls" class="cls expand">addCls</a>(
1188 <span class="pre">String cls</span>)
1189  : Ext.Component</div><div class="description"><div class="short"><p>Adds a CSS class to the top level element representing this component.</p>
1190 </div><div class="long"><p>Adds a CSS class to the top level element representing this component.</p>
1191 <h3 class="pa">Parameters</h3><ul><li><span class="pre">cls</span> : String<div class="sub-desc"><p>The CSS class name to add</p>
1192 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>Returns the Component to allow method chaining.</p>
1193 </li></ul></div></div></div><div id="method-addClsWithUI" class="member inherited"><a href="Ext.form.field.Text.html#method-addClsWithUI" rel="method-addClsWithUI" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-addClsWithUI" class="viewSource">view source</a></div><a name="addClsWithUI"></a><a name="method-addClsWithUI"></a><a href="Ext.form.field.Text.html#" rel="method-addClsWithUI" class="cls expand">addClsWithUI</a>(
1194 <span class="pre">String/Array cls</span>)
1195  : void</div><div class="description"><div class="short"><p>Adds a cls to the uiCls array, which will also call <a href="Ext.form.field.Text.html#addUIClsToElement" rel="Ext.form.field.Text#addUIClsToElement" class="docClass">addUIClsToElement</a> and adds
1196 to all elements of this component.</p>
1197 </div><div class="long"><p>Adds a cls to the uiCls array, which will also call <a href="Ext.form.field.Text.html#addUIClsToElement" rel="Ext.form.field.Text#addUIClsToElement" class="docClass">addUIClsToElement</a> and adds
1198 to all elements of this component.</p>
1199 <h3 class="pa">Parameters</h3><ul><li><span class="pre">cls</span> : String/Array<div class="sub-desc"><p>A string or an array of strings to add to the uiCls</p>
1200 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1201 </li></ul></div></div></div><div id="method-addEvents" class="member inherited"><a href="Ext.form.field.Text.html#method-addEvents" rel="method-addEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-addEvents" class="viewSource">view source</a></div><a name="addEvents"></a><a name="method-addEvents"></a><a href="Ext.form.field.Text.html#" rel="method-addEvents" class="cls expand">addEvents</a>(
1202 <span class="pre">Object/String o, String </span>)
1203  : void</div><div class="description"><div class="short"><p>Adds the specified events to the list of events which this Observable may fire.</p>
1204 </div><div class="long"><p>Adds the specified events to the list of events which this Observable may fire.</p>
1205 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Object/String<div class="sub-desc"><p>Either an object with event names as properties with a value of <code>true</code>
1206 or the first event name string if multiple event names are being passed as separate parameters.</p>
1207 </div></li><li><span class="pre"></span> : String<div class="sub-desc"><p>[additional] Optional additional event names if multiple event names are being passed as separate parameters.
1208 Usage:</p>
1209
1210 <pre><code>this.addEvents('storeloaded', 'storecleared');
1211 </code></pre>
1212
1213 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1214 </li></ul></div></div></div><div id="method-addListener" class="member inherited"><a href="Ext.form.field.Text.html#method-addListener" rel="method-addListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-addListener" class="viewSource">view source</a></div><a name="addListener"></a><a name="method-addListener"></a><a href="Ext.form.field.Text.html#" rel="method-addListener" class="cls expand">addListener</a>(
1215 <span class="pre">String eventName, Function handler, [Object scope], [Object options]</span>)
1216  : void</div><div class="description"><div class="short"><p>Appends an event handler to this object.</p>
1217 </div><div class="long"><p>Appends an event handler to this object.</p>
1218 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The name of the event to listen for. May also be an object who's property names are event names. See</p>
1219 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The method the event invokes.</p>
1220 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope (<code><b>this</b></code> reference) in which the handler function is executed.
1221 <b>If omitted, defaults to the object which fired the event.</b></p>
1222 </div></li><li><span class="pre">options</span> : Object<div class="sub-desc"><p>(optional) An object containing handler configuration.
1223 properties. This may contain any of the following properties:<ul>
1224 <li><b>scope</b> : Object<div class="sub-desc">The scope (<code><b>this</b></code> reference) in which the handler function is executed.
1225 <b>If omitted, defaults to the object which fired the event.</b></div></li>
1226 <li><b>delay</b> : Number<div class="sub-desc">The number of milliseconds to delay the invocation of the handler after the event fires.</div></li>
1227 <li><b>single</b> : Boolean<div class="sub-desc">True to add a handler to handle just the next firing of the event, and then remove itself.</div></li>
1228 <li><b>buffer</b> : Number<div class="sub-desc">Causes the handler to be scheduled to run in an <a href="Ext.util.DelayedTask.html" rel="Ext.util.DelayedTask" class="docClass">Ext.util.DelayedTask</a> delayed
1229 by the specified number of milliseconds. If the event fires again within that time, the original
1230 handler is <em>not</em> invoked, but the new handler is scheduled in its place.</div></li>
1231 <li><b>target</b> : Observable<div class="sub-desc">Only call the handler if the event was fired on the target Observable, <i>not</i>
1232 if the event was bubbled up from a child Observable.</div></li>
1233 <li><b>element</b> : String<div class="sub-desc"><b>This option is only valid for listeners bound to <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Components</a>.</b>
1234 The name of a Component property which references an element to add a listener to.</p>
1235
1236 <p>This option is useful during Component construction to add DOM event listeners to elements of <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Components</a> which
1237 will exist only after the Component is rendered. For example, to add a click listener to a Panel's body:
1238 <pre><code>new Ext.panel.Panel({
1239     title: 'The title',
1240     listeners: {
1241         click: this.handlePanelClick,
1242         element: 'body'
1243     }
1244 });
1245 </code></pre></p>
1246
1247
1248 <p>When added in this way, the options available are the options applicable to <a href="Ext.core.Element.html#addListener" rel="Ext.core.Element#addListener" class="docClass">Ext.core.Element.addListener</a></p>
1249
1250
1251 <p></div></li>
1252 </ul><br></p>
1253
1254 <p>
1255 <b>Combining Options</b><br>
1256 Using the options argument, it is possible to combine different types of listeners:<br>
1257 <br>
1258 A delayed, one-time listener.
1259 <pre><code>myPanel.on('hide', this.handleClick, this, {
1260 single: true,
1261 delay: 100
1262 });</code></pre>
1263 <p>
1264 <b>Attaching multiple handlers in 1 call</b><br>
1265 The method also allows for a single argument to be passed which is a config object containing properties
1266 which specify multiple events. For example:
1267 <pre><code>myGridPanel.on({
1268     cellClick: this.onCellClick,
1269     mouseover: this.onMouseOver,
1270     mouseout: this.onMouseOut,
1271     scope: this // Important. Ensure "this" is correct during handler execution
1272 });
1273 </code></pre>.
1274 <p>
1275
1276 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1277 </li></ul></div></div></div><div id="method-addManagedListener" class="member inherited"><a href="Ext.form.field.Text.html#method-addManagedListener" rel="method-addManagedListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-addManagedListener" class="viewSource">view source</a></div><a name="addManagedListener"></a><a name="method-addManagedListener"></a><a href="Ext.form.field.Text.html#" rel="method-addManagedListener" class="cls expand">addManagedListener</a>(
1278 <span class="pre">Observable/Element item, Object/String ename, Function fn, Object scope, Object opt</span>)
1279  : void</div><div class="description"><div class="short"><p>Adds listeners to any Observable object (or Element) which are automatically removed when this Component
1280 is destroyed.
1281
1282 </div><div class="long"><p>Adds listeners to any Observable object (or Element) which are automatically removed when this Component
1283 is destroyed.
1284
1285 <h3 class="pa">Parameters</h3><ul><li><span class="pre">item</span> : Observable/Element<div class="sub-desc"><p>The item to which to add a listener/listeners.</p>
1286 </div></li><li><span class="pre">ename</span> : Object/String<div class="sub-desc"><p>The event name, or an object containing event name properties.</p>
1287 </div></li><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
1288 is the handler function.</p>
1289 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
1290 is the scope (<code>this</code> reference) in which the handler function is executed.</p>
1291 </div></li><li><span class="pre">opt</span> : Object<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
1292 is the <a href="Ext.util.Observable.html#addListener" rel="Ext.util.Observable#addListener" class="docClass">addListener</a> options.</p>
1293 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1294 </li></ul></div></div></div><div id="method-addStateEvents" class="member inherited"><a href="Ext.form.field.Text.html#method-addStateEvents" rel="method-addStateEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-method-addStateEvents" class="viewSource">view source</a></div><a name="addStateEvents"></a><a name="method-addStateEvents"></a><a href="Ext.form.field.Text.html#" rel="method-addStateEvents" class="cls expand">addStateEvents</a>(
1295 <span class="pre">String/Array events</span>)
1296  : void</div><div class="description"><div class="short"><p>Add events that will trigger the state to be saved.</p>
1297 </div><div class="long"><p>Add events that will trigger the state to be saved.</p>
1298 <h3 class="pa">Parameters</h3><ul><li><span class="pre">events</span> : String/Array<div class="sub-desc"><p>The event name or an array of event names.</p>
1299 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1300 </li></ul></div></div></div><div id="method-afterComponentLayout" class="member inherited"><a href="Ext.form.field.Text.html#method-afterComponentLayout" rel="method-afterComponentLayout" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-afterComponentLayout" class="viewSource">view source</a></div><a name="afterComponentLayout"></a><a name="method-afterComponentLayout"></a><a href="Ext.form.field.Text.html#" rel="method-afterComponentLayout" class="cls expand">afterComponentLayout</a>(
1301 <span class="pre">Number adjWidth, Number adjHeight, Boolean isSetSize, Ext.Component layoutOwner</span>)
1302  : void</div><div class="description"><div class="short"><p>&nbsp;</p></div><div class="long">
1303 <h3 class="pa">Parameters</h3><ul><li><span class="pre">adjWidth</span> : Number<div class="sub-desc"><p>The box-adjusted width that was set</p>
1304 </div></li><li><span class="pre">adjHeight</span> : Number<div class="sub-desc"><p>The box-adjusted height that was set</p>
1305 </div></li><li><span class="pre">isSetSize</span> : Boolean<div class="sub-desc"><p>Whether or not the height/width are stored on the component permanently</p>
1306 </div></li><li><span class="pre">layoutOwner</span> : Ext.Component<div class="sub-desc"><p>Component which sent the layout. Only used when isSetSize is false.</p>
1307 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1308 </li></ul></div></div></div><div id="method-alignTo" class="member inherited"><a href="Ext.form.field.Text.html#method-alignTo" rel="method-alignTo" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-method-alignTo" class="viewSource">view source</a></div><a name="alignTo"></a><a name="method-alignTo"></a><a href="Ext.form.field.Text.html#" rel="method-alignTo" class="cls expand">alignTo</a>(
1309 <span class="pre">Mixed element, String position, [Array offsets]</span>)
1310  : Component</div><div class="description"><div class="short"><p>Aligns this floating Component to the specified element</p>
1311 </div><div class="long"><p>Aligns this floating Component to the specified element</p>
1312 <h3 class="pa">Parameters</h3><ul><li><span class="pre">element</span> : Mixed<div class="sub-desc"><p>The element or <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> to align to. If passing a component, it must
1313 be a omponent instance. If a string id is passed, it will be used as an element id.</p>
1314 </div></li><li><span class="pre">position</span> : String<div class="sub-desc"><p>(optional, defaults to "tl-bl?") The position to align to (see <a href="Ext.core.Element.html#alignTo" rel="Ext.core.Element#alignTo" class="docClass">Ext.core.Element.alignTo</a> for more details).</p>
1315 </div></li><li><span class="pre">offsets</span> : Array<div class="sub-desc"><p>(optional) Offset the positioning by [x, y]</p>
1316 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Component</span>&nbsp; &nbsp;<p>this</p>
1317 </li></ul></div></div></div><div id="method-animate" class="member inherited"><a href="Ext.form.field.Text.html#method-animate" rel="method-animate" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-method-animate" class="viewSource">view source</a></div><a name="animate"></a><a name="method-animate"></a><a href="Ext.form.field.Text.html#" rel="method-animate" class="cls expand">animate</a>(
1318 <span class="pre">Object config</span>)
1319  : Object</div><div class="description"><div class="short">Perform custom animation on this object.
1320 This method is applicable to both the the Component class and the Element cl...</div><div class="long"><p>Perform custom animation on this object.<p>
1321 <p>This method is applicable to both the the <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Component</a> class and the <a href="Ext.core.Element.html" rel="Ext.core.Element" class="docClass">Element</a> class.
1322 It performs animated transitions of certain properties of this object over a specified timeline.</p>
1323 <p>The sole parameter is an object which specifies start property values, end property values, and properties which
1324 describe the timeline. Of the properties listed below, only <b><code>to</code></b> is mandatory.</p>
1325 <p>Properties include<ul>
1326 <li><code>from</code> <div class="sub-desc">An object which specifies start values for the properties being animated.
1327 If not supplied, properties are animated from current settings. The actual properties which may be animated depend upon
1328 ths object being animated. See the sections below on Element and Component animation.<div></li>
1329 <li><code>to</code> <div class="sub-desc">An object which specifies end values for the properties being animated.</div></li>
1330 <li><code>duration</code><div class="sub-desc">The duration <b>in milliseconds</b> for which the animation will run.</div></li>
1331 <li><code>easing</code> <div class="sub-desc">A string value describing an easing type to modify the rate of change from the default linear to non-linear. Values may be one of:<code><ul>
1332 <li>ease</li>
1333 <li>easeIn</li>
1334 <li>easeOut</li>
1335 <li>easeInOut</li>
1336 <li>backIn</li>
1337 <li>backOut</li>
1338 <li>elasticIn</li>
1339 <li>elasticOut</li>
1340 <li>bounceIn</li>
1341 <li>bounceOut</li>
1342 </ul></code></div></li>
1343 <li><code>keyframes</code> <div class="sub-desc">This is an object which describes the state of animated properties at certain points along the timeline.
1344 it is an object containing properties who's names are the percentage along the timeline being described and who's values specify the animation state at that point.</div></li>
1345 <li><code>listeners</code> <div class="sub-desc">This is a standard <a href="Ext.util.Observable.html#listeners" rel="Ext.util.Observable#listeners" class="docClass">listeners</a> configuration object which may be used
1346 to inject behaviour at either the <code>beforeanimate</code> event or the <code>afteranimate</code> event.</div></li>
1347 </ul></p>
1348 <h3>Animating an <a href="Ext.core.Element.html" rel="Ext.core.Element" class="docClass">Element</a></h3>
1349 When animating an Element, the following properties may be specified in <code>from</code>, <code>to</code>, and <code>keyframe</code> objects:<ul>
1350 <li><code>x</code> <div class="sub-desc">The page X position in pixels.</div></li>
1351 <li><code>y</code> <div class="sub-desc">The page Y position in pixels</div></li>
1352 <li><code>left</code> <div class="sub-desc">The element's CSS <code>left</code> value. Units must be supplied.</div></li>
1353 <li><code>top</code> <div class="sub-desc">The element's CSS <code>top</code> value. Units must be supplied.</div></li>
1354 <li><code>width</code> <div class="sub-desc">The element's CSS <code>width</code> value. Units must be supplied.</div></li>
1355 <li><code>height</code> <div class="sub-desc">The element's CSS <code>height</code> value. Units must be supplied.</div></li>
1356 <li><code>scrollLeft</code> <div class="sub-desc">The element's <code>scrollLeft</code> value.</div></li>
1357 <li><code>scrollTop</code> <div class="sub-desc">The element's <code>scrollLeft</code> value.</div></li>
1358 <li><code>opacity</code> <div class="sub-desc">The element's <code>opacity</code> value. This must be a value between <code>0</code> and <code>1</code>.</div></li>
1359 </ul>
1360 <p><b>Be aware than animating an Element which is being used by an <a href="Ext.html" rel="Ext" class="docClass">Ext</a> Component without in some way informing the Component about the changed element state
1361 will result in incorrect Component behaviour. This is because the Component will be using the old state of the element. To avoid this problem, it is now possible to
1362 directly animate certain properties of Components.</b></p>
1363 <h3>Animating a <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Component</a></h3>
1364 When animating an Element, the following properties may be specified in <code>from</code>, <code>to</code>, and <code>keyframe</code> objects:<ul>
1365 <li><code>x</code> <div class="sub-desc">The Component's page X position in pixels.</div></li>
1366 <li><code>y</code> <div class="sub-desc">The Component's page Y position in pixels</div></li>
1367 <li><code>left</code> <div class="sub-desc">The Component's <code>left</code> value in pixels.</div></li>
1368 <li><code>top</code> <div class="sub-desc">The Component's <code>top</code> value in pixels.</div></li>
1369 <li><code>width</code> <div class="sub-desc">The Component's <code>width</code> value in pixels.</div></li>
1370 <li><code>width</code> <div class="sub-desc">The Component's <code>width</code> value in pixels.</div></li>
1371 <li><code>dynamic</code> <div class="sub-desc">Specify as true to update the Component's layout (if it is a Container) at every frame
1372 of the animation. <i>Use sparingly as laying out on every intermediate size change is an expensive operation</i>.</div></li>
1373 </ul>
1374 <p>For example, to animate a Window to a new size, ensuring that its internal layout, and any shadow is correct:</p>
1375 <pre><code>myWindow = Ext.create('Ext.window.Window', {
1376     title: 'Test Component animation',
1377     width: 500,
1378     height: 300,
1379     layout: {
1380         type: 'hbox',
1381         align: 'stretch'
1382     },
1383     items: [{
1384         title: 'Left: 33%',
1385         margins: '5 0 5 5',
1386         flex: 1
1387     }, {
1388         title: 'Left: 66%',
1389         margins: '5 5 5 5',
1390         flex: 2
1391     }]
1392 });
1393 myWindow.show();
1394 myWindow.header.el.on('click', function() {
1395     myWindow.animate({
1396         to: {
1397             width: (myWindow.getWidth() == 500) ? 700 : 500,
1398             height: (myWindow.getHeight() == 300) ? 400 : 300,
1399         }
1400     });
1401 });
1402 </code></pre>
1403 <p>For performance reasons, by default, the internal layout is only updated when the Window reaches its final <code>"to"</code> size. If dynamic updating of the Window's child
1404 Components is required, then configure the animation with <code>dynamic: true</code> and the two child items will maintain their proportions during the animation.</p>
1405
1406 <h3 class="pa">Parameters</h3><ul><li><span class="pre">config</span> : Object<div class="sub-desc"><p>An object containing properties which describe the animation's start and end states, and the timeline of the animation.</p>
1407 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>this</p>
1408 </li></ul></div></div></div><div id="method-applyState" class="member inherited"><a href="Ext.form.field.Text.html#method-applyState" rel="method-applyState" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-method-applyState" class="viewSource">view source</a></div><a name="applyState"></a><a name="method-applyState"></a><a href="Ext.form.field.Text.html#" rel="method-applyState" class="cls expand">applyState</a>(
1409 <span class="pre">Object state</span>)
1410  : void</div><div class="description"><div class="short">Applies the state to the object. This should be overridden in subclasses to do
1411 more complex state operations. By defa...</div><div class="long"><p>Applies the state to the object. This should be overridden in subclasses to do
1412 more complex state operations. By default it applies the state properties onto
1413 the current object.</p>
1414 <h3 class="pa">Parameters</h3><ul><li><span class="pre">state</span> : Object<div class="sub-desc"><p>The state</p>
1415 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1416 </li></ul></div></div></div><div id="method-autoSize" class="member ni"><a href="Ext.form.field.Text.html#method-autoSize" rel="method-autoSize" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-method-autoSize" class="viewSource">view source</a></div><a name="autoSize"></a><a name="method-autoSize"></a><a href="Ext.form.field.Text.html#" rel="method-autoSize" class="cls expand">autoSize</a> : void</div><div class="description"><div class="short">Automatically grows the field to accomodate the width of the text up to the maximum field width allowed.
1417 This only ta...</div><div class="long"><p>Automatically grows the field to accomodate the width of the text up to the maximum field width allowed.
1418 This only takes effect if <tt><a href="Ext.form.field.Text.html#grow" rel="Ext.form.field.Text#grow" class="docClass">grow</a> = true</tt>, and fires the <a href="Ext.form.field.Text.html#autosize" rel="Ext.form.field.Text#autosize" class="docClass">autosize</a> event if the
1419 width changes.</p>
1420 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1421 </li></ul></div></div></div><div id="method-batchChanges" class="member inherited"><a href="Ext.form.field.Text.html#method-batchChanges" rel="method-batchChanges" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-batchChanges" class="viewSource">view source</a></div><a name="batchChanges"></a><a name="method-batchChanges"></a><a href="Ext.form.field.Text.html#" rel="method-batchChanges" class="cls expand">batchChanges</a>(
1422 <span class="pre">Object fn</span>)
1423  : void</div><div class="description"><div class="short">A utility for grouping a set of modifications which may trigger value changes into a single
1424 transaction, to prevent e...</div><div class="long"><p>A utility for grouping a set of modifications which may trigger value changes into a single
1425 transaction, to prevent excessive firing of <a href="Ext.form.field.Text.html#change" rel="Ext.form.field.Text#change" class="docClass">change</a> events. This is useful for instance
1426 if the field has sub-fields which are being updated as a group; you don't want the container
1427 field to check its own changed state for each subfield change.</p>
1428 <h3 class="pa">Parameters</h3><ul><li><span class="pre">fn</span> : Object<div class="sub-desc"><p>A function containing the transaction code</p>
1429 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1430 </li></ul></div></div></div><div id="method-beforeComponentLayout" class="member inherited"><a href="Ext.form.field.Text.html#method-beforeComponentLayout" rel="method-beforeComponentLayout" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-beforeComponentLayout" class="viewSource">view source</a></div><a name="beforeComponentLayout"></a><a name="method-beforeComponentLayout"></a><a href="Ext.form.field.Text.html#" rel="method-beforeComponentLayout" class="cls expand">beforeComponentLayout</a>(
1431 <span class="pre">Number adjWidth, Number adjHeight, Boolean isSetSize, Ext.Component layoutOwner</span>)
1432  : void</div><div class="description"><div class="short">Occurs before componentLayout is run. Returning false from this method will prevent the componentLayout
1433 from being ex...</div><div class="long"><p>Occurs before componentLayout is run. Returning false from this method will prevent the componentLayout
1434 from being executed.</p>
1435 <h3 class="pa">Parameters</h3><ul><li><span class="pre">adjWidth</span> : Number<div class="sub-desc"><p>The box-adjusted width that was set</p>
1436 </div></li><li><span class="pre">adjHeight</span> : Number<div class="sub-desc"><p>The box-adjusted height that was set</p>
1437 </div></li><li><span class="pre">isSetSize</span> : Boolean<div class="sub-desc"><p>Whether or not the height/width are stored on the component permanently</p>
1438 </div></li><li><span class="pre">layoutOwner</span> : Ext.Component<div class="sub-desc"><p>Component which sent the layout. Only used when isSetSize is false.</p>
1439 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1440 </li></ul></div></div></div><div id="method-bubble" class="member inherited"><a href="Ext.form.field.Text.html#method-bubble" rel="method-bubble" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-bubble" class="viewSource">view source</a></div><a name="bubble"></a><a name="method-bubble"></a><a href="Ext.form.field.Text.html#" rel="method-bubble" class="cls expand">bubble</a>(
1441 <span class="pre">Function fn, [Object scope], [Array args]</span>)
1442  : Ext.Component</div><div class="description"><div class="short">Bubbles up the component/container heirarchy, calling the specified function with each component. The scope (this) of...</div><div class="long"><p>Bubbles up the component/container heirarchy, calling the specified function with each component. The scope (<i>this</i>) of
1443 function call will be the scope provided or the current component. The arguments to the function
1444 will be the args provided or the current component. If the function returns false at any point,
1445 the bubble is stopped.</p>
1446 <h3 class="pa">Parameters</h3><ul><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>The function to call</p>
1447 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope of the function (defaults to current node)</p>
1448 </div></li><li><span class="pre">args</span> : Array<div class="sub-desc"><p>(optional) The args to call the function with (default to passing the current component)</p>
1449 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
1450 </li></ul></div></div></div><div id="method-capture" class="member inherited"><a href="Ext.form.field.Text.html#method-capture" rel="method-capture" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-capture" class="viewSource">view source</a></div><a name="capture"></a><a name="method-capture"></a><a href="Ext.form.field.Text.html#" rel="method-capture" class="cls expand">capture</a>(
1451 <span class="pre">Observable o, Function fn, [Object scope]</span>)
1452  : void</div><div class="description"><div class="short">Starts capture on the specified Observable. All events will be passed
1453 to the supplied function with the event name + ...</div><div class="long"><p>Starts capture on the specified Observable. All events will be passed
1454 to the supplied function with the event name + standard signature of the event
1455 <b>before</b> the event is fired. If the supplied function returns false,
1456 the event will not fire.</p>
1457 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Observable<div class="sub-desc"><p>The Observable to capture events from.</p>
1458 </div></li><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>The function to call when an event is fired.</p>
1459 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope (<code>this</code> reference) in which the function is executed. Defaults to the Observable firing the event.</p>
1460 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1461 </li></ul></div></div></div><div id="method-center" class="member inherited"><a href="Ext.form.field.Text.html#method-center" rel="method-center" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-method-center" class="viewSource">view source</a></div><a name="center"></a><a name="method-center"></a><a href="Ext.form.field.Text.html#" rel="method-center" class="cls expand">center</a> : Component</div><div class="description"><div class="short"><p>Center this Component in its container.</p>
1462 </div><div class="long"><p>Center this Component in its container.</p>
1463 <h3 class="pa">Returns</h3><ul><li><span class="pre">Component</span>&nbsp; &nbsp;<p>this</p>
1464 </li></ul></div></div></div><div id="method-checkChange" class="member inherited"><a href="Ext.form.field.Text.html#method-checkChange" rel="method-checkChange" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-checkChange" class="viewSource">view source</a></div><a name="checkChange"></a><a name="method-checkChange"></a><a href="Ext.form.field.Text.html#" rel="method-checkChange" class="cls expand">checkChange</a> : void</div><div class="description"><div class="short">Checks whether the value of the field has changed since the last time it was checked. If the value
1465 has changed, it:
1466
1467 ...</div><div class="long"><p>Checks whether the value of the field has changed since the last time it was checked. If the value
1468 has changed, it:</p>
1469
1470
1471 <ol>
1472 <li>Fires the <a href="Ext.form.field.Text.html#change" rel="Ext.form.field.Text#change" class="docClass">change event</a>,</li>
1473 <li>Performs validation if the <a href="Ext.form.field.Text.html#validateOnChange" rel="Ext.form.field.Text#validateOnChange" class="docClass">validateOnChange</a> config is enabled, firing the
1474 <a href="Ext.form.field.Text.html#validationchange" rel="Ext.form.field.Text#validationchange" class="docClass">validationchange event</a> if the validity has changed, and</li>
1475 <li>Checks the <a href="Ext.form.field.Text.html#isDirty" rel="Ext.form.field.Text#isDirty" class="docClass">dirty state</a> of the field and fires the <a href="Ext.form.field.Text.html#dirtychange" rel="Ext.form.field.Text#dirtychange" class="docClass">dirtychange event</a>
1476 if it has changed.</li>
1477 </ol>
1478
1479 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1480 </li></ul></div></div></div><div id="method-checkDirty" class="member inherited"><a href="Ext.form.field.Text.html#method-checkDirty" rel="method-checkDirty" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-checkDirty" class="viewSource">view source</a></div><a name="checkDirty"></a><a name="method-checkDirty"></a><a href="Ext.form.field.Text.html#" rel="method-checkDirty" class="cls expand">checkDirty</a> : void</div><div class="description"><div class="short">Checks the isDirty state of the field and if it has changed since the last time
1481 it was checked, fires the dirtychange...</div><div class="long"><p>Checks the <a href="Ext.form.field.Text.html#isDirty" rel="Ext.form.field.Text#isDirty" class="docClass">isDirty</a> state of the field and if it has changed since the last time
1482 it was checked, fires the <a href="Ext.form.field.Text.html#dirtychange" rel="Ext.form.field.Text#dirtychange" class="docClass">dirtychange</a> event.</p>
1483 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1484 </li></ul></div></div></div><div id="method-clearInvalid" class="member inherited"><a href="Ext.form.field.Text.html#method-clearInvalid" rel="method-clearInvalid" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-clearInvalid" class="viewSource">view source</a></div><a name="clearInvalid"></a><a name="method-clearInvalid"></a><a href="Ext.form.field.Text.html#" rel="method-clearInvalid" class="cls expand">clearInvalid</a> : void</div><div class="description"><div class="short">Clear any invalid styles/messages for this field.
1485
1486
1487 Note: this method does not cause the Field's validate or isValid ...</div><div class="long"><p>Clear any invalid styles/messages for this field.</p>
1488
1489
1490 <p><b>Note</b>: this method does not cause the Field's <a href="Ext.form.field.Text.html#validate" rel="Ext.form.field.Text#validate" class="docClass">validate</a> or <a href="Ext.form.field.Text.html#isValid" rel="Ext.form.field.Text#isValid" class="docClass">isValid</a> methods to
1491 return <code>true</code> if the value does not <i>pass</i> validation. So simply clearing a field's errors
1492 will not necessarily allow submission of forms submitted with the <a href="Ext.form.action.Submit.html#clientValidation" rel="Ext.form.action.Submit#clientValidation" class="docClass">Ext.form.action.Submit.clientValidation</a>
1493 option set.</p>
1494
1495 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1496 </li></ul></div></div></div><div id="method-clearListeners" class="member inherited"><a href="Ext.form.field.Text.html#method-clearListeners" rel="method-clearListeners" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-clearListeners" class="viewSource">view source</a></div><a name="clearListeners"></a><a name="method-clearListeners"></a><a href="Ext.form.field.Text.html#" rel="method-clearListeners" class="cls expand">clearListeners</a> : void</div><div class="description"><div class="short"><p>Removes all listeners for this object including the managed listeners</p>
1497 </div><div class="long"><p>Removes all listeners for this object including the managed listeners</p>
1498 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1499 </li></ul></div></div></div><div id="method-clearManagedListeners" class="member inherited"><a href="Ext.form.field.Text.html#method-clearManagedListeners" rel="method-clearManagedListeners" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-clearManagedListeners" class="viewSource">view source</a></div><a name="clearManagedListeners"></a><a name="method-clearManagedListeners"></a><a href="Ext.form.field.Text.html#" rel="method-clearManagedListeners" class="cls expand">clearManagedListeners</a> : void</div><div class="description"><div class="short"><p>Removes all managed listeners for this object.</p>
1500 </div><div class="long"><p>Removes all managed listeners for this object.</p>
1501 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1502 </li></ul></div></div></div><div id="method-cloneConfig" class="member inherited"><a href="Ext.form.field.Text.html#method-cloneConfig" rel="method-cloneConfig" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-cloneConfig" class="viewSource">view source</a></div><a name="cloneConfig"></a><a name="method-cloneConfig"></a><a href="Ext.form.field.Text.html#" rel="method-cloneConfig" class="cls expand">cloneConfig</a>(
1503 <span class="pre">Object overrides</span>)
1504  : Ext.Component</div><div class="description"><div class="short"><p>Clone the current component using the original config values passed into this instance by default.</p>
1505 </div><div class="long"><p>Clone the current component using the original config values passed into this instance by default.</p>
1506 <h3 class="pa">Parameters</h3><ul><li><span class="pre">overrides</span> : Object<div class="sub-desc"><p>A new config containing any properties to override in the cloned version.
1507 An id property can be passed on this object, otherwise one will be generated to avoid duplicates.</p>
1508 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>clone The cloned copy of this component</p>
1509 </li></ul></div></div></div><div id="method-destroy" class="member inherited"><a href="Ext.form.field.Text.html#method-destroy" rel="method-destroy" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-method-destroy" class="viewSource">view source</a></div><a name="destroy"></a><a name="method-destroy"></a><a href="Ext.form.field.Text.html#" rel="method-destroy" class="cls expand">destroy</a> : void</div><div class="description"><div class="short"><p>Destroys this stateful object.</p>
1510 </div><div class="long"><p>Destroys this stateful object.</p>
1511 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1512 </li></ul></div></div></div><div id="method-disable" class="member inherited"><a href="Ext.form.field.Text.html#method-disable" rel="method-disable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-disable" class="viewSource">view source</a></div><a name="disable"></a><a name="method-disable"></a><a href="Ext.form.field.Text.html#" rel="method-disable" class="cls expand">disable</a>(
1513 <span class="pre">Boolean silent</span>)
1514  : void</div><div class="description"><div class="short"><p>Disable the component.</p>
1515 </div><div class="long"><p>Disable the component.</p>
1516 <h3 class="pa">Parameters</h3><ul><li><span class="pre">silent</span> : Boolean<div class="sub-desc"><p>Passing true, will supress the 'disable' event from being fired.</p>
1517 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1518 </li></ul></div></div></div><div id="method-doAutoRender" class="member inherited"><a href="Ext.form.field.Text.html#method-doAutoRender" rel="method-doAutoRender" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-doAutoRender" class="viewSource">view source</a></div><a name="doAutoRender"></a><a name="method-doAutoRender"></a><a href="Ext.form.field.Text.html#" rel="method-doAutoRender" class="cls expand">doAutoRender</a> : void</div><div class="description"><div class="short">Handles autoRender.
1519 Floating Components may have an ownerCt. If they are asking to be constrained, constrain them wit...</div><div class="long"><p>Handles autoRender.
1520 Floating Components may have an ownerCt. If they are asking to be constrained, constrain them within that
1521 ownerCt, and have their z-index managed locally. Floating Components are always rendered to document.body</p>
1522 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1523 </li></ul></div></div></div><div id="method-doComponentLayout" class="member inherited"><a href="Ext.form.field.Text.html#method-doComponentLayout" rel="method-doComponentLayout" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-doComponentLayout" class="viewSource">view source</a></div><a name="doComponentLayout"></a><a name="method-doComponentLayout"></a><a href="Ext.form.field.Text.html#" rel="method-doComponentLayout" class="cls expand">doComponentLayout</a>(
1524 <span class="pre">Object width, Object height, Object isSetSize, Object ownerCt</span>)
1525  : Ext.container.Container</div><div class="description"><div class="short">This method needs to be called whenever you change something on this component that requires the Component's
1526 layout t...</div><div class="long"><p>This method needs to be called whenever you change something on this component that requires the Component's
1527 layout to be recalculated.</p>
1528 <h3 class="pa">Parameters</h3><ul><li><span class="pre">width</span> : Object<div class="sub-desc">
1529 </div></li><li><span class="pre">height</span> : Object<div class="sub-desc">
1530 </div></li><li><span class="pre">isSetSize</span> : Object<div class="sub-desc">
1531 </div></li><li><span class="pre">ownerCt</span> : Object<div class="sub-desc">
1532 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.container.Container</span>&nbsp; &nbsp;<p>this</p>
1533 </li></ul></div></div></div><div id="method-doConstrain" class="member inherited"><a href="Ext.form.field.Text.html#method-doConstrain" rel="method-doConstrain" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-method-doConstrain" class="viewSource">view source</a></div><a name="doConstrain"></a><a name="method-doConstrain"></a><a href="Ext.form.field.Text.html#" rel="method-doConstrain" class="cls expand">doConstrain</a>(
1534 <span class="pre">Mixed constrainTo</span>)
1535  : void</div><div class="description"><div class="short">Moves this floating Component into a constrain region.
1536
1537
1538 By default, this Component is constrained to be within the c...</div><div class="long"><p>Moves this floating Component into a constrain region.</p>
1539
1540
1541 <p>By default, this Component is constrained to be within the container it was added to, or the element
1542 it was rendered to.</p>
1543
1544
1545 <p>An alternative constraint may be passed.</p>
1546
1547 <h3 class="pa">Parameters</h3><ul><li><span class="pre">constrainTo</span> : Mixed<div class="sub-desc"><p>Optional. The Element or <a href="Ext.util.Region.html" rel="Ext.util.Region" class="docClass">Region</a> into which this Component is to be constrained.</p>
1548 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1549 </li></ul></div></div></div><div id="method-enable" class="member inherited"><a href="Ext.form.field.Text.html#method-enable" rel="method-enable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-enable" class="viewSource">view source</a></div><a name="enable"></a><a name="method-enable"></a><a href="Ext.form.field.Text.html#" rel="method-enable" class="cls expand">enable</a>(
1550 <span class="pre">Boolean silent</span>)
1551  : void</div><div class="description"><div class="short"><p>Enable the component</p>
1552 </div><div class="long"><p>Enable the component</p>
1553 <h3 class="pa">Parameters</h3><ul><li><span class="pre">silent</span> : Boolean<div class="sub-desc"><p>Passing false will supress the 'enable' event from being fired.</p>
1554 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1555 </li></ul></div></div></div><div id="method-enableBubble" class="member inherited"><a href="Ext.form.field.Text.html#method-enableBubble" rel="method-enableBubble" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-enableBubble" class="viewSource">view source</a></div><a name="enableBubble"></a><a name="method-enableBubble"></a><a href="Ext.form.field.Text.html#" rel="method-enableBubble" class="cls expand">enableBubble</a>(
1556 <span class="pre">String/Array events</span>)
1557  : void</div><div class="description"><div class="short">Enables events fired by this Observable to bubble up an owner hierarchy by calling
1558 this.getBubbleTarget() if present....</div><div class="long"><p>Enables events fired by this Observable to bubble up an owner hierarchy by calling
1559 <code>this.getBubbleTarget()</code> if present. There is no implementation in the Observable base class.</p>
1560
1561
1562 <p>This is commonly used by Ext.Components to bubble events to owner Containers. See <a href="Ext.Component.html#getBubbleTarget" rel="Ext.Component#getBubbleTarget" class="docClass">Ext.Component.getBubbleTarget</a>. The default
1563 implementation in <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> returns the Component's immediate owner. But if a known target is required, this can be overridden to
1564 access the required target more quickly.</p>
1565
1566
1567 <p>Example:</p>
1568
1569
1570 <pre><code>Ext.override(Ext.form.field.Base, {
1571 //  Add functionality to Field&#39;s initComponent to enable the change event to bubble
1572 initComponent : Ext.Function.createSequence(Ext.form.field.Base.prototype.initComponent, function() {
1573     this.enableBubble('change');
1574 }),
1575
1576 //  We know that we want Field&#39;s events to bubble directly to the FormPanel.
1577 getBubbleTarget : function() {
1578     if (!this.formPanel) {
1579         this.formPanel = this.findParentByType('form');
1580     }
1581     return this.formPanel;
1582 }
1583 });
1584
1585 var myForm = new Ext.formPanel({
1586 title: 'User Details',
1587 items: [{
1588     ...
1589 }],
1590 listeners: {
1591     change: function() {
1592         // Title goes red if form has been modified.
1593         myForm.header.setStyle('color', 'red');
1594     }
1595 }
1596 });
1597 </code></pre>
1598
1599 <h3 class="pa">Parameters</h3><ul><li><span class="pre">events</span> : String/Array<div class="sub-desc"><p>The event name to bubble, or an Array of event names.</p>
1600 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1601 </li></ul></div></div></div><div id="method-extractFileInput" class="member inherited"><a href="Ext.form.field.Text.html#method-extractFileInput" rel="method-extractFileInput" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-extractFileInput" class="viewSource">view source</a></div><a name="extractFileInput"></a><a name="method-extractFileInput"></a><a href="Ext.form.field.Text.html#" rel="method-extractFileInput" class="cls expand">extractFileInput</a> : HTMLInputElement</div><div class="description"><div class="short">Only relevant if the instance's isFileUpload method returns true. Returns a reference
1602 to the file input DOM element h...</div><div class="long"><p>Only relevant if the instance's <a href="Ext.form.field.Text.html#isFileUpload" rel="Ext.form.field.Text#isFileUpload" class="docClass">isFileUpload</a> method returns true. Returns a reference
1603 to the file input DOM element holding the user's selected file. The input will be appended into
1604 the submission form and will not be returned, so this method should also create a replacement.</p>
1605 <h3 class="pa">Returns</h3><ul><li><span class="pre">HTMLInputElement</span>&nbsp; &nbsp;
1606 </li></ul></div></div></div><div id="method-findLayoutController" class="member inherited"><a href="Ext.form.field.Text.html#method-findLayoutController" rel="method-findLayoutController" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-findLayoutController" class="viewSource">view source</a></div><a name="findLayoutController"></a><a name="method-findLayoutController"></a><a href="Ext.form.field.Text.html#" rel="method-findLayoutController" class="cls expand">findLayoutController</a> : void</div><div class="description"><div class="short">This method finds the topmost active layout who's processing will eventually determine the size and position of this
1607 ...</div><div class="long"><p>This method finds the topmost active layout who's processing will eventually determine the size and position of this
1608 Component.<p>
1609 <p>This method is useful when dynamically adding Components into Containers, and some processing must take place after the
1610 final sizing and positioning of the Component has been performed.</p>
1611
1612 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1613 </li></ul></div></div></div><div id="method-findParentBy" class="member inherited"><a href="Ext.form.field.Text.html#method-findParentBy" rel="method-findParentBy" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-findParentBy" class="viewSource">view source</a></div><a name="findParentBy"></a><a name="method-findParentBy"></a><a href="Ext.form.field.Text.html#" rel="method-findParentBy" class="cls expand">findParentBy</a>(
1614 <span class="pre">Function fn</span>)
1615  : Ext.container.Container</div><div class="description"><div class="short">Find a container above this component at any level by a custom function. If the passed function returns
1616 true, the con...</div><div class="long"><p>Find a container above this component at any level by a custom function. If the passed function returns
1617 true, the container will be returned.</p>
1618 <h3 class="pa">Parameters</h3><ul><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>The custom function to call with the arguments (container, this component).</p>
1619 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.container.Container</span>&nbsp; &nbsp;<p>The first Container for which the custom function returns true</p>
1620 </li></ul></div></div></div><div id="method-findParentByType" class="member inherited"><a href="Ext.form.field.Text.html#method-findParentByType" rel="method-findParentByType" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-findParentByType" class="viewSource">view source</a></div><a name="findParentByType"></a><a name="method-findParentByType"></a><a href="Ext.form.field.Text.html#" rel="method-findParentByType" class="cls expand">findParentByType</a>(
1621 <span class="pre">String/Class xtype</span>)
1622  : Ext.container.Container</div><div class="description"><div class="short"><p>Find a container above this component at any level by xtype or class</p>
1623
1624
1625 <p>See also the <a href="Ext.Component.html#up" rel="Ext.Component#up" class="docClass">up</a> method.</p>
1626
1627 </div><div class="long"><p>Find a container above this component at any level by xtype or class</p>
1628
1629
1630 <p>See also the <a href="Ext.Component.html#up" rel="Ext.Component#up" class="docClass">up</a> method.</p>
1631
1632 <h3 class="pa">Parameters</h3><ul><li><span class="pre">xtype</span> : String/Class<div class="sub-desc"><p>The xtype string for a component, or the class of the component directly</p>
1633 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.container.Container</span>&nbsp; &nbsp;<p>The first Container which matches the given xtype or class</p>
1634 </li></ul></div></div></div><div id="method-fireEvent" class="member inherited"><a href="Ext.form.field.Text.html#method-fireEvent" rel="method-fireEvent" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-fireEvent" class="viewSource">view source</a></div><a name="fireEvent"></a><a name="method-fireEvent"></a><a href="Ext.form.field.Text.html#" rel="method-fireEvent" class="cls expand">fireEvent</a>(
1635 <span class="pre">String eventName, Object... args</span>)
1636  : Boolean</div><div class="description"><div class="short">Fires the specified event with the passed parameters (minus the event name).
1637
1638
1639 An event may be set to bubble up an Ob...</div><div class="long"><p>Fires the specified event with the passed parameters (minus the event name).</p>
1640
1641
1642 <p>An event may be set to bubble up an Observable parent hierarchy (See <a href="Ext.Component.html#getBubbleTarget" rel="Ext.Component#getBubbleTarget" class="docClass">Ext.Component.getBubbleTarget</a>)
1643 by calling <a href="Ext.form.field.Text.html#enableBubble" rel="Ext.form.field.Text#enableBubble" class="docClass">enableBubble</a>.</p>
1644
1645 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The name of the event to fire.</p>
1646 </div></li><li><span class="pre">args</span> : Object...<div class="sub-desc"><p>Variable number of parameters are passed to handlers.</p>
1647 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>returns false if any of the handlers return false otherwise it returns true.</p>
1648 </li></ul></div></div></div><div id="method-focus" class="member inherited"><a href="Ext.form.field.Text.html#method-focus" rel="method-focus" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-focus" class="viewSource">view source</a></div><a name="focus"></a><a name="method-focus"></a><a href="Ext.form.field.Text.html#" rel="method-focus" class="cls expand">focus</a>(
1649 <span class="pre">[Boolean selectText], [Boolean/Number delay]</span>)
1650  : Ext.Component</div><div class="description"><div class="short"><p>Try to focus this component.</p>
1651 </div><div class="long"><p>Try to focus this component.</p>
1652 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selectText</span> : Boolean<div class="sub-desc"><p>(optional) If applicable, true to also select the text in this component</p>
1653 </div></li><li><span class="pre">delay</span> : Boolean/Number<div class="sub-desc"><p>(optional) Delay the focus this number of milliseconds (true for 10 milliseconds).</p>
1654 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
1655 </li></ul></div></div></div><div id="method-getActiveAnimation" class="member inherited"><a href="Ext.form.field.Text.html#method-getActiveAnimation" rel="method-getActiveAnimation" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-method-getActiveAnimation" class="viewSource">view source</a></div><a name="getActiveAnimation"></a><a name="method-getActiveAnimation"></a><a href="Ext.form.field.Text.html#" rel="method-getActiveAnimation" class="cls expand">getActiveAnimation</a> : Mixed</div><div class="description"><div class="short"><p>Returns thq current animation if this object has any effects actively running or queued, else returns false.</p>
1656 </div><div class="long"><p>Returns thq current animation if this object has any effects actively running or queued, else returns false.</p>
1657 <h3 class="pa">Returns</h3><ul><li><span class="pre">Mixed</span>&nbsp; &nbsp;<p>anim if element has active effects, else false</p>
1658 </li></ul></div></div></div><div id="method-getActiveError" class="member inherited"><a href="Ext.form.field.Text.html#method-getActiveError" rel="method-getActiveError" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-getActiveError" class="viewSource">view source</a></div><a name="getActiveError"></a><a name="method-getActiveError"></a><a href="Ext.form.field.Text.html#" rel="method-getActiveError" class="cls expand">getActiveError</a> : String</div><div class="description"><div class="short">Gets the active error message for this component, if any. This does not trigger
1659 validation on its own, it merely retu...</div><div class="long"><p>Gets the active error message for this component, if any. This does not trigger
1660 validation on its own, it merely returns any message that the component may already hold.</p>
1661 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The active error message on the component; if there is no error, an empty string is returned.</p>
1662 </li></ul></div></div></div><div id="method-getActiveErrors" class="member inherited"><a href="Ext.form.field.Text.html#method-getActiveErrors" rel="method-getActiveErrors" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-getActiveErrors" class="viewSource">view source</a></div><a name="getActiveErrors"></a><a name="method-getActiveErrors"></a><a href="Ext.form.field.Text.html#" rel="method-getActiveErrors" class="cls expand">getActiveErrors</a> : Array</div><div class="description"><div class="short">Gets an Array of any active error messages currently applied to the field. This does not trigger
1663 validation on its ow...</div><div class="long"><p>Gets an Array of any active error messages currently applied to the field. This does not trigger
1664 validation on its own, it merely returns any messages that the component may already hold.</p>
1665 <h3 class="pa">Returns</h3><ul><li><span class="pre">Array</span>&nbsp; &nbsp;<p>The active error messages on the component; if there are no errors, an empty Array is returned.</p>
1666 </li></ul></div></div></div><div id="method-getBox" class="member inherited"><a href="Ext.form.field.Text.html#method-getBox" rel="method-getBox" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-getBox" class="viewSource">view source</a></div><a name="getBox"></a><a name="method-getBox"></a><a href="Ext.form.field.Text.html#" rel="method-getBox" class="cls expand">getBox</a>(
1667 <span class="pre">[Boolean local]</span>)
1668  : Object</div><div class="description"><div class="short"><p>Gets the current box measurements of the component's underlying element.</p>
1669 </div><div class="long"><p>Gets the current box measurements of the component's underlying element.</p>
1670 <h3 class="pa">Parameters</h3><ul><li><span class="pre">local</span> : Boolean<div class="sub-desc"><p>(optional) If true the element's left and top are returned instead of page XY (defaults to false)</p>
1671 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>box An object in the format {x, y, width, height}</p>
1672 </li></ul></div></div></div><div id="method-getBubbleTarget" class="member inherited"><a href="Ext.form.field.Text.html#method-getBubbleTarget" rel="method-getBubbleTarget" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getBubbleTarget" class="viewSource">view source</a></div><a name="getBubbleTarget"></a><a name="method-getBubbleTarget"></a><a href="Ext.form.field.Text.html#" rel="method-getBubbleTarget" class="cls expand">getBubbleTarget</a> : Ext.container.Container</div><div class="description"><div class="short"><p>Provides the link for Observable's fireEvent method to bubble up the ownership hierarchy.</p>
1673 </div><div class="long"><p>Provides the link for Observable's fireEvent method to bubble up the ownership hierarchy.</p>
1674 <h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.container.Container</span>&nbsp; &nbsp;<p>the Container which owns this Component.</p>
1675 </li></ul></div></div></div><div id="method-getEl" class="member inherited"><a href="Ext.form.field.Text.html#method-getEl" rel="method-getEl" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getEl" class="viewSource">view source</a></div><a name="getEl"></a><a name="method-getEl"></a><a href="Ext.form.field.Text.html#" rel="method-getEl" class="cls expand">getEl</a> : void</div><div class="description"><div class="short"><p>Retrieves the top level element representing this component.</p>
1676 </div><div class="long"><p>Retrieves the top level element representing this component.</p>
1677 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1678 </li></ul></div></div></div><div id="method-getErrors" class="member ni"><a href="Ext.form.field.Text.html#method-getErrors" rel="method-getErrors" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-method-getErrors" class="viewSource">view source</a></div><a name="getErrors"></a><a name="method-getErrors"></a><a href="Ext.form.field.Text.html#" rel="method-getErrors" class="cls expand">getErrors</a>(
1679 <span class="pre">Mixed value</span>)
1680  : Array</div><div class="description"><div class="short">Validates a value according to the field's validation rules and returns an array of errors
1681 for any failing validation...</div><div class="long"><p>Validates a value according to the field's validation rules and returns an array of errors
1682 for any failing validations. Validation rules are processed in the following order:</p>
1683
1684 <ol>
1685 <li><p><strong>Field specific validator</strong></p>
1686
1687 <p> A validator offers a way to customize and reuse a validation specification.
1688  If a field is configured with a <code><a href="Ext.form.field.Text.html#validator" rel="Ext.form.field.Text#validator" class="docClass">validator</a></code>
1689  function, it will be passed the current field value.  The <code><a href="Ext.form.field.Text.html#validator" rel="Ext.form.field.Text#validator" class="docClass">validator</a></code>
1690  function is expected to return either:</p>
1691
1692 <ul>
1693 <li>Boolean <code>true</code>  if the value is valid (validation continues).</li>
1694 <li>a String to represent the invalid message if invalid (validation halts).</li>
1695 </ul>
1696 </li>
1697 <li><p><strong>Basic Validation</strong></p>
1698
1699 <p> If the <code><a href="Ext.form.field.Text.html#validator" rel="Ext.form.field.Text#validator" class="docClass">validator</a></code> has not halted validation,
1700  basic validation proceeds as follows:</p>
1701
1702 <ul>
1703 <li><p><code><a href="Ext.form.field.Text.html#allowBlank" rel="Ext.form.field.Text#allowBlank" class="docClass">allowBlank</a></code> : (Invalid message = <code><a href="Ext.form.field.Text.html#emptyText" rel="Ext.form.field.Text#emptyText" class="docClass">emptyText</a></code>)</p>
1704
1705 <p>  Depending on the configuration of <code><a href="Ext.form.field.Text.html#allowBlank" rel="Ext.form.field.Text#allowBlank" class="docClass">allowBlank</a></code>, a
1706   blank field will cause validation to halt at this step and return
1707   Boolean true or false accordingly.</p></li>
1708 <li><p><code><a href="Ext.form.field.Text.html#minLength" rel="Ext.form.field.Text#minLength" class="docClass">minLength</a></code> : (Invalid message = <code><a href="Ext.form.field.Text.html#minLengthText" rel="Ext.form.field.Text#minLengthText" class="docClass">minLengthText</a></code>)</p>
1709
1710 <p>  If the passed value does not satisfy the <code><a href="Ext.form.field.Text.html#minLength" rel="Ext.form.field.Text#minLength" class="docClass">minLength</a></code>
1711   specified, validation halts.</p></li>
1712 <li><p><code><a href="Ext.form.field.Text.html#maxLength" rel="Ext.form.field.Text#maxLength" class="docClass">maxLength</a></code> : (Invalid message = <code><a href="Ext.form.field.Text.html#maxLengthText" rel="Ext.form.field.Text#maxLengthText" class="docClass">maxLengthText</a></code>)</p>
1713
1714 <p> If the passed value does not satisfy the <code><a href="Ext.form.field.Text.html#maxLength" rel="Ext.form.field.Text#maxLength" class="docClass">maxLength</a></code>
1715  specified, validation halts.</p></li>
1716 </ul>
1717 </li>
1718 <li><p><strong>Preconfigured Validation Types (VTypes)</strong></p>
1719
1720 <p> If none of the prior validation steps halts validation, a field
1721  configured with a <code><a href="Ext.form.field.Text.html#vtype" rel="Ext.form.field.Text#vtype" class="docClass">vtype</a></code> will utilize the
1722  corresponding <a href="Ext.form.field.VTypes.html" rel="Ext.form.field.VTypes" class="docClass">VTypes</a> validation function.
1723  If invalid, either the field's <code><a href="Ext.form.field.Text.html#vtypeText" rel="Ext.form.field.Text#vtypeText" class="docClass">vtypeText</a></code> or
1724  the VTypes vtype Text property will be used for the invalid message.
1725  Keystrokes on the field will be filtered according to the VTypes
1726  vtype Mask property.</p></li>
1727 <li><p><strong>Field specific regex test</strong></p>
1728
1729 <p> If none of the prior validation steps halts validation, a field's
1730  configured <code><a href="Ext.form.field.Text.html#regex" rel="Ext.form.field.Text#regex" class="docClass">regex</a></code> test will be processed.
1731  The invalid message for this test is configured with <code><a href="Ext.form.field.Text.html#regexText" rel="Ext.form.field.Text#regexText" class="docClass">regexText</a></code></p></li>
1732 </ol>
1733
1734 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value</span> : Mixed<div class="sub-desc"><p>The value to validate. The processed raw value will be used if nothing is passed</p>
1735 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Array</span>&nbsp; &nbsp;<p>Array of any validation errors</p>
1736 </li></ul></div></div></div><div id="method-getFieldLabel" class="member inherited"><a href="Ext.form.field.Text.html#method-getFieldLabel" rel="method-getFieldLabel" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-getFieldLabel" class="viewSource">view source</a></div><a name="getFieldLabel"></a><a name="method-getFieldLabel"></a><a href="Ext.form.field.Text.html#" rel="method-getFieldLabel" class="cls expand">getFieldLabel</a> : String</div><div class="description"><div class="short"><p>Returns the label for the field. Defaults to simply returning the <a href="Ext.form.field.Text.html#fieldLabel" rel="Ext.form.field.Text#fieldLabel" class="docClass">fieldLabel</a> config. Can be
1737 overridden to provide</p>
1738 </div><div class="long"><p>Returns the label for the field. Defaults to simply returning the <a href="Ext.form.field.Text.html#fieldLabel" rel="Ext.form.field.Text#fieldLabel" class="docClass">fieldLabel</a> config. Can be
1739 overridden to provide</p>
1740 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The configured field label, or empty string if not defined</p>
1741 </li></ul></div></div></div><div id="method-getHeight" class="member inherited"><a href="Ext.form.field.Text.html#method-getHeight" rel="method-getHeight" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getHeight" class="viewSource">view source</a></div><a name="getHeight"></a><a name="method-getHeight"></a><a href="Ext.form.field.Text.html#" rel="method-getHeight" class="cls expand">getHeight</a> : Number</div><div class="description"><div class="short"><p>Gets the current height of the component's underlying element.</p>
1742 </div><div class="long"><p>Gets the current height of the component's underlying element.</p>
1743 <h3 class="pa">Returns</h3><ul><li><span class="pre">Number</span>&nbsp; &nbsp;
1744 </li></ul></div></div></div><div id="method-getId" class="member inherited"><a href="Ext.form.field.Text.html#method-getId" rel="method-getId" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getId" class="viewSource">view source</a></div><a name="getId"></a><a name="method-getId"></a><a href="Ext.form.field.Text.html#" rel="method-getId" class="cls expand">getId</a> : void</div><div class="description"><div class="short"><p>Retrieves the id of this component.
1745 Will autogenerate an id if one has not already been set.</p>
1746 </div><div class="long"><p>Retrieves the id of this component.
1747 Will autogenerate an id if one has not already been set.</p>
1748 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1749 </li></ul></div></div></div><div id="method-getInputId" class="member inherited"><a href="Ext.form.field.Text.html#method-getInputId" rel="method-getInputId" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-getInputId" class="viewSource">view source</a></div><a name="getInputId"></a><a name="method-getInputId"></a><a href="Ext.form.field.Text.html#" rel="method-getInputId" class="cls expand">getInputId</a> : String</div><div class="description"><div class="short">Get the input id, if any, for this component. This is used as the "for" attribute on the label element.
1750 Implementing ...</div><div class="long"><p>Get the input id, if any, for this component. This is used as the "for" attribute on the label element.
1751 Implementing subclasses may also use this as e.g. the id for their own <tt>input</tt> element.</p>
1752 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The input id</p>
1753 </li></ul></div></div></div><div id="method-getInsertPosition" class="member inherited"><a href="Ext.form.field.Text.html#method-getInsertPosition" rel="method-getInsertPosition" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getInsertPosition" class="viewSource">view source</a></div><a name="getInsertPosition"></a><a name="method-getInsertPosition"></a><a href="Ext.form.field.Text.html#" rel="method-getInsertPosition" class="cls expand">getInsertPosition</a>(
1754 <span class="pre">String/Number/Element/HTMLElement position</span>)
1755  : HTMLElement</div><div class="description"><div class="short">This function takes the position argument passed to onRender and returns a
1756 DOM element that you can use in the insert...</div><div class="long"><p>This function takes the position argument passed to onRender and returns a
1757 DOM element that you can use in the insertBefore.</p>
1758 <h3 class="pa">Parameters</h3><ul><li><span class="pre">position</span> : String/Number/Element/HTMLElement<div class="sub-desc"><p>Index, element id or element you want
1759 to put this component before.</p>
1760 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">HTMLElement</span>&nbsp; &nbsp;<p>DOM element that you can use in the insertBefore</p>
1761 </li></ul></div></div></div><div id="method-getLoader" class="member inherited"><a href="Ext.form.field.Text.html#method-getLoader" rel="method-getLoader" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getLoader" class="viewSource">view source</a></div><a name="getLoader"></a><a name="method-getLoader"></a><a href="Ext.form.field.Text.html#" rel="method-getLoader" class="cls expand">getLoader</a> : Ext.ComponentLoader</div><div class="description"><div class="short"><p>Gets the <a href="Ext.ComponentLoader.html" rel="Ext.ComponentLoader" class="docClass">Ext.ComponentLoader</a> for this Component.</p>
1762 </div><div class="long"><p>Gets the <a href="Ext.ComponentLoader.html" rel="Ext.ComponentLoader" class="docClass">Ext.ComponentLoader</a> for this Component.</p>
1763 <h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.ComponentLoader</span>&nbsp; &nbsp;<p>The loader instance, null if it doesn't exist.</p>
1764 </li></ul></div></div></div><div id="method-getModelData" class="member inherited"><a href="Ext.form.field.Text.html#method-getModelData" rel="method-getModelData" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-getModelData" class="viewSource">view source</a></div><a name="getModelData"></a><a name="method-getModelData"></a><a href="Ext.form.field.Text.html#" rel="method-getModelData" class="cls expand">getModelData</a> : Object</div><div class="description"><div class="short">Returns the value(s) that should be saved to the Ext.data.Model instance for this field, when
1765 Ext.form.Basic.updateRe...</div><div class="long"><p>Returns the value(s) that should be saved to the <a href="Ext.data.Model.html" rel="Ext.data.Model" class="docClass">Ext.data.Model</a> instance for this field, when
1766 <a href="Ext.form.Basic.html#updateRecord" rel="Ext.form.Basic#updateRecord" class="docClass">Ext.form.Basic.updateRecord</a> is called. Typically this will be an object with a single name-value
1767 pair, the name being this field's <a href="Ext.form.field.Text.html#getName" rel="Ext.form.field.Text#getName" class="docClass">name</a> and the value being its current data value. More
1768 advanced field implementations may return more than one name-value pair. The returned values will be
1769 saved to the corresponding field names in the Model.</p>
1770
1771
1772 <p>Note that the values returned from this method are not guaranteed to have been successfully
1773 <a href="Ext.form.field.Text.html#validate" rel="Ext.form.field.Text#validate" class="docClass">validated</a>.</p>
1774
1775 <h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>A mapping of submit parameter names to values; each value should be a string, or an array
1776 of strings if that particular name has multiple values. It can also return <tt>null</tt> if there are no
1777 parameters to be submitted.</p>
1778 </li></ul></div></div></div><div id="method-getName" class="member inherited"><a href="Ext.form.field.Text.html#method-getName" rel="method-getName" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-getName" class="viewSource">view source</a></div><a name="getName"></a><a name="method-getName"></a><a href="Ext.form.field.Text.html#" rel="method-getName" class="cls expand">getName</a> : String</div><div class="description"><div class="short">Returns the name attribute of the field. This is used as the parameter
1779 name when including the field value in a form ...</div><div class="long"><p>Returns the <a href="Ext.form.field.Field.html#name" rel="Ext.form.field.Field#name" class="docClass">name</a> attribute of the field. This is used as the parameter
1780 name when including the field value in a <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">form submit()</a>.</p>
1781 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>name The field <a href="Ext.form.field.Field.html#name" rel="Ext.form.field.Field#name" class="docClass">name</a></p>
1782 </li></ul></div></div></div><div id="method-getPlugin" class="member inherited"><a href="Ext.form.field.Text.html#method-getPlugin" rel="method-getPlugin" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getPlugin" class="viewSource">view source</a></div><a name="getPlugin"></a><a name="method-getPlugin"></a><a href="Ext.form.field.Text.html#" rel="method-getPlugin" class="cls expand">getPlugin</a>(
1783 <span class="pre">Object pluginId</span>)
1784  : Ext.AbstractPlugin</div><div class="description"><div class="short"><p>Retrieves a plugin by its pluginId which has been bound to this
1785 component.</p>
1786 </div><div class="long"><p>Retrieves a plugin by its pluginId which has been bound to this
1787 component.</p>
1788 <h3 class="pa">Parameters</h3><ul><li><span class="pre">pluginId</span> : Object<div class="sub-desc">
1789 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.AbstractPlugin</span>&nbsp; &nbsp;<p>pluginInstance</p>
1790 </li></ul></div></div></div><div id="method-getPosition" class="member inherited"><a href="Ext.form.field.Text.html#method-getPosition" rel="method-getPosition" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-getPosition" class="viewSource">view source</a></div><a name="getPosition"></a><a name="method-getPosition"></a><a href="Ext.form.field.Text.html#" rel="method-getPosition" class="cls expand">getPosition</a>(
1791 <span class="pre">[Boolean local]</span>)
1792  : Array</div><div class="description"><div class="short"><p>Gets the current XY position of the component's underlying element.</p>
1793 </div><div class="long"><p>Gets the current XY position of the component's underlying element.</p>
1794 <h3 class="pa">Parameters</h3><ul><li><span class="pre">local</span> : Boolean<div class="sub-desc"><p>(optional) If true the element's left and top are returned instead of page XY (defaults to false)</p>
1795 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Array</span>&nbsp; &nbsp;<p>The XY position of the element (e.g., [100, 200])</p>
1796 </li></ul></div></div></div><div id="method-getRawValue" class="member ni"><a href="Ext.form.field.Text.html#method-getRawValue" rel="method-getRawValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-method-getRawValue" class="viewSource">view source</a></div><a name="getRawValue"></a><a name="method-getRawValue"></a><a href="Ext.form.field.Text.html#" rel="method-getRawValue" class="cls expand">getRawValue</a> : String</div><div class="description"><div class="short">Returns the raw String value of the field, without performing any normalization, conversion, or validation.
1797 Gets the ...</div><div class="long"><p>Returns the raw String value of the field, without performing any normalization, conversion, or validation.
1798 Gets the current value of the input element if the field has been rendered, ignoring the value if it is the
1799 <a href="Ext.form.field.Text.html#emptyText" rel="Ext.form.field.Text#emptyText" class="docClass">emptyText</a>. To get a normalized and converted value see <a href="Ext.form.field.Text.html#getValue" rel="Ext.form.field.Text#getValue" class="docClass">getValue</a>.</p>
1800 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>value The raw String value of the field</p>
1801 </li></ul></div></div></div><div id="method-getSize" class="member inherited"><a href="Ext.form.field.Text.html#method-getSize" rel="method-getSize" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getSize" class="viewSource">view source</a></div><a name="getSize"></a><a name="method-getSize"></a><a href="Ext.form.field.Text.html#" rel="method-getSize" class="cls expand">getSize</a> : Object</div><div class="description"><div class="short"><p>Gets the current size of the component's underlying element.</p>
1802 </div><div class="long"><p>Gets the current size of the component's underlying element.</p>
1803 <h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>An object containing the element's size {width: (element width), height: (element height)}</p>
1804 </li></ul></div></div></div><div id="method-getState" class="member inherited"><a href="Ext.form.field.Text.html#method-getState" rel="method-getState" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-method-getState" class="viewSource">view source</a></div><a name="getState"></a><a name="method-getState"></a><a href="Ext.form.field.Text.html#" rel="method-getState" class="cls expand">getState</a> : Object</div><div class="description"><div class="short">Gets the current state of the object. By default this function returns null,
1805 it should be overridden in subclasses to...</div><div class="long"><p>Gets the current state of the object. By default this function returns null,
1806 it should be overridden in subclasses to implement methods for getting the state.</p>
1807 <h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>The current state</p>
1808 </li></ul></div></div></div><div id="method-getStateId" class="member inherited"><a href="Ext.form.field.Text.html#method-getStateId" rel="method-getStateId" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-method-getStateId" class="viewSource">view source</a></div><a name="getStateId"></a><a name="method-getStateId"></a><a href="Ext.form.field.Text.html#" rel="method-getStateId" class="cls expand">getStateId</a> : String</div><div class="description"><div class="short"><p>Gets the state id for this object.</p>
1809 </div><div class="long"><p>Gets the state id for this object.</p>
1810 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The state id, null if not found.</p>
1811 </li></ul></div></div></div><div id="method-getSubmitData" class="member inherited"><a href="Ext.form.field.Text.html#method-getSubmitData" rel="method-getSubmitData" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-getSubmitData" class="viewSource">view source</a></div><a name="getSubmitData"></a><a name="method-getSubmitData"></a><a href="Ext.form.field.Text.html#" rel="method-getSubmitData" class="cls expand">getSubmitData</a> : Object</div><div class="description"><div class="short">Returns the parameter(s) that would be included in a standard form submit for this field. Typically this
1812 will be an o...</div><div class="long"><p>Returns the parameter(s) that would be included in a standard form submit for this field. Typically this
1813 will be an object with a single name-value pair, the name being this field's <a href="Ext.form.field.Text.html#getName" rel="Ext.form.field.Text#getName" class="docClass">name</a> and the
1814 value being its current stringified value. More advanced field implementations may return more than one
1815 name-value pair.</p>
1816
1817
1818 <p>Note that the values returned from this method are not guaranteed to have been successfully
1819 <a href="Ext.form.field.Text.html#validate" rel="Ext.form.field.Text#validate" class="docClass">validated</a>.</p>
1820
1821 <h3 class="pa">Returns</h3><ul><li><span class="pre">Object</span>&nbsp; &nbsp;<p>A mapping of submit parameter names to values; each value should be a string, or an array
1822 of strings if that particular name has multiple values. It can also return <tt>null</tt> if there are no
1823 parameters to be submitted.</p>
1824 </li></ul></div></div></div><div id="method-getSubmitValue" class="member inherited"><a href="Ext.form.field.Text.html#method-getSubmitValue" rel="method-getSubmitValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-getSubmitValue" class="viewSource">view source</a></div><a name="getSubmitValue"></a><a name="method-getSubmitValue"></a><a href="Ext.form.field.Text.html#" rel="method-getSubmitValue" class="cls expand">getSubmitValue</a> : String</div><div class="description"><div class="short">Returns the value that would be included in a standard form submit for this field. This will be combined
1825 with the fie...</div><div class="long"><p>Returns the value that would be included in a standard form submit for this field. This will be combined
1826 with the field's name to form a <tt>name=value</tt> pair in the <a href="Ext.form.field.Text.html#getSubmitData" rel="Ext.form.field.Text#getSubmitData" class="docClass">submitted parameters</a>.
1827 If an empty string is returned then just the <tt>name=</tt> will be submitted; if <tt>null</tt> is returned
1828 then nothing will be submitted.</p>
1829
1830
1831 <p>Note that the value returned will have been <a href="Ext.form.field.Text.html#processRawValue" rel="Ext.form.field.Text#processRawValue" class="docClass">processed</a> but may or may not have
1832 been successfully <a href="Ext.form.field.Text.html#validate" rel="Ext.form.field.Text#validate" class="docClass">validated</a>.</p>
1833
1834 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The value to be submitted, or <tt>null</tt>.</p>
1835 </li></ul></div></div></div><div id="method-getValue" class="member inherited"><a href="Ext.form.field.Text.html#method-getValue" rel="method-getValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-getValue" class="viewSource">view source</a></div><a name="getValue"></a><a name="method-getValue"></a><a href="Ext.form.field.Text.html#" rel="method-getValue" class="cls expand">getValue</a> : Mixed</div><div class="description"><div class="short">Returns the current data value of the field. The type of value returned is particular to the type of the
1836 particular f...</div><div class="long"><p>Returns the current data value of the field. The type of value returned is particular to the type of the
1837 particular field (e.g. a Date object for <a href="Ext.form.field.Date.html" rel="Ext.form.field.Date" class="docClass">Ext.form.field.Date</a>).</p>
1838 <h3 class="pa">Returns</h3><ul><li><span class="pre">Mixed</span>&nbsp; &nbsp;<p>value The field value</p>
1839 </li></ul></div></div></div><div id="method-getWidth" class="member inherited"><a href="Ext.form.field.Text.html#method-getWidth" rel="method-getWidth" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getWidth" class="viewSource">view source</a></div><a name="getWidth"></a><a name="method-getWidth"></a><a href="Ext.form.field.Text.html#" rel="method-getWidth" class="cls expand">getWidth</a> : Number</div><div class="description"><div class="short"><p>Gets the current width of the component's underlying element.</p>
1840 </div><div class="long"><p>Gets the current width of the component's underlying element.</p>
1841 <h3 class="pa">Returns</h3><ul><li><span class="pre">Number</span>&nbsp; &nbsp;
1842 </li></ul></div></div></div><div id="method-getXType" class="member inherited"><a href="Ext.form.field.Text.html#method-getXType" rel="method-getXType" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-getXType" class="viewSource">view source</a></div><a name="getXType"></a><a name="method-getXType"></a><a href="Ext.form.field.Text.html#" rel="method-getXType" class="cls expand">getXType</a> : String</div><div class="description"><div class="short">Gets the xtype for this component as registered with Ext.ComponentManager. For a list of all
1843 available xtypes, see th...</div><div class="long"><p>Gets the xtype for this component as registered with <a href="Ext.ComponentManager.html" rel="Ext.ComponentManager" class="docClass">Ext.ComponentManager</a>. For a list of all
1844 available xtypes, see the <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> header. Example usage:</p>
1845
1846 <pre><code>var t = new Ext.form.field.Text();
1847 alert(t.getXType());  // alerts 'textfield'
1848 </code></pre>
1849
1850 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The xtype</p>
1851 </li></ul></div></div></div><div id="method-getXTypes" class="member inherited"><a href="Ext.form.field.Text.html#method-getXTypes" rel="method-getXTypes" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-getXTypes" class="viewSource">view source</a></div><a name="getXTypes"></a><a name="method-getXTypes"></a><a href="Ext.form.field.Text.html#" rel="method-getXTypes" class="cls expand">getXTypes</a> : String</div><div class="description"><div class="short">Returns this Component's xtype hierarchy as a slash-delimited string. For a list of all
1852 available xtypes, see the Ext...</div><div class="long"><p>Returns this Component's xtype hierarchy as a slash-delimited string. For a list of all
1853 available xtypes, see the <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> header.</p>
1854
1855
1856 <p><b>If using your own subclasses, be aware that a Component must register its own xtype
1857 to participate in determination of inherited xtypes.</b></p>
1858
1859
1860 <p>Example usage:</p>
1861
1862
1863 <pre><code>var t = new Ext.form.field.Text();
1864 alert(t.getXTypes());  // alerts 'component/field/textfield'
1865 </code></pre>
1866
1867 <h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The xtype hierarchy string</p>
1868 </li></ul></div></div></div><div id="method-hasActiveError" class="member inherited"><a href="Ext.form.field.Text.html#method-hasActiveError" rel="method-hasActiveError" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-hasActiveError" class="viewSource">view source</a></div><a name="hasActiveError"></a><a name="method-hasActiveError"></a><a href="Ext.form.field.Text.html#" rel="method-hasActiveError" class="cls expand">hasActiveError</a> : Boolean</div><div class="description"><div class="short">Tells whether the field currently has an active error message. This does not trigger
1869 validation on its own, it merely...</div><div class="long"><p>Tells whether the field currently has an active error message. This does not trigger
1870 validation on its own, it merely looks for any message that the component may already hold.</p>
1871 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;
1872 </li></ul></div></div></div><div id="method-hasListener" class="member inherited"><a href="Ext.form.field.Text.html#method-hasListener" rel="method-hasListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-hasListener" class="viewSource">view source</a></div><a name="hasListener"></a><a name="method-hasListener"></a><a href="Ext.form.field.Text.html#" rel="method-hasListener" class="cls expand">hasListener</a>(
1873 <span class="pre">String eventName</span>)
1874  : Boolean</div><div class="description"><div class="short"><p>Checks to see if this object has any listeners for a specified event</p>
1875 </div><div class="long"><p>Checks to see if this object has any listeners for a specified event</p>
1876 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The name of the event to check for</p>
1877 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if the event is being listened for, else false</p>
1878 </li></ul></div></div></div><div id="method-hasUICls" class="member inherited"><a href="Ext.form.field.Text.html#method-hasUICls" rel="method-hasUICls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-hasUICls" class="viewSource">view source</a></div><a name="hasUICls"></a><a name="method-hasUICls"></a><a href="Ext.form.field.Text.html#" rel="method-hasUICls" class="cls expand">hasUICls</a>(
1879 <span class="pre">String cls</span>)
1880  : void</div><div class="description"><div class="short"><p>Checks if there is currently a specified uiCls</p>
1881 </div><div class="long"><p>Checks if there is currently a specified uiCls</p>
1882 <h3 class="pa">Parameters</h3><ul><li><span class="pre">cls</span> : String<div class="sub-desc"><p>The cls to check</p>
1883 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1884 </li></ul></div></div></div><div id="method-hide" class="member inherited"><a href="Ext.form.field.Text.html#method-hide" rel="method-hide" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-hide" class="viewSource">view source</a></div><a name="hide"></a><a name="method-hide"></a><a href="Ext.form.field.Text.html#" rel="method-hide" class="cls expand">hide</a>(
1885 <span class="pre">String/Element/Component animateTarget, [Function callback], [Object scope]</span>)
1886  : Ext.Component</div><div class="description"><div class="short"><p>Hides this Component, setting it to invisible using the configured <a href="Ext.form.field.Text.html#hideMode" rel="Ext.form.field.Text#hideMode" class="docClass">hideMode</a>.</p>
1887 </div><div class="long"><p>Hides this Component, setting it to invisible using the configured <a href="Ext.form.field.Text.html#hideMode" rel="Ext.form.field.Text#hideMode" class="docClass">hideMode</a>.</p>
1888 <h3 class="pa">Parameters</h3><ul><li><span class="pre">animateTarget</span> : String/Element/Component<div class="sub-desc"><p>Optional, and <b>only valid for <a href="Ext.form.field.Text.html#floating" rel="Ext.form.field.Text#floating" class="docClass">floating</a> Components such as
1889 <a href="Ext.window.Window.html" rel="Ext.window.Window" class="docClass">Window</a>s or <a href="Ext.tip.ToolTip.html" rel="Ext.tip.ToolTip" class="docClass">ToolTip</a>s, or regular Components which have been configured
1890 with <code>floating: true</code>.</b>.
1891 The target to which the Component should animate while hiding (defaults to null with no animation)</p>
1892 </div></li><li><span class="pre">callback</span> : Function<div class="sub-desc"><p>(optional) A callback function to call after the Component is hidden.</p>
1893 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope (<code>this</code> reference) in which the callback is executed. Defaults to this Component.</p>
1894 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
1895 </li></ul></div></div></div><div id="method-initField" class="member inherited"><a href="Ext.form.field.Text.html#method-initField" rel="method-initField" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-initField" class="viewSource">view source</a></div><a name="initField"></a><a name="method-initField"></a><a href="Ext.form.field.Text.html#" rel="method-initField" class="cls expand">initField</a> : void</div><div class="description"><div class="short">Initializes this Field mixin on the current instance. Components using this mixin should call
1896 this method during thei...</div><div class="long"><p>Initializes this Field mixin on the current instance. Components using this mixin should call
1897 this method during their own initialization process.</p>
1898 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1899 </li></ul></div></div></div><div id="method-initLabelable" class="member inherited"><a href="Ext.form.field.Text.html#method-initLabelable" rel="method-initLabelable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-initLabelable" class="viewSource">view source</a></div><a name="initLabelable"></a><a name="method-initLabelable"></a><a href="Ext.form.field.Text.html#" rel="method-initLabelable" class="cls expand">initLabelable</a> : void</div><div class="description"><div class="short">Performs initialization of this mixin. Component classes using this mixin should call this method
1900 during their own in...</div><div class="long"><p>Performs initialization of this mixin. Component classes using this mixin should call this method
1901 during their own initialization.</p>
1902 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
1903 </li></ul></div></div></div><div id="method-is" class="member inherited"><a href="Ext.form.field.Text.html#method-is" rel="method-is" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-is" class="viewSource">view source</a></div><a name="is"></a><a name="method-is"></a><a href="Ext.form.field.Text.html#" rel="method-is" class="cls expand">is</a>(
1904 <span class="pre">String selector</span>)
1905  : Boolean</div><div class="description"><div class="short"><p>Tests whether this Component matches the selector string.</p>
1906 </div><div class="long"><p>Tests whether this Component matches the selector string.</p>
1907 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selector</span> : String<div class="sub-desc"><p>The selector string to test against.</p>
1908 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if this Component matches the selector.</p>
1909 </li></ul></div></div></div><div id="method-isDescendantOf" class="member inherited"><a href="Ext.form.field.Text.html#method-isDescendantOf" rel="method-isDescendantOf" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isDescendantOf" class="viewSource">view source</a></div><a name="isDescendantOf"></a><a name="method-isDescendantOf"></a><a href="Ext.form.field.Text.html#" rel="method-isDescendantOf" class="cls expand">isDescendantOf</a>(
1910 <span class="pre">Ext.Container container</span>)
1911  : Boolean</div><div class="description"><div class="short"><p>Determines whether this component is the descendant of a particular container.</p>
1912 </div><div class="long"><p>Determines whether this component is the descendant of a particular container.</p>
1913 <h3 class="pa">Parameters</h3><ul><li><span class="pre">container</span> : Ext.Container<div class="sub-desc">
1914 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>isDescendant</p>
1915 </li></ul></div></div></div><div id="method-isDirty" class="member inherited"><a href="Ext.form.field.Text.html#method-isDirty" rel="method-isDirty" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-isDirty" class="viewSource">view source</a></div><a name="isDirty"></a><a name="method-isDirty"></a><a href="Ext.form.field.Text.html#" rel="method-isDirty" class="cls expand">isDirty</a> : Boolean</div><div class="description"><div class="short">Returns true if the value of this Field has been changed from its originalValue.
1916 Will always return false if the fiel...</div><div class="long"><p>Returns true if the value of this Field has been changed from its <a href="Ext.form.field.Text.html#originalValue" rel="Ext.form.field.Text#originalValue" class="docClass">originalValue</a>.
1917 Will always return false if the field is disabled.</p>
1918
1919
1920 <p>Note that if the owning <a href="Ext.form.Basic.html" rel="Ext.form.Basic" class="docClass">form</a> was configured with
1921 <a href="Ext.form.Basic.html#trackResetOnLoad" rel="Ext.form.Basic#trackResetOnLoad" class="docClass">trackResetOnLoad</a>
1922 then the <a href="Ext.form.field.Text.html#originalValue" rel="Ext.form.field.Text#originalValue" class="docClass">originalValue</a> is updated when the values are loaded by
1923 <a href="Ext.form.Basic.html" rel="Ext.form.Basic" class="docClass">Ext.form.Basic</a>.<a href="Ext.form.Basic.html#setValues" rel="Ext.form.Basic#setValues" class="docClass">setValues</a>.</p>
1924
1925 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if this field has been changed from its original value (and
1926 is not disabled), false otherwise.</p>
1927 </li></ul></div></div></div><div id="method-isDisabled" class="member inherited"><a href="Ext.form.field.Text.html#method-isDisabled" rel="method-isDisabled" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isDisabled" class="viewSource">view source</a></div><a name="isDisabled"></a><a name="method-isDisabled"></a><a href="Ext.form.field.Text.html#" rel="method-isDisabled" class="cls expand">isDisabled</a> : Boolean</div><div class="description"><div class="short"><p>Method to determine whether this Component is currently disabled.</p>
1928 </div><div class="long"><p>Method to determine whether this Component is currently disabled.</p>
1929 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>the disabled state of this Component.</p>
1930 </li></ul></div></div></div><div id="method-isDraggable" class="member inherited"><a href="Ext.form.field.Text.html#method-isDraggable" rel="method-isDraggable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isDraggable" class="viewSource">view source</a></div><a name="isDraggable"></a><a name="method-isDraggable"></a><a href="Ext.form.field.Text.html#" rel="method-isDraggable" class="cls expand">isDraggable</a> : Boolean</div><div class="description"><div class="short"><p>Method to determine whether this Component is draggable.</p>
1931 </div><div class="long"><p>Method to determine whether this Component is draggable.</p>
1932 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>the draggable state of this component.</p>
1933 </li></ul></div></div></div><div id="method-isDroppable" class="member inherited"><a href="Ext.form.field.Text.html#method-isDroppable" rel="method-isDroppable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isDroppable" class="viewSource">view source</a></div><a name="isDroppable"></a><a name="method-isDroppable"></a><a href="Ext.form.field.Text.html#" rel="method-isDroppable" class="cls expand">isDroppable</a> : Boolean</div><div class="description"><div class="short"><p>Method to determine whether this Component is droppable.</p>
1934 </div><div class="long"><p>Method to determine whether this Component is droppable.</p>
1935 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>the droppable state of this component.</p>
1936 </li></ul></div></div></div><div id="method-isEqual" class="member inherited"><a href="Ext.form.field.Text.html#method-isEqual" rel="method-isEqual" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-isEqual" class="viewSource">view source</a></div><a name="isEqual"></a><a name="method-isEqual"></a><a href="Ext.form.field.Text.html#" rel="method-isEqual" class="cls expand">isEqual</a>(
1937 <span class="pre">Mixed value1, Mixed value2</span>)
1938  : Boolean</div><div class="description"><div class="short">Returns whether two field values are logically equal. Field implementations may override
1939 this to provide custom compa...</div><div class="long"><p>Returns whether two field <a href="Ext.form.field.Text.html#getValue" rel="Ext.form.field.Text#getValue" class="docClass">values</a> are logically equal. Field implementations may override
1940 this to provide custom comparison logic appropriate for the particular field's data type.</p>
1941 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value1</span> : Mixed<div class="sub-desc"><p>The first value to compare</p>
1942 </div></li><li><span class="pre">value2</span> : Mixed<div class="sub-desc"><p>The second value to compare</p>
1943 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if the values are equal, false if inequal.</p>
1944 </li></ul></div></div></div><div id="method-isFileUpload" class="member inherited"><a href="Ext.form.field.Text.html#method-isFileUpload" rel="method-isFileUpload" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-isFileUpload" class="viewSource">view source</a></div><a name="isFileUpload"></a><a name="method-isFileUpload"></a><a href="Ext.form.field.Text.html#" rel="method-isFileUpload" class="cls expand">isFileUpload</a> : Boolean</div><div class="description"><div class="short">Returns whether this Field is a file upload field; if it returns true, forms will use
1945 special techniques for submitti...</div><div class="long"><p>Returns whether this Field is a file upload field; if it returns true, forms will use
1946 special techniques for <a href="Ext.form.Basic.html#submit" rel="Ext.form.Basic#submit" class="docClass">submitting the form</a> via AJAX. See
1947 <a href="Ext.form.Basic.html#hasUpload" rel="Ext.form.Basic#hasUpload" class="docClass">Ext.form.Basic.hasUpload</a> for details. If this returns true, the <a href="Ext.form.field.Text.html#extractFileInput" rel="Ext.form.field.Text#extractFileInput" class="docClass">extractFileInput</a>
1948 method must also be implemented to return the corresponding file input element.</p>
1949 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;
1950 </li></ul></div></div></div><div id="method-isFloating" class="member inherited"><a href="Ext.form.field.Text.html#method-isFloating" rel="method-isFloating" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isFloating" class="viewSource">view source</a></div><a name="isFloating"></a><a name="method-isFloating"></a><a href="Ext.form.field.Text.html#" rel="method-isFloating" class="cls expand">isFloating</a> : Boolean</div><div class="description"><div class="short"><p>Method to determine whether this Component is floating.</p>
1951 </div><div class="long"><p>Method to determine whether this Component is floating.</p>
1952 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>the floating state of this component.</p>
1953 </li></ul></div></div></div><div id="method-isHidden" class="member inherited"><a href="Ext.form.field.Text.html#method-isHidden" rel="method-isHidden" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isHidden" class="viewSource">view source</a></div><a name="isHidden"></a><a name="method-isHidden"></a><a href="Ext.form.field.Text.html#" rel="method-isHidden" class="cls expand">isHidden</a> : Boolean</div><div class="description"><div class="short"><p>Method to determine whether this Component is currently set to hidden.</p>
1954 </div><div class="long"><p>Method to determine whether this Component is currently set to hidden.</p>
1955 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>the hidden state of this Component.</p>
1956 </li></ul></div></div></div><div id="method-isValid" class="member inherited"><a href="Ext.form.field.Text.html#method-isValid" rel="method-isValid" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-isValid" class="viewSource">view source</a></div><a name="isValid"></a><a name="method-isValid"></a><a href="Ext.form.field.Text.html#" rel="method-isValid" class="cls expand">isValid</a> : Boolean</div><div class="description"><div class="short">Returns whether or not the field value is currently valid by validating the
1957 field's current value. The validitychange...</div><div class="long"><p>Returns whether or not the field value is currently valid by <a href="Ext.form.field.Text.html#getErrors" rel="Ext.form.field.Text#getErrors" class="docClass">validating</a> the
1958 field's current value. The <a href="Ext.form.field.Text.html#validitychange" rel="Ext.form.field.Text#validitychange" class="docClass">validitychange</a> event will not be fired; use <a href="Ext.form.field.Text.html#validate" rel="Ext.form.field.Text#validate" class="docClass">validate</a>
1959 instead if you want the event to fire. <b>Note</b>: <a href="Ext.form.field.Text.html#disabled" rel="Ext.form.field.Text#disabled" class="docClass">disabled</a> fields are always treated as valid.</p>
1960
1961
1962 <p>Implementations are encouraged to ensure that this method does not have side-effects such as
1963 triggering error message display.</p>
1964
1965 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if the value is valid, else false</p>
1966 </li></ul></div></div></div><div id="method-isVisible" class="member inherited"><a href="Ext.form.field.Text.html#method-isVisible" rel="method-isVisible" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isVisible" class="viewSource">view source</a></div><a name="isVisible"></a><a name="method-isVisible"></a><a href="Ext.form.field.Text.html#" rel="method-isVisible" class="cls expand">isVisible</a>(
1967 <span class="pre">Boolean deep</span>)
1968  : Boolean</div><div class="description"><div class="short"><p>Returns true if this component is visible.</p>
1969 </div><div class="long"><p>Returns true if this component is visible.</p>
1970 <h3 class="pa">Parameters</h3><ul><li><span class="pre">deep</span> : Boolean<div class="sub-desc"><p>. <p>Optional. Pass <code>true</code> to interrogate the visibility status of all
1971 parent Containers to determine whether this Component is truly visible to the user.</p></p>
1972
1973 <p>Generally, to determine whether a Component is hidden, the no argument form is needed. For example
1974 when creating dynamically laid out UIs in a hidden Container before showing them.</p>
1975
1976 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if this component is visible, false otherwise.</p>
1977 </li></ul></div></div></div><div id="method-isXType" class="member inherited"><a href="Ext.form.field.Text.html#method-isXType" rel="method-isXType" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-isXType" class="viewSource">view source</a></div><a name="isXType"></a><a name="method-isXType"></a><a href="Ext.form.field.Text.html#" rel="method-isXType" class="cls expand">isXType</a>(
1978 <span class="pre">String xtype, [Boolean shallow]</span>)
1979  : Boolean</div><div class="description"><div class="short">Tests whether or not this Component is of a specific xtype. This can test whether this Component is descended
1980 from th...</div><div class="long"><p>Tests whether or not this Component is of a specific xtype. This can test whether this Component is descended
1981 from the xtype (default) or whether it is directly of the xtype specified (shallow = true).</p>
1982
1983
1984 <p><b>If using your own subclasses, be aware that a Component must register its own xtype
1985 to participate in determination of inherited xtypes.</b></p>
1986
1987
1988 <p>For a list of all available xtypes, see the <a href="Ext.Component.html" rel="Ext.Component" class="docClass">Ext.Component</a> header.</p>
1989
1990
1991 <p>Example usage:</p>
1992
1993
1994 <pre><code>var t = new Ext.form.field.Text();
1995 var isText = t.isXType('textfield');        // true
1996 var isBoxSubclass = t.isXType('field');       // true, descended from <a href="Ext.form.field.Base.html" rel="Ext.form.field.Base" class="docClass">Ext.form.field.Base</a>
1997 var isBoxInstance = t.isXType('field', true); // false, not a direct <a href="Ext.form.field.Base.html" rel="Ext.form.field.Base" class="docClass">Ext.form.field.Base</a> instance
1998 </code></pre>
1999
2000 <h3 class="pa">Parameters</h3><ul><li><span class="pre">xtype</span> : String<div class="sub-desc"><p>The xtype to check for this Component</p>
2001 </div></li><li><span class="pre">shallow</span> : Boolean<div class="sub-desc"><p>(optional) False to check whether this Component is descended from the xtype (this is
2002 the default), or true to check whether this Component is directly of the specified xtype.</p>
2003 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if this component descends from the specified xtype, false otherwise.</p>
2004 </li></ul></div></div></div><div id="method-markInvalid" class="member inherited"><a href="Ext.form.field.Text.html#method-markInvalid" rel="method-markInvalid" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-markInvalid" class="viewSource">view source</a></div><a name="markInvalid"></a><a name="method-markInvalid"></a><a href="Ext.form.field.Text.html#" rel="method-markInvalid" class="cls expand">markInvalid</a>(
2005 <span class="pre">String/Array errors</span>)
2006  : void</div><div class="description"><div class="short">Display one or more error messages associated with this field, using msgTarget to determine how to
2007 display the messag...</div><div class="long"><p>Display one or more error messages associated with this field, using <a href="Ext.form.field.Text.html#msgTarget" rel="Ext.form.field.Text#msgTarget" class="docClass">msgTarget</a> to determine how to
2008 display the messages and applying <a href="Ext.form.field.Text.html#invalidCls" rel="Ext.form.field.Text#invalidCls" class="docClass">invalidCls</a> to the field's UI element.</p>
2009
2010
2011 <p><b>Note</b>: this method does not cause the Field's <a href="Ext.form.field.Text.html#validate" rel="Ext.form.field.Text#validate" class="docClass">validate</a> or <a href="Ext.form.field.Text.html#isValid" rel="Ext.form.field.Text#isValid" class="docClass">isValid</a> methods to
2012 return <code>false</code> if the value does <i>pass</i> validation. So simply marking a Field as invalid
2013 will not prevent submission of forms submitted with the <a href="Ext.form.action.Submit.html#clientValidation" rel="Ext.form.action.Submit#clientValidation" class="docClass">Ext.form.action.Submit.clientValidation</a>
2014 option set.</p>
2015
2016 <h3 class="pa">Parameters</h3><ul><li><span class="pre">errors</span> : String/Array<div class="sub-desc"><p>The validation message(s) to display.</p>
2017 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2018 </li></ul></div></div></div><div id="method-nextNode" class="member inherited"><a href="Ext.form.field.Text.html#method-nextNode" rel="method-nextNode" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-nextNode" class="viewSource">view source</a></div><a name="nextNode"></a><a name="method-nextNode"></a><a href="Ext.form.field.Text.html#" rel="method-nextNode" class="cls expand">nextNode</a>(
2019 <span class="pre">String selector, Object includeSelf</span>)
2020  : void</div><div class="description"><div class="short">Returns the next node in the Component tree in tree traversal order.
2021
2022
2023 Note that this is not limited to siblings, and...</div><div class="long"><p>Returns the next node in the Component tree in tree traversal order.</p>
2024
2025
2026 <p>Note that this is not limited to siblings, and if invoked upon a node with no matching siblings, will
2027 walk the tree to attempt to find a match. Contrast with <a href="Ext.form.field.Text.html#pnextSibling" rel="Ext.form.field.Text#pnextSibling" class="docClass">pnextSibling</a>.</p>
2028
2029 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selector</span> : String<div class="sub-desc"><p>Optional A <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> selector to filter the following nodes.</p>
2030 </div></li><li><span class="pre">includeSelf</span> : Object<div class="sub-desc">
2031 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;<p>The next node (or the next node which matches the selector). Returns null if there is no matching node.</p>
2032 </li></ul></div></div></div><div id="method-nextSibling" class="member inherited"><a href="Ext.form.field.Text.html#method-nextSibling" rel="method-nextSibling" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-nextSibling" class="viewSource">view source</a></div><a name="nextSibling"></a><a name="method-nextSibling"></a><a href="Ext.form.field.Text.html#" rel="method-nextSibling" class="cls expand">nextSibling</a>(
2033 <span class="pre">String selector</span>)
2034  : void</div><div class="description"><div class="short">Returns the next sibling of this Component.
2035
2036
2037 Optionally selects the next sibling which matches the passed ComponentQ...</div><div class="long"><p>Returns the next sibling of this Component.</p>
2038
2039
2040 <p>Optionally selects the next sibling which matches the passed <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> selector.</p>
2041
2042
2043 <p>May also be refered to as <code><b>next()</b></code></p>
2044
2045
2046 <p>Note that this is limited to siblings, and if no siblings of the item match, <code>null</code> is returned. Contrast with <a href="Ext.form.field.Text.html#nextNode" rel="Ext.form.field.Text#nextNode" class="docClass">nextNode</a></p>
2047
2048 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selector</span> : String<div class="sub-desc"><p>Optional A <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> selector to filter the following items.</p>
2049 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;<p>The next sibling (or the next sibling which matches the selector). Returns null if there is no matching sibling.</p>
2050 </li></ul></div></div></div><div id="method-observe" class="member inherited"><a href="Ext.form.field.Text.html#method-observe" rel="method-observe" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-observe" class="viewSource">view source</a></div><a name="observe"></a><a name="method-observe"></a><a href="Ext.form.field.Text.html#" rel="method-observe" class="cls expand">observe</a>(
2051 <span class="pre">Function c, Object listeners</span>)
2052  : void</div><div class="description"><div class="short">Sets observability on the passed class constructor.
2053
2054 This makes any event fired on any instance of the passed class a...</div><div class="long"><p>Sets observability on the passed class constructor.</p>
2055
2056 <p>This makes any event fired on any instance of the passed class also fire a single event through
2057 the <strong>class</strong> allowing for central handling of events on many instances at once.</p>
2058
2059 <p>Usage:</p>
2060
2061 <pre><code>Ext.util.Observable.observe(Ext.data.Connection);
2062 Ext.data.Connection.on('beforerequest', function(con, options) {
2063     console.log('Ajax request made to ' + options.url);
2064 });
2065 </code></pre>
2066 <h3 class="pa">Parameters</h3><ul><li><span class="pre">c</span> : Function<div class="sub-desc"><p>The class constructor to make observable.</p>
2067 </div></li><li><span class="pre">listeners</span> : Object<div class="sub-desc"><p>An object containing a series of listeners to add. See <a href="Ext.form.field.Text.html#addListener" rel="Ext.form.field.Text#addListener" class="docClass">addListener</a>.</p>
2068 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2069 </li></ul></div></div></div><div id="method-on" class="member inherited"><a href="Ext.form.field.Text.html#method-on" rel="method-on" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-on" class="viewSource">view source</a></div><a name="on"></a><a name="method-on"></a><a href="Ext.form.field.Text.html#" rel="method-on" class="cls expand">on</a>(
2070 <span class="pre">String eventName, Function handler, [Object scope], [Object options]</span>)
2071  : void</div><div class="description"><div class="short"><p>Appends an event handler to this object (shorthand for <a href="Ext.form.field.Text.html#addListener" rel="Ext.form.field.Text#addListener" class="docClass">addListener</a>.)</p>
2072 </div><div class="long"><p>Appends an event handler to this object (shorthand for <a href="Ext.form.field.Text.html#addListener" rel="Ext.form.field.Text#addListener" class="docClass">addListener</a>.)</p>
2073 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The type of event to listen for</p>
2074 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The method the event invokes</p>
2075 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope (<code><b>this</b></code> reference) in which the handler function is executed.
2076 <b>If omitted, defaults to the object which fired the event.</b></p>
2077 </div></li><li><span class="pre">options</span> : Object<div class="sub-desc"><p>(optional) An object containing handler configuration.</p>
2078 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2079 </li></ul></div></div></div><div id="method-previousNode" class="member inherited"><a href="Ext.form.field.Text.html#method-previousNode" rel="method-previousNode" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-previousNode" class="viewSource">view source</a></div><a name="previousNode"></a><a name="method-previousNode"></a><a href="Ext.form.field.Text.html#" rel="method-previousNode" class="cls expand">previousNode</a>(
2080 <span class="pre">String selector, Object includeSelf</span>)
2081  : void</div><div class="description"><div class="short">Returns the previous node in the Component tree in tree traversal order.
2082
2083
2084 Note that this is not limited to siblings,...</div><div class="long"><p>Returns the previous node in the Component tree in tree traversal order.</p>
2085
2086
2087 <p>Note that this is not limited to siblings, and if invoked upon a node with no matching siblings, will
2088 walk the tree in reverse order to attempt to find a match. Contrast with <a href="Ext.form.field.Text.html#previousSibling" rel="Ext.form.field.Text#previousSibling" class="docClass">previousSibling</a>.</p>
2089
2090 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selector</span> : String<div class="sub-desc"><p>Optional. A <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> selector to filter the preceding nodes.</p>
2091 </div></li><li><span class="pre">includeSelf</span> : Object<div class="sub-desc">
2092 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;<p>The previous node (or the previous node which matches the selector). Returns null if there is no matching node.</p>
2093 </li></ul></div></div></div><div id="method-previousSibling" class="member inherited"><a href="Ext.form.field.Text.html#method-previousSibling" rel="method-previousSibling" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-previousSibling" class="viewSource">view source</a></div><a name="previousSibling"></a><a name="method-previousSibling"></a><a href="Ext.form.field.Text.html#" rel="method-previousSibling" class="cls expand">previousSibling</a>(
2094 <span class="pre">String selector</span>)
2095  : void</div><div class="description"><div class="short">Returns the previous sibling of this Component.
2096
2097
2098 Optionally selects the previous sibling which matches the passed Co...</div><div class="long"><p>Returns the previous sibling of this Component.</p>
2099
2100
2101 <p>Optionally selects the previous sibling which matches the passed <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> selector.</p>
2102
2103
2104 <p>May also be refered to as <code><b>prev()</b></code></p>
2105
2106
2107 <p>Note that this is limited to siblings, and if no siblings of the item match, <code>null</code> is returned. Contrast with <a href="Ext.form.field.Text.html#previousNode" rel="Ext.form.field.Text#previousNode" class="docClass">previousNode</a></p>
2108
2109 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selector</span> : String<div class="sub-desc"><p>Optional. A <a href="Ext.ComponentQuery.html" rel="Ext.ComponentQuery" class="docClass">ComponentQuery</a> selector to filter the preceding items.</p>
2110 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;<p>The previous sibling (or the previous sibling which matches the selector). Returns null if there is no matching sibling.</p>
2111 </li></ul></div></div></div><div id="method-processRawValue" class="member ni"><a href="Ext.form.field.Text.html#method-processRawValue" rel="method-processRawValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-method-processRawValue" class="viewSource">view source</a></div><a name="processRawValue"></a><a name="method-processRawValue"></a><a href="Ext.form.field.Text.html#" rel="method-processRawValue" class="cls expand">processRawValue</a>(
2112 <span class="pre">String value</span>)
2113  : String</div><div class="description"><div class="short">Performs any necessary manipulation of a raw String value to prepare it for conversion
2114 and/or validation. For text fi...</div><div class="long"><p>Performs any necessary manipulation of a raw String value to prepare it for <a href="Ext.form.field.Text.html#stringToValue" rel="Ext.form.field.Text#stringToValue" class="docClass">conversion</a>
2115 and/or <a href="Ext.form.field.Text.html#validate" rel="Ext.form.field.Text#validate" class="docClass">validation</a>. For text fields this applies the configured <a href="Ext.form.field.Text.html#stripCharsRe" rel="Ext.form.field.Text#stripCharsRe" class="docClass">stripCharsRe</a> to the
2116 raw value.</p>
2117 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value</span> : String<div class="sub-desc"><p>The unprocessed string value</p>
2118 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">String</span>&nbsp; &nbsp;<p>The processed string value</p>
2119 </li></ul></div></div></div><div id="method-rawToValue" class="member inherited"><a href="Ext.form.field.Text.html#method-rawToValue" rel="method-rawToValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-rawToValue" class="viewSource">view source</a></div><a name="rawToValue"></a><a name="method-rawToValue"></a><a href="Ext.form.field.Text.html#" rel="method-rawToValue" class="cls expand">rawToValue</a>(
2120 <span class="pre">Mixed rawValue</span>)
2121  : Mixed</div><div class="description"><div class="short">Converts a raw input field value into a mixed-type value that is suitable for this particular field type.
2122 This allows...</div><div class="long"><p>Converts a raw input field value into a mixed-type value that is suitable for this particular field type.
2123 This allows controlling the normalization and conversion of user-entered values into field-type-appropriate
2124 values, e.g. a Date object for <a href="Ext.form.field.Date.html" rel="Ext.form.field.Date" class="docClass">Ext.form.field.Date</a>, and is invoked by <a href="Ext.form.field.Text.html#getValue" rel="Ext.form.field.Text#getValue" class="docClass">getValue</a>.</p>
2125
2126
2127 <p>It is up to individual implementations to decide how to handle raw values that cannot be successfully
2128 converted to the desired object type.</p>
2129
2130
2131 <p>See <a href="Ext.form.field.Text.html#valueToRaw" rel="Ext.form.field.Text#valueToRaw" class="docClass">valueToRaw</a> for the opposite conversion.</p>
2132
2133
2134 <p>The base implementation does no conversion, returning the raw value untouched.</p>
2135
2136 <h3 class="pa">Parameters</h3><ul><li><span class="pre">rawValue</span> : Mixed<div class="sub-desc">
2137 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Mixed</span>&nbsp; &nbsp;<p>The converted value.</p>
2138 </li></ul></div></div></div><div id="method-relayEvents" class="member inherited"><a href="Ext.form.field.Text.html#method-relayEvents" rel="method-relayEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-relayEvents" class="viewSource">view source</a></div><a name="relayEvents"></a><a name="method-relayEvents"></a><a href="Ext.form.field.Text.html#" rel="method-relayEvents" class="cls expand">relayEvents</a>(
2139 <span class="pre">Object origin, Array events, Object prefix</span>)
2140  : void</div><div class="description"><div class="short"><p>Relays selected events from the specified Observable as if the events were fired by <code><b>this</b></code>.</p>
2141 </div><div class="long"><p>Relays selected events from the specified Observable as if the events were fired by <code><b>this</b></code>.</p>
2142 <h3 class="pa">Parameters</h3><ul><li><span class="pre">origin</span> : Object<div class="sub-desc"><p>The Observable whose events this object is to relay.</p>
2143 </div></li><li><span class="pre">events</span> : Array<div class="sub-desc"><p>Array of event names to relay.</p>
2144 </div></li><li><span class="pre">prefix</span> : Object<div class="sub-desc">
2145 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2146 </li></ul></div></div></div><div id="method-releaseCapture" class="member inherited"><a href="Ext.form.field.Text.html#method-releaseCapture" rel="method-releaseCapture" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-releaseCapture" class="viewSource">view source</a></div><a name="releaseCapture"></a><a name="method-releaseCapture"></a><a href="Ext.form.field.Text.html#" rel="method-releaseCapture" class="cls expand">releaseCapture</a>(
2147 <span class="pre">Observable o</span>)
2148  : void</div><div class="description"><div class="short"><p>Removes <b>all</b> added captures from the Observable.</p>
2149 </div><div class="long"><p>Removes <b>all</b> added captures from the Observable.</p>
2150 <h3 class="pa">Parameters</h3><ul><li><span class="pre">o</span> : Observable<div class="sub-desc"><p>The Observable to release</p>
2151 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2152 </li></ul></div></div></div><div id="method-removeCls" class="member inherited"><a href="Ext.form.field.Text.html#method-removeCls" rel="method-removeCls" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-removeCls" class="viewSource">view source</a></div><a name="removeCls"></a><a name="method-removeCls"></a><a href="Ext.form.field.Text.html#" rel="method-removeCls" class="cls expand">removeCls</a>(
2153 <span class="pre">Object className</span>)
2154  : Ext.Component</div><div class="description"><div class="short"><p>Removes a CSS class from the top level element representing this component.</p>
2155 </div><div class="long"><p>Removes a CSS class from the top level element representing this component.</p>
2156 <h3 class="pa">Parameters</h3><ul><li><span class="pre">className</span> : Object<div class="sub-desc">
2157 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>Returns the Component to allow method chaining.</p>
2158 </li></ul></div></div></div><div id="method-removeClsWithUI" class="member inherited"><a href="Ext.form.field.Text.html#method-removeClsWithUI" rel="method-removeClsWithUI" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-removeClsWithUI" class="viewSource">view source</a></div><a name="removeClsWithUI"></a><a name="method-removeClsWithUI"></a><a href="Ext.form.field.Text.html#" rel="method-removeClsWithUI" class="cls expand">removeClsWithUI</a>(
2159 <span class="pre">String/Array cls</span>)
2160  : void</div><div class="description"><div class="short">Removes a cls to the uiCls array, which will also call removeUIClsToElement and removes
2161 it from all elements of this ...</div><div class="long"><p>Removes a cls to the uiCls array, which will also call <a href="Ext.form.field.Text.html#removeUIClsToElement" rel="Ext.form.field.Text#removeUIClsToElement" class="docClass">removeUIClsToElement</a> and removes
2162 it from all elements of this component.</p>
2163 <h3 class="pa">Parameters</h3><ul><li><span class="pre">cls</span> : String/Array<div class="sub-desc"><p>A string or an array of strings to remove to the uiCls</p>
2164 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2165 </li></ul></div></div></div><div id="method-removeListener" class="member inherited"><a href="Ext.form.field.Text.html#method-removeListener" rel="method-removeListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-removeListener" class="viewSource">view source</a></div><a name="removeListener"></a><a name="method-removeListener"></a><a href="Ext.form.field.Text.html#" rel="method-removeListener" class="cls expand">removeListener</a>(
2166 <span class="pre">String eventName, Function handler, [Object scope]</span>)
2167  : void</div><div class="description"><div class="short"><p>Removes an event handler.</p>
2168 </div><div class="long"><p>Removes an event handler.</p>
2169 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The type of event the handler was associated with.</p>
2170 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The handler to remove. <b>This must be a reference to the function passed into the <a href="Ext.form.field.Text.html#addListener" rel="Ext.form.field.Text#addListener" class="docClass">addListener</a> call.</b></p>
2171 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope originally specified for the handler.</p>
2172 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2173 </li></ul></div></div></div><div id="method-removeManagedListener" class="member inherited"><a href="Ext.form.field.Text.html#method-removeManagedListener" rel="method-removeManagedListener" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-removeManagedListener" class="viewSource">view source</a></div><a name="removeManagedListener"></a><a name="method-removeManagedListener"></a><a href="Ext.form.field.Text.html#" rel="method-removeManagedListener" class="cls expand">removeManagedListener</a>(
2174 <span class="pre">Observable|Element item, Object|String ename, Function fn, Object scope</span>)
2175  : void</div><div class="description"><div class="short"><p>Removes listeners that were added by the <a href="Ext.form.field.Text.html#mon" rel="Ext.form.field.Text#mon" class="docClass">mon</a> method.</p>
2176 </div><div class="long"><p>Removes listeners that were added by the <a href="Ext.form.field.Text.html#mon" rel="Ext.form.field.Text#mon" class="docClass">mon</a> method.</p>
2177 <h3 class="pa">Parameters</h3><ul><li><span class="pre">item</span> : Observable|Element<div class="sub-desc"><p>The item from which to remove a listener/listeners.</p>
2178 </div></li><li><span class="pre">ename</span> : Object|String<div class="sub-desc"><p>The event name, or an object containing event name properties.</p>
2179 </div></li><li><span class="pre">fn</span> : Function<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
2180 is the handler function.</p>
2181 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>Optional. If the <code>ename</code> parameter was an event name, this
2182 is the scope (<code>this</code> reference) in which the handler function is executed.</p>
2183 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2184 </li></ul></div></div></div><div id="method-reset" class="member ni"><a href="Ext.form.field.Text.html#method-reset" rel="method-reset" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-method-reset" class="viewSource">view source</a></div><a name="reset"></a><a name="method-reset"></a><a href="Ext.form.field.Text.html#" rel="method-reset" class="cls expand">reset</a> : void</div><div class="description"><div class="short">Resets the current field value to the originally-loaded value and clears any validation messages.
2185 Also adds emptyText...</div><div class="long"><p>Resets the current field value to the originally-loaded value and clears any validation messages.
2186 Also adds <tt><b><a href="Ext.form.field.Text.html#emptyText" rel="Ext.form.field.Text#emptyText" class="docClass">emptyText</a></b></tt> and <tt><b><a href="Ext.form.field.Text.html#emptyCls" rel="Ext.form.field.Text#emptyCls" class="docClass">emptyCls</a></b></tt> if the
2187 original value was blank.</p>
2188 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2189 </li></ul></div></div></div><div id="method-resetOriginalValue" class="member inherited"><a href="Ext.form.field.Text.html#method-resetOriginalValue" rel="method-resetOriginalValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-resetOriginalValue" class="viewSource">view source</a></div><a name="resetOriginalValue"></a><a name="method-resetOriginalValue"></a><a href="Ext.form.field.Text.html#" rel="method-resetOriginalValue" class="cls expand">resetOriginalValue</a> : void</div><div class="description"><div class="short">Resets the field's originalValue property so it matches the current value.
2190 This is called by Ext.form.Basic.setValues...</div><div class="long"><p>Resets the field's <a href="Ext.form.field.Text.html#originalValue" rel="Ext.form.field.Text#originalValue" class="docClass">originalValue</a> property so it matches the current <a href="Ext.form.field.Text.html#getValue" rel="Ext.form.field.Text#getValue" class="docClass">value</a>.
2191 This is called by <a href="Ext.form.Basic.html" rel="Ext.form.Basic" class="docClass">Ext.form.Basic</a>.<a href="Ext.form.Basic.html#setValues" rel="Ext.form.Basic#setValues" class="docClass">setValues</a> if the form's
2192 <a href="Ext.form.Basic.html#trackResetOnLoad" rel="Ext.form.Basic#trackResetOnLoad" class="docClass">trackResetOnLoad</a> property is set to true.</p>
2193 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2194 </li></ul></div></div></div><div id="method-resumeEvents" class="member inherited"><a href="Ext.form.field.Text.html#method-resumeEvents" rel="method-resumeEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-resumeEvents" class="viewSource">view source</a></div><a name="resumeEvents"></a><a name="method-resumeEvents"></a><a href="Ext.form.field.Text.html#" rel="method-resumeEvents" class="cls expand">resumeEvents</a> : void</div><div class="description"><div class="short">Resume firing events. (see suspendEvents)
2195 If events were suspended using the queueSuspended parameter, then all
2196 event...</div><div class="long"><p>Resume firing events. (see <a href="Ext.form.field.Text.html#suspendEvents" rel="Ext.form.field.Text#suspendEvents" class="docClass">suspendEvents</a>)
2197 If events were suspended using the <code><b>queueSuspended</b></code> parameter, then all
2198 events fired during event suspension will be sent to any listeners now.</p>
2199 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2200 </li></ul></div></div></div><div id="method-selectText" class="member ni"><a href="Ext.form.field.Text.html#method-selectText" rel="method-selectText" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-method-selectText" class="viewSource">view source</a></div><a name="selectText"></a><a name="method-selectText"></a><a href="Ext.form.field.Text.html#" rel="method-selectText" class="cls expand">selectText</a>(
2201 <span class="pre">[Number start], [Number end]</span>)
2202  : void</div><div class="description"><div class="short"><p>Selects text in this field</p>
2203 </div><div class="long"><p>Selects text in this field</p>
2204 <h3 class="pa">Parameters</h3><ul><li><span class="pre">start</span> : Number<div class="sub-desc"><p>(optional) The index where the selection should start (defaults to 0)</p>
2205 </div></li><li><span class="pre">end</span> : Number<div class="sub-desc"><p>(optional) The index where the selection should end (defaults to the text length)</p>
2206 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2207 </li></ul></div></div></div><div id="method-sequenceFx" class="member inherited"><a href="Ext.form.field.Text.html#method-sequenceFx" rel="method-sequenceFx" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-method-sequenceFx" class="viewSource">view source</a></div><a name="sequenceFx"></a><a name="method-sequenceFx"></a><a href="Ext.form.field.Text.html#" rel="method-sequenceFx" class="cls expand">sequenceFx</a> : Ext.core.Element</div><div class="description"><div class="short">Ensures that all effects queued after sequenceFx is called on this object are
2208 run in sequence.  This is the opposite ...</div><div class="long"><p>Ensures that all effects queued after sequenceFx is called on this object are
2209 run in sequence.  This is the opposite of <a href="Ext.form.field.Text.html#syncFx" rel="Ext.form.field.Text#syncFx" class="docClass">syncFx</a>.</p>
2210 <h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.core.Element</span>&nbsp; &nbsp;<p>The Element</p>
2211 </li></ul></div></div></div><div id="method-setActive" class="member inherited"><a href="Ext.form.field.Text.html#method-setActive" rel="method-setActive" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-method-setActive" class="viewSource">view source</a></div><a name="setActive"></a><a name="method-setActive"></a><a href="Ext.form.field.Text.html#" rel="method-setActive" class="cls expand">setActive</a>(
2212 <span class="pre">Boolean active, Component newActive</span>)
2213  : void</div><div class="description"><div class="short">This method is called internally by Ext.ZIndexManager to signal that a floating
2214 Component has either been moved to th...</div><div class="long"><p>This method is called internally by <a href="Ext.ZIndexManager.html" rel="Ext.ZIndexManager" class="docClass">Ext.ZIndexManager</a> to signal that a floating
2215 Component has either been moved to the top of its zIndex stack, or pushed from the top of its zIndex stack.</p>
2216
2217
2218 <p>If a <i>Window</i> is superceded by another Window, deactivating it hides its shadow.</p>
2219
2220
2221 <p>This method also fires the <a href="Ext.form.field.Text.html#activate" rel="Ext.form.field.Text#activate" class="docClass">activate</a> or <a href="Ext.form.field.Text.html#deactivate" rel="Ext.form.field.Text#deactivate" class="docClass">deactivate</a> event depending on which action occurred.</p>
2222
2223 <h3 class="pa">Parameters</h3><ul><li><span class="pre">active</span> : Boolean<div class="sub-desc"><p>True to activate the Component, false to deactivate it (defaults to false)</p>
2224 </div></li><li><span class="pre">newActive</span> : Component<div class="sub-desc"><p>The newly active Component which is taking over topmost zIndex position.</p>
2225 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2226 </li></ul></div></div></div><div id="method-setActiveError" class="member inherited"><a href="Ext.form.field.Text.html#method-setActiveError" rel="method-setActiveError" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-setActiveError" class="viewSource">view source</a></div><a name="setActiveError"></a><a name="method-setActiveError"></a><a href="Ext.form.field.Text.html#" rel="method-setActiveError" class="cls expand">setActiveError</a>(
2227 <span class="pre">String msg</span>)
2228  : void</div><div class="description"><div class="short">Sets the active error message to the given string. This replaces the entire error message
2229 contents with the given str...</div><div class="long"><p>Sets the active error message to the given string. This replaces the entire error message
2230 contents with the given string. Also see <a href="Ext.form.field.Text.html#setActiveErrors" rel="Ext.form.field.Text#setActiveErrors" class="docClass">setActiveErrors</a> which accepts an Array of
2231 messages and formats them according to the <a href="Ext.form.field.Text.html#activeErrorsTpl" rel="Ext.form.field.Text#activeErrorsTpl" class="docClass">activeErrorsTpl</a>.</p>
2232 <h3 class="pa">Parameters</h3><ul><li><span class="pre">msg</span> : String<div class="sub-desc"><p>The error message</p>
2233 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2234 </li></ul></div></div></div><div id="method-setActiveErrors" class="member inherited"><a href="Ext.form.field.Text.html#method-setActiveErrors" rel="method-setActiveErrors" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-setActiveErrors" class="viewSource">view source</a></div><a name="setActiveErrors"></a><a name="method-setActiveErrors"></a><a href="Ext.form.field.Text.html#" rel="method-setActiveErrors" class="cls expand">setActiveErrors</a>(
2235 <span class="pre">Array errors</span>)
2236  : void</div><div class="description"><div class="short">Set the active error message to an Array of error messages. The messages are formatted into
2237 a single message string u...</div><div class="long"><p>Set the active error message to an Array of error messages. The messages are formatted into
2238 a single message string using the <a href="Ext.form.field.Text.html#activeErrorsTpl" rel="Ext.form.field.Text#activeErrorsTpl" class="docClass">activeErrorsTpl</a>. Also see <a href="Ext.form.field.Text.html#setActiveError" rel="Ext.form.field.Text#setActiveError" class="docClass">setActiveError</a>
2239 which allows setting the entire error contents with a single string.</p>
2240 <h3 class="pa">Parameters</h3><ul><li><span class="pre">errors</span> : Array<div class="sub-desc"><p>The error messages</p>
2241 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2242 </li></ul></div></div></div><div id="method-setAutoScroll" class="member inherited"><a href="Ext.form.field.Text.html#method-setAutoScroll" rel="method-setAutoScroll" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-setAutoScroll" class="viewSource">view source</a></div><a name="setAutoScroll"></a><a name="method-setAutoScroll"></a><a href="Ext.form.field.Text.html#" rel="method-setAutoScroll" class="cls expand">setAutoScroll</a>(
2243 <span class="pre">Boolean scroll</span>)
2244  : Ext.Component</div><div class="description"><div class="short"><p>Sets the overflow on the content element of the component.</p>
2245 </div><div class="long"><p>Sets the overflow on the content element of the component.</p>
2246 <h3 class="pa">Parameters</h3><ul><li><span class="pre">scroll</span> : Boolean<div class="sub-desc"><p>True to allow the Component to auto scroll.</p>
2247 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2248 </li></ul></div></div></div><div id="method-setDisabled" class="member inherited"><a href="Ext.form.field.Text.html#method-setDisabled" rel="method-setDisabled" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setDisabled" class="viewSource">view source</a></div><a name="setDisabled"></a><a name="method-setDisabled"></a><a href="Ext.form.field.Text.html#" rel="method-setDisabled" class="cls expand">setDisabled</a>(
2249 <span class="pre">Boolean disabled</span>)
2250  : void</div><div class="description"><div class="short"><p>Enable or disable the component.</p>
2251 </div><div class="long"><p>Enable or disable the component.</p>
2252 <h3 class="pa">Parameters</h3><ul><li><span class="pre">disabled</span> : Boolean<div class="sub-desc">
2253 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2254 </li></ul></div></div></div><div id="method-setDocked" class="member inherited"><a href="Ext.form.field.Text.html#method-setDocked" rel="method-setDocked" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setDocked" class="viewSource">view source</a></div><a name="setDocked"></a><a name="method-setDocked"></a><a href="Ext.form.field.Text.html#" rel="method-setDocked" class="cls expand">setDocked</a>(
2255 <span class="pre">Object dock, Object layoutParent</span>)
2256  : Component</div><div class="description"><div class="short">Sets the dock position of this component in its parent panel. Note that
2257 this only has effect if this item is part of ...</div><div class="long"><p>Sets the dock position of this component in its parent panel. Note that
2258 this only has effect if this item is part of the dockedItems collection
2259 of a parent that has a DockLayout (note that any Panel has a DockLayout
2260 by default)</p>
2261 <h3 class="pa">Parameters</h3><ul><li><span class="pre">dock</span> : Object<div class="sub-desc">
2262 </div></li><li><span class="pre">layoutParent</span> : Object<div class="sub-desc">
2263 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Component</span>&nbsp; &nbsp;<p>this</p>
2264 </li></ul></div></div></div><div id="method-setFieldDefaults" class="member inherited"><a href="Ext.form.field.Text.html#method-setFieldDefaults" rel="method-setFieldDefaults" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-setFieldDefaults" class="viewSource">view source</a></div><a name="setFieldDefaults"></a><a name="method-setFieldDefaults"></a><a href="Ext.form.field.Text.html#" rel="method-setFieldDefaults" class="cls expand">setFieldDefaults</a>(
2265 <span class="pre">Object defaults</span>)
2266  : void</div><div class="description"><div class="short">Applies a set of default configuration values to this Labelable instance. For each of the
2267 properties in the given obj...</div><div class="long"><p>Applies a set of default configuration values to this Labelable instance. For each of the
2268 properties in the given object, check if this component hasOwnProperty that config; if not
2269 then it's inheriting a default value from its prototype and we should apply the default value.</p>
2270 <h3 class="pa">Parameters</h3><ul><li><span class="pre">defaults</span> : Object<div class="sub-desc"><p>The defaults to apply to the object.</p>
2271 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2272 </li></ul></div></div></div><div id="method-setFieldStyle" class="member inherited"><a href="Ext.form.field.Text.html#method-setFieldStyle" rel="method-setFieldStyle" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-setFieldStyle" class="viewSource">view source</a></div><a name="setFieldStyle"></a><a name="method-setFieldStyle"></a><a href="Ext.form.field.Text.html#" rel="method-setFieldStyle" class="cls expand">setFieldStyle</a>(
2273 <span class="pre">String/Object/Function style</span>)
2274  : void</div><div class="description"><div class="short"><p>Set the <a href="Ext.form.field.Text.html#fieldStyle" rel="Ext.form.field.Text#fieldStyle" class="docClass">CSS style</a> of the <a href="Ext.form.field.Text.html#inputEl" rel="Ext.form.field.Text#inputEl" class="docClass">field input element</a>.</p>
2275 </div><div class="long"><p>Set the <a href="Ext.form.field.Text.html#fieldStyle" rel="Ext.form.field.Text#fieldStyle" class="docClass">CSS style</a> of the <a href="Ext.form.field.Text.html#inputEl" rel="Ext.form.field.Text#inputEl" class="docClass">field input element</a>.</p>
2276 <h3 class="pa">Parameters</h3><ul><li><span class="pre">style</span> : String/Object/Function<div class="sub-desc"><p>The style(s) to apply. Should be a valid argument to
2277 <a href="Ext.core.Element.html#applyStyles" rel="Ext.core.Element#applyStyles" class="docClass">Ext.core.Element.applyStyles</a>.</p>
2278 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2279 </li></ul></div></div></div><div id="method-setHeight" class="member inherited"><a href="Ext.form.field.Text.html#method-setHeight" rel="method-setHeight" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setHeight" class="viewSource">view source</a></div><a name="setHeight"></a><a name="method-setHeight"></a><a href="Ext.form.field.Text.html#" rel="method-setHeight" class="cls expand">setHeight</a>(
2280 <span class="pre">Number height</span>)
2281  : Ext.Component</div><div class="description"><div class="short"><p>Sets the height of the component.  This method fires the <a href="Ext.form.field.Text.html#resize" rel="Ext.form.field.Text#resize" class="docClass">resize</a> event.</p>
2282 </div><div class="long"><p>Sets the height of the component.  This method fires the <a href="Ext.form.field.Text.html#resize" rel="Ext.form.field.Text#resize" class="docClass">resize</a> event.</p>
2283 <h3 class="pa">Parameters</h3><ul><li><span class="pre">height</span> : Number<div class="sub-desc"><p>The new height to set. This may be one of:<div class="mdetail-params"><ul>
2284 <li>A Number specifying the new height in the <a href="Ext.form.field.Text.html#getEl" rel="Ext.form.field.Text#getEl" class="docClass">Element</a>'s <a href="Ext.core.Element.html#defaultUnit" rel="Ext.core.Element#defaultUnit" class="docClass">Ext.core.Element.defaultUnit</a>s (by default, pixels).</li>
2285 <li>A String used to set the CSS height style.</li>
2286 <li><i>undefined</i> to leave the height unchanged.</li>
2287 </ul></div></p>
2288 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2289 </li></ul></div></div></div><div id="method-setLoading" class="member inherited"><a href="Ext.form.field.Text.html#method-setLoading" rel="method-setLoading" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setLoading" class="viewSource">view source</a></div><a name="setLoading"></a><a name="method-setLoading"></a><a href="Ext.form.field.Text.html#" rel="method-setLoading" class="cls expand">setLoading</a>(
2290 <span class="pre">Boolean/Object/String load, Boolean targetEl</span>)
2291  : Ext.LoadMask</div><div class="description"><div class="short"><p>This method allows you to show or hide a LoadMask on top of this component.</p>
2292 </div><div class="long"><p>This method allows you to show or hide a LoadMask on top of this component.</p>
2293 <h3 class="pa">Parameters</h3><ul><li><span class="pre">load</span> : Boolean/Object/String<div class="sub-desc"><p>True to show the default LoadMask, a config object
2294 that will be passed to the LoadMask constructor, or a message String to show. False to
2295 hide the current LoadMask.</p>
2296 </div></li><li><span class="pre">targetEl</span> : Boolean<div class="sub-desc"><p>True to mask the targetEl of this Component instead of the this.el.
2297 For example, setting this to true on a Panel will cause only the body to be masked. (defaults to false)</p>
2298 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.LoadMask</span>&nbsp; &nbsp;<p>The LoadMask instance that has just been shown.</p>
2299 </li></ul></div></div></div><div id="method-setPagePosition" class="member inherited"><a href="Ext.form.field.Text.html#method-setPagePosition" rel="method-setPagePosition" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-setPagePosition" class="viewSource">view source</a></div><a name="setPagePosition"></a><a name="method-setPagePosition"></a><a href="Ext.form.field.Text.html#" rel="method-setPagePosition" class="cls expand">setPagePosition</a>(
2300 <span class="pre">Number x, Number y, Mixed animate</span>)
2301  : Ext.Component</div><div class="description"><div class="short">Sets the page XY position of the component.  To set the left and top instead, use setPosition.
2302 This method fires the ...</div><div class="long"><p>Sets the page XY position of the component.  To set the left and top instead, use <a href="Ext.form.field.Text.html#setPosition" rel="Ext.form.field.Text#setPosition" class="docClass">setPosition</a>.
2303 This method fires the <a href="Ext.form.field.Text.html#move" rel="Ext.form.field.Text#move" class="docClass">move</a> event.</p>
2304 <h3 class="pa">Parameters</h3><ul><li><span class="pre">x</span> : Number<div class="sub-desc"><p>The new x position</p>
2305 </div></li><li><span class="pre">y</span> : Number<div class="sub-desc"><p>The new y position</p>
2306 </div></li><li><span class="pre">animate</span> : Mixed<div class="sub-desc"><p>If passed, the Component is <i>animated</i> into its new position. If this parameter
2307 is a number, it is used as the animation duration in milliseconds.</p>
2308 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2309 </li></ul></div></div></div><div id="method-setPosition" class="member inherited"><a href="Ext.form.field.Text.html#method-setPosition" rel="method-setPosition" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-setPosition" class="viewSource">view source</a></div><a name="setPosition"></a><a name="method-setPosition"></a><a href="Ext.form.field.Text.html#" rel="method-setPosition" class="cls expand">setPosition</a>(
2310 <span class="pre">Number left, Number top, Mixed animate</span>)
2311  : Ext.Component</div><div class="description"><div class="short">Sets the left and top of the component.  To set the page XY position instead, use setPagePosition.
2312 This method fires ...</div><div class="long"><p>Sets the left and top of the component.  To set the page XY position instead, use <a href="Ext.form.field.Text.html#setPagePosition" rel="Ext.form.field.Text#setPagePosition" class="docClass">setPagePosition</a>.
2313 This method fires the <a href="Ext.form.field.Text.html#move" rel="Ext.form.field.Text#move" class="docClass">move</a> event.</p>
2314 <h3 class="pa">Parameters</h3><ul><li><span class="pre">left</span> : Number<div class="sub-desc"><p>The new left</p>
2315 </div></li><li><span class="pre">top</span> : Number<div class="sub-desc"><p>The new top</p>
2316 </div></li><li><span class="pre">animate</span> : Mixed<div class="sub-desc"><p>If true, the Component is <i>animated</i> into its new position. You may also pass an animation configuration.</p>
2317 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2318 </li></ul></div></div></div><div id="method-setRawValue" class="member inherited"><a href="Ext.form.field.Text.html#method-setRawValue" rel="method-setRawValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-setRawValue" class="viewSource">view source</a></div><a name="setRawValue"></a><a name="method-setRawValue"></a><a href="Ext.form.field.Text.html#" rel="method-setRawValue" class="cls expand">setRawValue</a>(
2319 <span class="pre">Mixed value</span>)
2320  : Mixed</div><div class="description"><div class="short">Sets the field's raw value directly, bypassing value conversion, change detection, and
2321 validation. To set the value w...</div><div class="long"><p>Sets the field's raw value directly, bypassing <a href="Ext.form.field.Text.html#valueToRaw" rel="Ext.form.field.Text#valueToRaw" class="docClass">value conversion</a>, change detection, and
2322 validation. To set the value with these additional inspections see <a href="Ext.form.field.Text.html#setValue" rel="Ext.form.field.Text#setValue" class="docClass">setValue</a>.</p>
2323 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value</span> : Mixed<div class="sub-desc"><p>The value to set</p>
2324 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Mixed</span>&nbsp; &nbsp;<p>value The field value that is set</p>
2325 </li></ul></div></div></div><div id="method-setReadOnly" class="member inherited"><a href="Ext.form.field.Text.html#method-setReadOnly" rel="method-setReadOnly" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-setReadOnly" class="viewSource">view source</a></div><a name="setReadOnly"></a><a name="method-setReadOnly"></a><a href="Ext.form.field.Text.html#" rel="method-setReadOnly" class="cls expand">setReadOnly</a>(
2326 <span class="pre">Boolean readOnly</span>)
2327  : void</div><div class="description"><div class="short"><p>Sets the read only state of this field.</p>
2328 </div><div class="long"><p>Sets the read only state of this field.</p>
2329 <h3 class="pa">Parameters</h3><ul><li><span class="pre">readOnly</span> : Boolean<div class="sub-desc"><p>Whether the field should be read only.</p>
2330 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2331 </li></ul></div></div></div><div id="method-setSize" class="member inherited"><a href="Ext.form.field.Text.html#method-setSize" rel="method-setSize" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setSize" class="viewSource">view source</a></div><a name="setSize"></a><a name="method-setSize"></a><a href="Ext.form.field.Text.html#" rel="method-setSize" class="cls expand">setSize</a>(
2332 <span class="pre">Mixed width, Mixed height</span>)
2333  : Ext.Component</div><div class="description"><div class="short">Sets the width and height of this Component. This method fires the resize event. This method can accept
2334 either width ...</div><div class="long"><p>Sets the width and height of this Component. This method fires the <a href="Ext.form.field.Text.html#resize" rel="Ext.form.field.Text#resize" class="docClass">resize</a> event. This method can accept
2335 either width and height as separate arguments, or you can pass a size object like <code>{width:10, height:20}</code>.</p>
2336 <h3 class="pa">Parameters</h3><ul><li><span class="pre">width</span> : Mixed<div class="sub-desc"><p>The new width to set. This may be one of:<div class="mdetail-params"><ul>
2337 <li>A Number specifying the new width in the <a href="Ext.form.field.Text.html#getEl" rel="Ext.form.field.Text#getEl" class="docClass">Element</a>'s <a href="Ext.core.Element.html#defaultUnit" rel="Ext.core.Element#defaultUnit" class="docClass">Ext.core.Element.defaultUnit</a>s (by default, pixels).</li>
2338 <li>A String used to set the CSS width style.</li>
2339 <li>A size object in the format <code>{width: widthValue, height: heightValue}</code>.</li>
2340 <li><code>undefined</code> to leave the width unchanged.</li>
2341 </ul></div></p>
2342 </div></li><li><span class="pre">height</span> : Mixed<div class="sub-desc"><p>The new height to set (not required if a size object is passed as the first arg).
2343 This may be one of:<div class="mdetail-params"><ul>
2344 <li>A Number specifying the new height in the <a href="Ext.form.field.Text.html#getEl" rel="Ext.form.field.Text#getEl" class="docClass">Element</a>'s <a href="Ext.core.Element.html#defaultUnit" rel="Ext.core.Element#defaultUnit" class="docClass">Ext.core.Element.defaultUnit</a>s (by default, pixels).</li>
2345 <li>A String used to set the CSS height style. Animation may <b>not</b> be used.</li>
2346 <li><code>undefined</code> to leave the height unchanged.</li>
2347 </ul></div></p>
2348 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2349 </li></ul></div></div></div><div id="method-setUI" class="member inherited"><a href="Ext.form.field.Text.html#method-setUI" rel="method-setUI" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setUI" class="viewSource">view source</a></div><a name="setUI"></a><a name="method-setUI"></a><a href="Ext.form.field.Text.html#" rel="method-setUI" class="cls expand">setUI</a>(
2350 <span class="pre">String ui</span>)
2351  : void</div><div class="description"><div class="short">Sets the UI for the component. This will remove any existing UIs on the component. It will also
2352 loop through any uiCl...</div><div class="long"><p>Sets the UI for the component. This will remove any existing UIs on the component. It will also
2353 loop through any uiCls set on the component and rename them so they include the new UI</p>
2354 <h3 class="pa">Parameters</h3><ul><li><span class="pre">ui</span> : String<div class="sub-desc"><p>The new UI for the component</p>
2355 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2356 </li></ul></div></div></div><div id="method-setValue" class="member ni"><a href="Ext.form.field.Text.html#method-setValue" rel="method-setValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-method-setValue" class="viewSource">view source</a></div><a name="setValue"></a><a name="method-setValue"></a><a href="Ext.form.field.Text.html#" rel="method-setValue" class="cls expand">setValue</a>(
2357 <span class="pre">Mixed value</span>)
2358  : Ext.form.field.Text</div><div class="description"><div class="short">Sets a data value into the field and runs the change detection and validation. Also applies any configured
2359 emptyText ...</div><div class="long"><p>Sets a data value into the field and runs the change detection and validation. Also applies any configured
2360 <a href="Ext.form.field.Text.html#emptyText" rel="Ext.form.field.Text#emptyText" class="docClass">emptyText</a> for text fields. To set the value directly without these inspections see <a href="Ext.form.field.Text.html#setRawValue" rel="Ext.form.field.Text#setRawValue" class="docClass">setRawValue</a>.</p>
2361 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value</span> : Mixed<div class="sub-desc"><p>The value to set</p>
2362 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.form.field.Text</span>&nbsp; &nbsp;<p>this</p>
2363 </li></ul></div></div></div><div id="method-setVisible" class="member inherited"><a href="Ext.form.field.Text.html#method-setVisible" rel="method-setVisible" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setVisible" class="viewSource">view source</a></div><a name="setVisible"></a><a name="method-setVisible"></a><a href="Ext.form.field.Text.html#" rel="method-setVisible" class="cls expand">setVisible</a>(
2364 <span class="pre">Boolean visible</span>)
2365  : Ext.Component</div><div class="description"><div class="short"><p>Convenience function to hide or show this component by boolean.</p>
2366 </div><div class="long"><p>Convenience function to hide or show this component by boolean.</p>
2367 <h3 class="pa">Parameters</h3><ul><li><span class="pre">visible</span> : Boolean<div class="sub-desc"><p>True to show, false to hide</p>
2368 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2369 </li></ul></div></div></div><div id="method-setWidth" class="member inherited"><a href="Ext.form.field.Text.html#method-setWidth" rel="method-setWidth" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-setWidth" class="viewSource">view source</a></div><a name="setWidth"></a><a name="method-setWidth"></a><a href="Ext.form.field.Text.html#" rel="method-setWidth" class="cls expand">setWidth</a>(
2370 <span class="pre">Number width</span>)
2371  : Ext.Component</div><div class="description"><div class="short"><p>Sets the width of the component.  This method fires the <a href="Ext.form.field.Text.html#resize" rel="Ext.form.field.Text#resize" class="docClass">resize</a> event.</p>
2372 </div><div class="long"><p>Sets the width of the component.  This method fires the <a href="Ext.form.field.Text.html#resize" rel="Ext.form.field.Text#resize" class="docClass">resize</a> event.</p>
2373 <h3 class="pa">Parameters</h3><ul><li><span class="pre">width</span> : Number<div class="sub-desc"><p>The new width to setThis may be one of:<div class="mdetail-params"><ul>
2374 <li>A Number specifying the new width in the <a href="Ext.form.field.Text.html#getEl" rel="Ext.form.field.Text#getEl" class="docClass">Element</a>'s <a href="Ext.core.Element.html#defaultUnit" rel="Ext.core.Element#defaultUnit" class="docClass">Ext.core.Element.defaultUnit</a>s (by default, pixels).</li>
2375 <li>A String used to set the CSS width style.</li>
2376 </ul></div></p>
2377 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2378 </li></ul></div></div></div><div id="method-show" class="member inherited"><a href="Ext.form.field.Text.html#method-show" rel="method-show" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-show" class="viewSource">view source</a></div><a name="show"></a><a name="method-show"></a><a href="Ext.form.field.Text.html#" rel="method-show" class="cls expand">show</a>(
2379 <span class="pre">String/Element animateTarget, [Function callback], [Object scope]</span>)
2380  : Component</div><div class="description"><div class="short">Shows this Component, rendering it first if autoRender or {&quot;floating are true.
2381
2382
2383 After being shown, a floating C...</div><div class="long"><p>Shows this Component, rendering it first if <a href="Ext.form.field.Text.html#autoRender" rel="Ext.form.field.Text#autoRender" class="docClass">autoRender</a> or {<a href="Ext.form.field.Text.html"floating" rel=""floating" class="docClass">&quot;floating</a> are <code>true</code>.</p>
2384
2385
2386 <p>After being shown, a <a href="Ext.form.field.Text.html#floating" rel="Ext.form.field.Text#floating" class="docClass">floating</a> Component (such as a <a href="Ext.window.Window.html" rel="Ext.window.Window" class="docClass">Ext.window.Window</a>), is activated it and brought to the front of
2387 its <a href="Ext.form.field.Text.html#ZIndexManager" rel="Ext.form.field.Text#ZIndexManager" class="docClass">z-index stack</a>.</p>
2388
2389 <h3 class="pa">Parameters</h3><ul><li><span class="pre">animateTarget</span> : String/Element<div class="sub-desc"><p>Optional, and <b>only valid for <a href="Ext.form.field.Text.html#floating" rel="Ext.form.field.Text#floating" class="docClass">floating</a> Components such as
2390 <a href="Ext.window.Window.html" rel="Ext.window.Window" class="docClass">Window</a>s or <a href="Ext.tip.ToolTip.html" rel="Ext.tip.ToolTip" class="docClass">ToolTip</a>s, or regular Components which have been configured
2391 with <code>floating: true</code>.</b> The target from which the Component should
2392 animate from while opening (defaults to null with no animation)</p>
2393 </div></li><li><span class="pre">callback</span> : Function<div class="sub-desc"><p>(optional) A callback function to call after the Component is displayed. Only necessary if animation was specified.</p>
2394 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope (<code>this</code> reference) in which the callback is executed. Defaults to this Component.</p>
2395 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Component</span>&nbsp; &nbsp;<p>this</p>
2396 </li></ul></div></div></div><div id="method-stopAnimation" class="member inherited"><a href="Ext.form.field.Text.html#method-stopAnimation" rel="method-stopAnimation" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-method-stopAnimation" class="viewSource">view source</a></div><a name="stopAnimation"></a><a name="method-stopAnimation"></a><a href="Ext.form.field.Text.html#" rel="method-stopAnimation" class="cls expand">stopAnimation</a> : Ext.core.Element</div><div class="description"><div class="short">@deprecated 4.0 Replaced by stopAnimation
2397 Stops any running effects and clears this object's internal effects queue i...</div><div class="long"><p>@deprecated 4.0 Replaced by <a href="Ext.form.field.Text.html#stopAnimation" rel="Ext.form.field.Text#stopAnimation" class="docClass">stopAnimation</a>
2398 Stops any running effects and clears this object's internal effects queue if it contains
2399 any additional effects that haven't started yet.</p>
2400 <h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.core.Element</span>&nbsp; &nbsp;<p>The Element</p>
2401 </li></ul></div></div></div><div id="method-suspendEvents" class="member inherited"><a href="Ext.form.field.Text.html#method-suspendEvents" rel="method-suspendEvents" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-suspendEvents" class="viewSource">view source</a></div><a name="suspendEvents"></a><a name="method-suspendEvents"></a><a href="Ext.form.field.Text.html#" rel="method-suspendEvents" class="cls expand">suspendEvents</a>(
2402 <span class="pre">Boolean queueSuspended</span>)
2403  : void</div><div class="description"><div class="short"><p>Suspend the firing of all events. (see <a href="Ext.form.field.Text.html#resumeEvents" rel="Ext.form.field.Text#resumeEvents" class="docClass">resumeEvents</a>)</p>
2404 </div><div class="long"><p>Suspend the firing of all events. (see <a href="Ext.form.field.Text.html#resumeEvents" rel="Ext.form.field.Text#resumeEvents" class="docClass">resumeEvents</a>)</p>
2405 <h3 class="pa">Parameters</h3><ul><li><span class="pre">queueSuspended</span> : Boolean<div class="sub-desc"><p>Pass as true to queue up suspended events to be fired
2406 after the <a href="Ext.form.field.Text.html#resumeEvents" rel="Ext.form.field.Text#resumeEvents" class="docClass">resumeEvents</a> call instead of discarding all suspended events;</p>
2407 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2408 </li></ul></div></div></div><div id="method-syncFx" class="member inherited"><a href="Ext.form.field.Text.html#method-syncFx" rel="method-syncFx" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Animate.html" class="definedIn docClass">Ext.util.Animate</a><br/><a href="../source/Animate.html#Ext-util.Animate-method-syncFx" class="viewSource">view source</a></div><a name="syncFx"></a><a name="method-syncFx"></a><a href="Ext.form.field.Text.html#" rel="method-syncFx" class="cls expand">syncFx</a> : Ext.core.Element</div><div class="description"><div class="short">Ensures that all effects queued after syncFx is called on this object are
2409 run concurrently.  This is the opposite of ...</div><div class="long"><p>Ensures that all effects queued after syncFx is called on this object are
2410 run concurrently.  This is the opposite of <a href="Ext.form.field.Text.html#sequenceFx" rel="Ext.form.field.Text#sequenceFx" class="docClass">sequenceFx</a>.</p>
2411 <h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.core.Element</span>&nbsp; &nbsp;<p>The Element</p>
2412 </li></ul></div></div></div><div id="method-toBack" class="member inherited"><a href="Ext.form.field.Text.html#method-toBack" rel="method-toBack" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-method-toBack" class="viewSource">view source</a></div><a name="toBack"></a><a name="method-toBack"></a><a href="Ext.form.field.Text.html#" rel="method-toBack" class="cls expand">toBack</a> : Component</div><div class="description"><div class="short"><p>Sends this Component to the back of (lower z-index than) any other visible windows</p>
2413 </div><div class="long"><p>Sends this Component to the back of (lower z-index than) any other visible windows</p>
2414 <h3 class="pa">Returns</h3><ul><li><span class="pre">Component</span>&nbsp; &nbsp;<p>this</p>
2415 </li></ul></div></div></div><div id="method-toFront" class="member inherited"><a href="Ext.form.field.Text.html#method-toFront" rel="method-toFront" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Floating.html" class="definedIn docClass">Ext.util.Floating</a><br/><a href="../source/Floating.html#Ext-util.Floating-method-toFront" class="viewSource">view source</a></div><a name="toFront"></a><a name="method-toFront"></a><a href="Ext.form.field.Text.html#" rel="method-toFront" class="cls expand">toFront</a>(
2416 <span class="pre">[Boolean preventFocus]</span>)
2417  : Component</div><div class="description"><div class="short">Brings this floating Component to the front of any other visible, floating Components managed by the same ZIndexManag...</div><div class="long"><p>Brings this floating Component to the front of any other visible, floating Components managed by the same <a href="Ext.ZIndexManager.html" rel="Ext.ZIndexManager" class="docClass">ZIndexManager</a></p>
2418
2419
2420 <p>If this Component is modal, inserts the modal mask just below this Component in the z-index stack.</p>
2421
2422 <h3 class="pa">Parameters</h3><ul><li><span class="pre">preventFocus</span> : Boolean<div class="sub-desc"><p>(optional) Specify <code>true</code> to prevent the Component from being focused.</p>
2423 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Component</span>&nbsp; &nbsp;<p>this</p>
2424 </li></ul></div></div></div><div id="method-un" class="member inherited"><a href="Ext.form.field.Text.html#method-un" rel="method-un" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.util.Observable.html" class="definedIn docClass">Ext.util.Observable</a><br/><a href="../source/Observable.html#Ext-util.Observable-method-un" class="viewSource">view source</a></div><a name="un"></a><a name="method-un"></a><a href="Ext.form.field.Text.html#" rel="method-un" class="cls expand">un</a>(
2425 <span class="pre">String eventName, Function handler, [Object scope]</span>)
2426  : void</div><div class="description"><div class="short"><p>Removes an event handler (shorthand for <a href="Ext.form.field.Text.html#removeListener" rel="Ext.form.field.Text#removeListener" class="docClass">removeListener</a>.)</p>
2427 </div><div class="long"><p>Removes an event handler (shorthand for <a href="Ext.form.field.Text.html#removeListener" rel="Ext.form.field.Text#removeListener" class="docClass">removeListener</a>.)</p>
2428 <h3 class="pa">Parameters</h3><ul><li><span class="pre">eventName</span> : String<div class="sub-desc"><p>The type of event the handler was associated with.</p>
2429 </div></li><li><span class="pre">handler</span> : Function<div class="sub-desc"><p>The handler to remove. <b>This must be a reference to the function passed into the <a href="Ext.form.field.Text.html#addListener" rel="Ext.form.field.Text#addListener" class="docClass">addListener</a> call.</b></p>
2430 </div></li><li><span class="pre">scope</span> : Object<div class="sub-desc"><p>(optional) The scope originally specified for the handler.</p>
2431 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2432 </li></ul></div></div></div><div id="method-unsetActiveError" class="member inherited"><a href="Ext.form.field.Text.html#method-unsetActiveError" rel="method-unsetActiveError" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-method-unsetActiveError" class="viewSource">view source</a></div><a name="unsetActiveError"></a><a name="method-unsetActiveError"></a><a href="Ext.form.field.Text.html#" rel="method-unsetActiveError" class="cls expand">unsetActiveError</a> : void</div><div class="description"><div class="short"><p>Clears the active error.</p>
2433 </div><div class="long"><p>Clears the active error.</p>
2434 <h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2435 </li></ul></div></div></div><div id="method-up" class="member inherited"><a href="Ext.form.field.Text.html#method-up" rel="method-up" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-up" class="viewSource">view source</a></div><a name="up"></a><a name="method-up"></a><a href="Ext.form.field.Text.html#" rel="method-up" class="cls expand">up</a>(
2436 <span class="pre">String selector</span>)
2437  : Container</div><div class="description"><div class="short">Walks up the ownerCt axis looking for an ancestor Container which matches
2438 the passed simple selector.
2439
2440
2441 Example:
2442 var ...</div><div class="long"><p>Walks up the <code>ownerCt</code> axis looking for an ancestor Container which matches
2443 the passed simple selector.</p>
2444
2445
2446 <p>Example:
2447 <pre><code>var owningTabPanel = grid.up('tabpanel');
2448 </code></pre>
2449
2450 <h3 class="pa">Parameters</h3><ul><li><span class="pre">selector</span> : String<div class="sub-desc"><p>Optional. The simple selector to test.</p>
2451 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Container</span>&nbsp; &nbsp;<p>The matching ancestor Container (or <code>undefined</code> if no match was found).</p>
2452 </li></ul></div></div></div><div id="method-update" class="member inherited"><a href="Ext.form.field.Text.html#method-update" rel="method-update" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-method-update" class="viewSource">view source</a></div><a name="update"></a><a name="method-update"></a><a href="Ext.form.field.Text.html#" rel="method-update" class="cls expand">update</a>(
2453 <span class="pre">Mixed htmlOrData, [Boolean loadScripts], [Function callback]</span>)
2454  : void</div><div class="description"><div class="short"><p>Update the content area of a component.</p>
2455 </div><div class="long"><p>Update the content area of a component.</p>
2456 <h3 class="pa">Parameters</h3><ul><li><span class="pre">htmlOrData</span> : Mixed<div class="sub-desc"><p>If this component has been configured with a template via the tpl config
2457 then it will use this argument as data to populate the template.
2458 If this component was not configured with a template, the components
2459 content area will be updated via <a href="Ext.core.Element.html" rel="Ext.core.Element" class="docClass">Ext.core.Element</a> update</p>
2460 </div></li><li><span class="pre">loadScripts</span> : Boolean<div class="sub-desc"><p>(optional) Only legitimate when using the html configuration. Defaults to false</p>
2461 </div></li><li><span class="pre">callback</span> : Function<div class="sub-desc"><p>(optional) Only legitimate when using the html configuration. Callback to execute when scripts have finished loading</p>
2462 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">void</span>&nbsp; &nbsp;
2463 </li></ul></div></div></div><div id="method-updateBox" class="member inherited"><a href="Ext.form.field.Text.html#method-updateBox" rel="method-updateBox" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.Component.html" class="definedIn docClass">Ext.Component</a><br/><a href="../source/Component.html#Ext-Component-method-updateBox" class="viewSource">view source</a></div><a name="updateBox"></a><a name="method-updateBox"></a><a href="Ext.form.field.Text.html#" rel="method-updateBox" class="cls expand">updateBox</a>(
2464 <span class="pre">Object box</span>)
2465  : Ext.Component</div><div class="description"><div class="short"><p>Sets the current box measurements of the component's underlying element.</p>
2466 </div><div class="long"><p>Sets the current box measurements of the component's underlying element.</p>
2467 <h3 class="pa">Parameters</h3><ul><li><span class="pre">box</span> : Object<div class="sub-desc"><p>An object in the format {x, y, width, height}</p>
2468 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Ext.Component</span>&nbsp; &nbsp;<p>this</p>
2469 </li></ul></div></div></div><div id="method-validate" class="member inherited"><a href="Ext.form.field.Text.html#method-validate" rel="method-validate" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-method-validate" class="viewSource">view source</a></div><a name="validate"></a><a name="method-validate"></a><a href="Ext.form.field.Text.html#" rel="method-validate" class="cls expand">validate</a> : Boolean</div><div class="description"><div class="short">Returns whether or not the field value is currently valid by validating the
2470 field's current value, and fires the vali...</div><div class="long"><p>Returns whether or not the field value is currently valid by <a href="Ext.form.field.Text.html#getErrors" rel="Ext.form.field.Text#getErrors" class="docClass">validating</a> the
2471 field's current value, and fires the <a href="Ext.form.field.Text.html#validitychange" rel="Ext.form.field.Text#validitychange" class="docClass">validitychange</a> event if the field's validity has
2472 changed since the last validation. <b>Note</b>: <a href="Ext.form.field.Text.html#disabled" rel="Ext.form.field.Text#disabled" class="docClass">disabled</a> fields are always treated as valid.</p>
2473
2474
2475 <p>Custom implementations of this method are allowed to have side-effects such as triggering error
2476 message display. To validate without side-effects, use <a href="Ext.form.field.Text.html#isValid" rel="Ext.form.field.Text#isValid" class="docClass">isValid</a>.</p>
2477
2478 <h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if the value is valid, else false</p>
2479 </li></ul></div></div></div><div id="method-validateValue" class="member inherited"><a href="Ext.form.field.Text.html#method-validateValue" rel="method-validateValue" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-validateValue" class="viewSource">view source</a></div><a name="validateValue"></a><a name="method-validateValue"></a><a href="Ext.form.field.Text.html#" rel="method-validateValue" class="cls expand">validateValue</a>(
2480 <span class="pre">Mixed value</span>)
2481  : Boolean</div><div class="description"><div class="short">Uses getErrors to build an array of validation errors. If any errors are found, they are passed
2482 to markInvalid and fa...</div><div class="long"><p>Uses <a href="Ext.form.field.Text.html#getErrors" rel="Ext.form.field.Text#getErrors" class="docClass">getErrors</a> to build an array of validation errors. If any errors are found, they are passed
2483 to <a href="Ext.form.field.Text.html#markInvalid" rel="Ext.form.field.Text#markInvalid" class="docClass">markInvalid</a> and false is returned, otherwise true is returned.</p>
2484
2485
2486 <p>Previously, subclasses were invited to provide an implementation of this to process validations - from 3.2
2487 onwards <a href="Ext.form.field.Text.html#getErrors" rel="Ext.form.field.Text#getErrors" class="docClass">getErrors</a> should be overridden instead.</p>
2488
2489 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value</span> : Mixed<div class="sub-desc"><p>The value to validate</p>
2490 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Boolean</span>&nbsp; &nbsp;<p>True if all validations passed, false if one or more failed</p>
2491 </li></ul></div></div></div><div id="method-valueToRaw" class="member inherited"><a href="Ext.form.field.Text.html#method-valueToRaw" rel="method-valueToRaw" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-method-valueToRaw" class="viewSource">view source</a></div><a name="valueToRaw"></a><a name="method-valueToRaw"></a><a href="Ext.form.field.Text.html#" rel="method-valueToRaw" class="cls expand">valueToRaw</a>(
2492 <span class="pre">Mixed value</span>)
2493  : Mixed</div><div class="description"><div class="short">Converts a mixed-type value to a raw representation suitable for displaying in the field. This allows
2494 controlling how...</div><div class="long"><p>Converts a mixed-type value to a raw representation suitable for displaying in the field. This allows
2495 controlling how value objects passed to <a href="Ext.form.field.Text.html#setValue" rel="Ext.form.field.Text#setValue" class="docClass">setValue</a> are shown to the user, including localization.
2496 For instance, for a <a href="Ext.form.field.Date.html" rel="Ext.form.field.Date" class="docClass">Ext.form.field.Date</a>, this would control how a Date object passed to <a href="Ext.form.field.Text.html#setValue" rel="Ext.form.field.Text#setValue" class="docClass">setValue</a>
2497 would be converted to a String for display in the field.</p>
2498
2499
2500 <p>See <a href="Ext.form.field.Text.html#rawToValue" rel="Ext.form.field.Text#rawToValue" class="docClass">rawToValue</a> for the opposite conversion.</p>
2501
2502
2503 <p>The base implementation simply does a standard toString conversion, and converts
2504 <a href="Ext.html#isEmpty" rel="Ext#isEmpty" class="docClass">empty values</a> to an empty string.</p>
2505
2506 <h3 class="pa">Parameters</h3><ul><li><span class="pre">value</span> : Mixed<div class="sub-desc"><p>The mixed-type value to convert to the raw representation.</p>
2507 </div></li></ul><h3 class="pa">Returns</h3><ul><li><span class="pre">Mixed</span>&nbsp; &nbsp;<p>The converted raw value.</p>
2508 </li></ul></div></div></div></div><div class="m-events"><a name="events"></a><div class="definedBy">Defined By</div><h3 class="evt p">Events</h3><div id="event-activate" class="member f inherited"><a href="Ext.form.field.Text.html#event-activate" rel="event-activate" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-activate" class="viewSource">view source</a></div><a name="activate"></a><a name="event-activate"></a><a href="Ext.form.field.Text.html#" rel="event-activate" class="cls expand">activate</a>(
2509 <span class="pre">Ext.Component this</span>)
2510 </div><div class="description"><div class="short"><p>Fires after a Component has been visually activated.</p>
2511 </div><div class="long"><p>Fires after a Component has been visually activated.</p>
2512 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2513 </div></li></ul></div></div></div><div id="event-added" class="member inherited"><a href="Ext.form.field.Text.html#event-added" rel="event-added" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-added" class="viewSource">view source</a></div><a name="added"></a><a name="event-added"></a><a href="Ext.form.field.Text.html#" rel="event-added" class="cls expand">added</a>(
2514 <span class="pre">Ext.Component this, Ext.container.Container container, Number pos</span>)
2515 </div><div class="description"><div class="short"><p>Fires after a Component had been added to a Container.</p>
2516 </div><div class="long"><p>Fires after a Component had been added to a Container.</p>
2517 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2518 </div></li><li><span class="pre">container</span> : Ext.container.Container<div class="sub-desc"><p>Parent Container</p>
2519 </div></li><li><span class="pre">pos</span> : Number<div class="sub-desc"><p>position of Component</p>
2520 </div></li></ul></div></div></div><div id="event-afterrender" class="member inherited"><a href="Ext.form.field.Text.html#event-afterrender" rel="event-afterrender" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-afterrender" class="viewSource">view source</a></div><a name="afterrender"></a><a name="event-afterrender"></a><a href="Ext.form.field.Text.html#" rel="event-afterrender" class="cls expand">afterrender</a>(
2521 <span class="pre">Ext.Component this</span>)
2522 </div><div class="description"><div class="short">Fires after the component rendering is finished.
2523
2524
2525 The afterrender event is fired after this Component has been rende...</div><div class="long"><p>Fires after the component rendering is finished.</p>
2526
2527
2528 <p>The afterrender event is fired after this Component has been <a href="Ext.form.field.Text.html#rendered" rel="Ext.form.field.Text#rendered" class="docClass">rendered</a>, been postprocesed
2529 by any afterRender method defined for the Component.</p>
2530
2531 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2532 </div></li></ul></div></div></div><div id="event-autosize" class="member ni"><a href="Ext.form.field.Text.html#event-autosize" rel="event-autosize" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-event-autosize" class="viewSource">view source</a></div><a name="autosize"></a><a name="event-autosize"></a><a href="Ext.form.field.Text.html#" rel="event-autosize" class="cls expand">autosize</a>(
2533 <span class="pre">Ext.form.field.Text this, Number width</span>)
2534 </div><div class="description"><div class="short">Fires when the autoSize function is triggered and the field is
2535 resized according to the grow/growMin/growMax configs ...</div><div class="long"><p>Fires when the <tt><b><a href="Ext.form.field.Text.html#autoSize" rel="Ext.form.field.Text#autoSize" class="docClass">autoSize</a></b></tt> function is triggered and the field is
2536 resized according to the <a href="Ext.form.field.Text.html#grow" rel="Ext.form.field.Text#grow" class="docClass">grow</a>/<a href="Ext.form.field.Text.html#growMin" rel="Ext.form.field.Text#growMin" class="docClass">growMin</a>/<a href="Ext.form.field.Text.html#growMax" rel="Ext.form.field.Text#growMax" class="docClass">growMax</a> configs as a result.
2537 This event provides a hook for the developer to apply additional logic at runtime to resize the
2538 field if needed.</p>
2539 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Text<div class="sub-desc"><p>This text field</p>
2540 </div></li><li><span class="pre">width</span> : Number<div class="sub-desc"><p>The new field width</p>
2541 </div></li></ul></div></div></div><div id="event-beforeactivate" class="member inherited"><a href="Ext.form.field.Text.html#event-beforeactivate" rel="event-beforeactivate" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-beforeactivate" class="viewSource">view source</a></div><a name="beforeactivate"></a><a name="event-beforeactivate"></a><a href="Ext.form.field.Text.html#" rel="event-beforeactivate" class="cls expand">beforeactivate</a>(
2542 <span class="pre">Ext.Component this</span>)
2543 </div><div class="description"><div class="short">Fires before a Component has been visually activated.
2544 Returning false from an event listener can prevent the activate...</div><div class="long"><p>Fires before a Component has been visually activated.
2545 Returning false from an event listener can prevent the activate
2546 from occurring.</p>
2547 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2548 </div></li></ul></div></div></div><div id="event-beforedeactivate" class="member inherited"><a href="Ext.form.field.Text.html#event-beforedeactivate" rel="event-beforedeactivate" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-beforedeactivate" class="viewSource">view source</a></div><a name="beforedeactivate"></a><a name="event-beforedeactivate"></a><a href="Ext.form.field.Text.html#" rel="event-beforedeactivate" class="cls expand">beforedeactivate</a>(
2549 <span class="pre">Ext.Component this</span>)
2550 </div><div class="description"><div class="short">Fires before a Component has been visually deactivated.
2551 Returning false from an event listener can prevent the deacti...</div><div class="long"><p>Fires before a Component has been visually deactivated.
2552 Returning false from an event listener can prevent the deactivate
2553 from occurring.</p>
2554 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2555 </div></li></ul></div></div></div><div id="event-beforedestroy" class="member inherited"><a href="Ext.form.field.Text.html#event-beforedestroy" rel="event-beforedestroy" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-beforedestroy" class="viewSource">view source</a></div><a name="beforedestroy"></a><a name="event-beforedestroy"></a><a href="Ext.form.field.Text.html#" rel="event-beforedestroy" class="cls expand">beforedestroy</a>(
2556 <span class="pre">Ext.Component this</span>)
2557 </div><div class="description"><div class="short"><p>Fires before the component is <a href="Ext.form.field.Text.html#destroy" rel="Ext.form.field.Text#destroy" class="docClass">destroy</a>ed. Return false from an event handler to stop the <a href="Ext.form.field.Text.html#destroy" rel="Ext.form.field.Text#destroy" class="docClass">destroy</a>.</p>
2558 </div><div class="long"><p>Fires before the component is <a href="Ext.form.field.Text.html#destroy" rel="Ext.form.field.Text#destroy" class="docClass">destroy</a>ed. Return false from an event handler to stop the <a href="Ext.form.field.Text.html#destroy" rel="Ext.form.field.Text#destroy" class="docClass">destroy</a>.</p>
2559 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2560 </div></li></ul></div></div></div><div id="event-beforehide" class="member inherited"><a href="Ext.form.field.Text.html#event-beforehide" rel="event-beforehide" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-beforehide" class="viewSource">view source</a></div><a name="beforehide"></a><a name="event-beforehide"></a><a href="Ext.form.field.Text.html#" rel="event-beforehide" class="cls expand">beforehide</a>(
2561 <span class="pre">Ext.Component this</span>)
2562 </div><div class="description"><div class="short"><p>Fires before the component is hidden when calling the <a href="Ext.form.field.Text.html#hide" rel="Ext.form.field.Text#hide" class="docClass">hide</a> method.
2563 Return false from an event handler to stop the hide.</p>
2564 </div><div class="long"><p>Fires before the component is hidden when calling the <a href="Ext.form.field.Text.html#hide" rel="Ext.form.field.Text#hide" class="docClass">hide</a> method.
2565 Return false from an event handler to stop the hide.</p>
2566 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2567 </div></li></ul></div></div></div><div id="event-beforerender" class="member inherited"><a href="Ext.form.field.Text.html#event-beforerender" rel="event-beforerender" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-beforerender" class="viewSource">view source</a></div><a name="beforerender"></a><a name="event-beforerender"></a><a href="Ext.form.field.Text.html#" rel="event-beforerender" class="cls expand">beforerender</a>(
2568 <span class="pre">Ext.Component this</span>)
2569 </div><div class="description"><div class="short"><p>Fires before the component is <a href="Ext.form.field.Text.html#rendered" rel="Ext.form.field.Text#rendered" class="docClass">rendered</a>. Return false from an
2570 event handler to stop the <a href="Ext.form.field.Text.html#render" rel="Ext.form.field.Text#render" class="docClass">render</a>.</p>
2571 </div><div class="long"><p>Fires before the component is <a href="Ext.form.field.Text.html#rendered" rel="Ext.form.field.Text#rendered" class="docClass">rendered</a>. Return false from an
2572 event handler to stop the <a href="Ext.form.field.Text.html#render" rel="Ext.form.field.Text#render" class="docClass">render</a>.</p>
2573 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2574 </div></li></ul></div></div></div><div id="event-beforeshow" class="member inherited"><a href="Ext.form.field.Text.html#event-beforeshow" rel="event-beforeshow" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-beforeshow" class="viewSource">view source</a></div><a name="beforeshow"></a><a name="event-beforeshow"></a><a href="Ext.form.field.Text.html#" rel="event-beforeshow" class="cls expand">beforeshow</a>(
2575 <span class="pre">Ext.Component this</span>)
2576 </div><div class="description"><div class="short"><p>Fires before the component is shown when calling the <a href="Ext.form.field.Text.html#show" rel="Ext.form.field.Text#show" class="docClass">show</a> method.
2577 Return false from an event handler to stop the show.</p>
2578 </div><div class="long"><p>Fires before the component is shown when calling the <a href="Ext.form.field.Text.html#show" rel="Ext.form.field.Text#show" class="docClass">show</a> method.
2579 Return false from an event handler to stop the show.</p>
2580 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2581 </div></li></ul></div></div></div><div id="event-beforestaterestore" class="member inherited"><a href="Ext.form.field.Text.html#event-beforestaterestore" rel="event-beforestaterestore" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-event-beforestaterestore" class="viewSource">view source</a></div><a name="beforestaterestore"></a><a name="event-beforestaterestore"></a><a href="Ext.form.field.Text.html#" rel="event-beforestaterestore" class="cls expand">beforestaterestore</a>(
2582 <span class="pre">Ext.state.Stateful this, Object state</span>)
2583 </div><div class="description"><div class="short"><p>Fires before the state of the object is restored. Return false from an event handler to stop the restore.</p>
2584 </div><div class="long"><p>Fires before the state of the object is restored. Return false from an event handler to stop the restore.</p>
2585 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.state.Stateful<div class="sub-desc">
2586 </div></li><li><span class="pre">state</span> : Object<div class="sub-desc"><p>The hash of state values returned from the StateProvider. If this
2587 event is not vetoed, then the state object is passed to <b><tt>applyState</tt></b>. By default,
2588 that simply copies property values into this object. The method maybe overriden to
2589 provide custom state restoration.</p>
2590 </div></li></ul></div></div></div><div id="event-beforestatesave" class="member inherited"><a href="Ext.form.field.Text.html#event-beforestatesave" rel="event-beforestatesave" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-event-beforestatesave" class="viewSource">view source</a></div><a name="beforestatesave"></a><a name="event-beforestatesave"></a><a href="Ext.form.field.Text.html#" rel="event-beforestatesave" class="cls expand">beforestatesave</a>(
2591 <span class="pre">Ext.state.Stateful this, Object state</span>)
2592 </div><div class="description"><div class="short"><p>Fires before the state of the object is saved to the configured state provider. Return false to stop the save.</p>
2593 </div><div class="long"><p>Fires before the state of the object is saved to the configured state provider. Return false to stop the save.</p>
2594 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.state.Stateful<div class="sub-desc">
2595 </div></li><li><span class="pre">state</span> : Object<div class="sub-desc"><p>The hash of state values. This is determined by calling
2596 <b><tt>getState()</tt></b> on the object. This method must be provided by the
2597 developer to return whetever representation of state is required, by default, <a href="Ext.state.Stateful.html" rel="Ext.state.Stateful" class="docClass">Ext.state.Stateful</a>
2598 has a null implementation.</p>
2599 </div></li></ul></div></div></div><div id="event-blur" class="member inherited"><a href="Ext.form.field.Text.html#event-blur" rel="event-blur" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-event-blur" class="viewSource">view source</a></div><a name="blur"></a><a name="event-blur"></a><a href="Ext.form.field.Text.html#" rel="event-blur" class="cls expand">blur</a>(
2600 <span class="pre">Ext.form.field.Base this</span>)
2601 </div><div class="description"><div class="short"><p>Fires when this field loses input focus.</p>
2602 </div><div class="long"><p>Fires when this field loses input focus.</p>
2603 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Base<div class="sub-desc">
2604 </div></li></ul></div></div></div><div id="event-change" class="member inherited"><a href="Ext.form.field.Text.html#event-change" rel="event-change" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-event-change" class="viewSource">view source</a></div><a name="change"></a><a name="event-change"></a><a href="Ext.form.field.Text.html#" rel="event-change" class="cls expand">change</a>(
2605 <span class="pre">Ext.form.field.Field this, Mixed newValue, Mixed oldValue</span>)
2606 </div><div class="description"><div class="short"><p>Fires when a user-initiated change is detected in the value of the field.</p>
2607 </div><div class="long"><p>Fires when a user-initiated change is detected in the value of the field.</p>
2608 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Field<div class="sub-desc">
2609 </div></li><li><span class="pre">newValue</span> : Mixed<div class="sub-desc"><p>The new value</p>
2610 </div></li><li><span class="pre">oldValue</span> : Mixed<div class="sub-desc"><p>The original value</p>
2611 </div></li></ul></div></div></div><div id="event-deactivate" class="member inherited"><a href="Ext.form.field.Text.html#event-deactivate" rel="event-deactivate" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-deactivate" class="viewSource">view source</a></div><a name="deactivate"></a><a name="event-deactivate"></a><a href="Ext.form.field.Text.html#" rel="event-deactivate" class="cls expand">deactivate</a>(
2612 <span class="pre">Ext.Component this</span>)
2613 </div><div class="description"><div class="short"><p>Fires after a Component has been visually deactivated.</p>
2614 </div><div class="long"><p>Fires after a Component has been visually deactivated.</p>
2615 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2616 </div></li></ul></div></div></div><div id="event-destroy" class="member inherited"><a href="Ext.form.field.Text.html#event-destroy" rel="event-destroy" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-destroy" class="viewSource">view source</a></div><a name="destroy"></a><a name="event-destroy"></a><a href="Ext.form.field.Text.html#" rel="event-destroy" class="cls expand">destroy</a>(
2617 <span class="pre">Ext.Component this</span>)
2618 </div><div class="description"><div class="short"><p>Fires after the component is <a href="Ext.form.field.Text.html#destroy" rel="Ext.form.field.Text#destroy" class="docClass">destroy</a>ed.</p>
2619 </div><div class="long"><p>Fires after the component is <a href="Ext.form.field.Text.html#destroy" rel="Ext.form.field.Text#destroy" class="docClass">destroy</a>ed.</p>
2620 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2621 </div></li></ul></div></div></div><div id="event-dirtychange" class="member inherited"><a href="Ext.form.field.Text.html#event-dirtychange" rel="event-dirtychange" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-event-dirtychange" class="viewSource">view source</a></div><a name="dirtychange"></a><a name="event-dirtychange"></a><a href="Ext.form.field.Text.html#" rel="event-dirtychange" class="cls expand">dirtychange</a>(
2622 <span class="pre">Ext.form.field.Field this, Boolean isDirty</span>)
2623 </div><div class="description"><div class="short"><p>Fires when a change in the field's <a href="Ext.form.field.Text.html#isDirty" rel="Ext.form.field.Text#isDirty" class="docClass">isDirty</a> state is detected.</p>
2624 </div><div class="long"><p>Fires when a change in the field's <a href="Ext.form.field.Text.html#isDirty" rel="Ext.form.field.Text#isDirty" class="docClass">isDirty</a> state is detected.</p>
2625 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Field<div class="sub-desc">
2626 </div></li><li><span class="pre">isDirty</span> : Boolean<div class="sub-desc"><p>Whether or not the field is now dirty</p>
2627 </div></li></ul></div></div></div><div id="event-disable" class="member inherited"><a href="Ext.form.field.Text.html#event-disable" rel="event-disable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-disable" class="viewSource">view source</a></div><a name="disable"></a><a name="event-disable"></a><a href="Ext.form.field.Text.html#" rel="event-disable" class="cls expand">disable</a>(
2628 <span class="pre">Ext.Component this</span>)
2629 </div><div class="description"><div class="short"><p>Fires after the component is disabled.</p>
2630 </div><div class="long"><p>Fires after the component is disabled.</p>
2631 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2632 </div></li></ul></div></div></div><div id="event-enable" class="member inherited"><a href="Ext.form.field.Text.html#event-enable" rel="event-enable" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-enable" class="viewSource">view source</a></div><a name="enable"></a><a name="event-enable"></a><a href="Ext.form.field.Text.html#" rel="event-enable" class="cls expand">enable</a>(
2633 <span class="pre">Ext.Component this</span>)
2634 </div><div class="description"><div class="short"><p>Fires after the component is enabled.</p>
2635 </div><div class="long"><p>Fires after the component is enabled.</p>
2636 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2637 </div></li></ul></div></div></div><div id="event-errorchange" class="member inherited"><a href="Ext.form.field.Text.html#event-errorchange" rel="event-errorchange" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.Labelable.html" class="definedIn docClass">Ext.form.Labelable</a><br/><a href="../source/Labelable.html#Ext-form.Labelable-event-errorchange" class="viewSource">view source</a></div><a name="errorchange"></a><a name="event-errorchange"></a><a href="Ext.form.field.Text.html#" rel="event-errorchange" class="cls expand">errorchange</a>(
2638 <span class="pre">Ext.form.Labelable this, String error</span>)
2639 </div><div class="description"><div class="short"><p>Fires when the active error message is changed via <a href="Ext.form.field.Text.html#setActiveError" rel="Ext.form.field.Text#setActiveError" class="docClass">setActiveError</a>.</p>
2640 </div><div class="long"><p>Fires when the active error message is changed via <a href="Ext.form.field.Text.html#setActiveError" rel="Ext.form.field.Text#setActiveError" class="docClass">setActiveError</a>.</p>
2641 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.Labelable<div class="sub-desc">
2642 </div></li><li><span class="pre">error</span> : String<div class="sub-desc"><p>The active error message</p>
2643 </div></li></ul></div></div></div><div id="event-focus" class="member inherited"><a href="Ext.form.field.Text.html#event-focus" rel="event-focus" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-event-focus" class="viewSource">view source</a></div><a name="focus"></a><a name="event-focus"></a><a href="Ext.form.field.Text.html#" rel="event-focus" class="cls expand">focus</a>(
2644 <span class="pre">Ext.form.field.Base this</span>)
2645 </div><div class="description"><div class="short"><p>Fires when this field receives input focus.</p>
2646 </div><div class="long"><p>Fires when this field receives input focus.</p>
2647 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Base<div class="sub-desc">
2648 </div></li></ul></div></div></div><div id="event-hide" class="member inherited"><a href="Ext.form.field.Text.html#event-hide" rel="event-hide" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-hide" class="viewSource">view source</a></div><a name="hide"></a><a name="event-hide"></a><a href="Ext.form.field.Text.html#" rel="event-hide" class="cls expand">hide</a>(
2649 <span class="pre">Ext.Component this</span>)
2650 </div><div class="description"><div class="short"><p>Fires after the component is hidden.
2651 Fires after the component is hidden when calling the <a href="Ext.form.field.Text.html#hide" rel="Ext.form.field.Text#hide" class="docClass">hide</a> method.</p>
2652 </div><div class="long"><p>Fires after the component is hidden.
2653 Fires after the component is hidden when calling the <a href="Ext.form.field.Text.html#hide" rel="Ext.form.field.Text#hide" class="docClass">hide</a> method.</p>
2654 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2655 </div></li></ul></div></div></div><div id="event-keydown" class="member ni"><a href="Ext.form.field.Text.html#event-keydown" rel="event-keydown" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-event-keydown" class="viewSource">view source</a></div><a name="keydown"></a><a name="event-keydown"></a><a href="Ext.form.field.Text.html#" rel="event-keydown" class="cls expand">keydown</a>(
2656 <span class="pre">Ext.form.field.Text this, Ext.EventObject e</span>)
2657 </div><div class="description"><div class="short"><p>Keydown input field event. This event only fires if <tt><b><a href="Ext.form.field.Text.html#enableKeyEvents" rel="Ext.form.field.Text#enableKeyEvents" class="docClass">enableKeyEvents</a></b></tt>
2658 is set to true.</p>
2659 </div><div class="long"><p>Keydown input field event. This event only fires if <tt><b><a href="Ext.form.field.Text.html#enableKeyEvents" rel="Ext.form.field.Text#enableKeyEvents" class="docClass">enableKeyEvents</a></b></tt>
2660 is set to true.</p>
2661 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Text<div class="sub-desc"><p>This text field</p>
2662 </div></li><li><span class="pre">e</span> : Ext.EventObject<div class="sub-desc">
2663 </div></li></ul></div></div></div><div id="event-keypress" class="member ni"><a href="Ext.form.field.Text.html#event-keypress" rel="event-keypress" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-event-keypress" class="viewSource">view source</a></div><a name="keypress"></a><a name="event-keypress"></a><a href="Ext.form.field.Text.html#" rel="event-keypress" class="cls expand">keypress</a>(
2664 <span class="pre">Ext.form.field.Text this, Ext.EventObject e</span>)
2665 </div><div class="description"><div class="short"><p>Keypress input field event. This event only fires if <tt><b><a href="Ext.form.field.Text.html#enableKeyEvents" rel="Ext.form.field.Text#enableKeyEvents" class="docClass">enableKeyEvents</a></b></tt>
2666 is set to true.</p>
2667 </div><div class="long"><p>Keypress input field event. This event only fires if <tt><b><a href="Ext.form.field.Text.html#enableKeyEvents" rel="Ext.form.field.Text#enableKeyEvents" class="docClass">enableKeyEvents</a></b></tt>
2668 is set to true.</p>
2669 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Text<div class="sub-desc"><p>This text field</p>
2670 </div></li><li><span class="pre">e</span> : Ext.EventObject<div class="sub-desc">
2671 </div></li></ul></div></div></div><div id="event-keyup" class="member ni"><a href="Ext.form.field.Text.html#event-keyup" rel="event-keyup" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Text.html" class="definedIn docClass">Ext.form.field.Text</a><br/><a href="../source/Text.html#Ext-form.field.Text-event-keyup" class="viewSource">view source</a></div><a name="keyup"></a><a name="event-keyup"></a><a href="Ext.form.field.Text.html#" rel="event-keyup" class="cls expand">keyup</a>(
2672 <span class="pre">Ext.form.field.Text this, Ext.EventObject e</span>)
2673 </div><div class="description"><div class="short"><p>Keyup input field event. This event only fires if <tt><b><a href="Ext.form.field.Text.html#enableKeyEvents" rel="Ext.form.field.Text#enableKeyEvents" class="docClass">enableKeyEvents</a></b></tt>
2674 is set to true.</p>
2675 </div><div class="long"><p>Keyup input field event. This event only fires if <tt><b><a href="Ext.form.field.Text.html#enableKeyEvents" rel="Ext.form.field.Text#enableKeyEvents" class="docClass">enableKeyEvents</a></b></tt>
2676 is set to true.</p>
2677 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Text<div class="sub-desc"><p>This text field</p>
2678 </div></li><li><span class="pre">e</span> : Ext.EventObject<div class="sub-desc">
2679 </div></li></ul></div></div></div><div id="event-move" class="member inherited"><a href="Ext.form.field.Text.html#event-move" rel="event-move" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-move" class="viewSource">view source</a></div><a name="move"></a><a name="event-move"></a><a href="Ext.form.field.Text.html#" rel="event-move" class="cls expand">move</a>(
2680 <span class="pre">Ext.Component this, Number x, Number y</span>)
2681 </div><div class="description"><div class="short"><p>Fires after the component is moved.</p>
2682 </div><div class="long"><p>Fires after the component is moved.</p>
2683 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2684 </div></li><li><span class="pre">x</span> : Number<div class="sub-desc"><p>The new x position</p>
2685 </div></li><li><span class="pre">y</span> : Number<div class="sub-desc"><p>The new y position</p>
2686 </div></li></ul></div></div></div><div id="event-removed" class="member inherited"><a href="Ext.form.field.Text.html#event-removed" rel="event-removed" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-removed" class="viewSource">view source</a></div><a name="removed"></a><a name="event-removed"></a><a href="Ext.form.field.Text.html#" rel="event-removed" class="cls expand">removed</a>(
2687 <span class="pre">Ext.Component this, Ext.container.Container ownerCt</span>)
2688 </div><div class="description"><div class="short"><p>Fires when a component is removed from an Ext.container.Container</p>
2689 </div><div class="long"><p>Fires when a component is removed from an Ext.container.Container</p>
2690 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2691 </div></li><li><span class="pre">ownerCt</span> : Ext.container.Container<div class="sub-desc"><p>Container which holds the component</p>
2692 </div></li></ul></div></div></div><div id="event-render" class="member inherited"><a href="Ext.form.field.Text.html#event-render" rel="event-render" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-render" class="viewSource">view source</a></div><a name="render"></a><a name="event-render"></a><a href="Ext.form.field.Text.html#" rel="event-render" class="cls expand">render</a>(
2693 <span class="pre">Ext.Component this</span>)
2694 </div><div class="description"><div class="short"><p>Fires after the component markup is <a href="Ext.form.field.Text.html#rendered" rel="Ext.form.field.Text#rendered" class="docClass">rendered</a>.</p>
2695 </div><div class="long"><p>Fires after the component markup is <a href="Ext.form.field.Text.html#rendered" rel="Ext.form.field.Text#rendered" class="docClass">rendered</a>.</p>
2696 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2697 </div></li></ul></div></div></div><div id="event-resize" class="member inherited"><a href="Ext.form.field.Text.html#event-resize" rel="event-resize" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-resize" class="viewSource">view source</a></div><a name="resize"></a><a name="event-resize"></a><a href="Ext.form.field.Text.html#" rel="event-resize" class="cls expand">resize</a>(
2698 <span class="pre">Ext.Component this, Number adjWidth, Number adjHeight</span>)
2699 </div><div class="description"><div class="short"><p>Fires after the component is resized.</p>
2700 </div><div class="long"><p>Fires after the component is resized.</p>
2701 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2702 </div></li><li><span class="pre">adjWidth</span> : Number<div class="sub-desc"><p>The box-adjusted width that was set</p>
2703 </div></li><li><span class="pre">adjHeight</span> : Number<div class="sub-desc"><p>The box-adjusted height that was set</p>
2704 </div></li></ul></div></div></div><div id="event-show" class="member inherited"><a href="Ext.form.field.Text.html#event-show" rel="event-show" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.AbstractComponent.html" class="definedIn docClass">Ext.AbstractComponent</a><br/><a href="../source/AbstractComponent.html#Ext-AbstractComponent-event-show" class="viewSource">view source</a></div><a name="show"></a><a name="event-show"></a><a href="Ext.form.field.Text.html#" rel="event-show" class="cls expand">show</a>(
2705 <span class="pre">Ext.Component this</span>)
2706 </div><div class="description"><div class="short"><p>Fires after the component is shown when calling the <a href="Ext.form.field.Text.html#show" rel="Ext.form.field.Text#show" class="docClass">show</a> method.</p>
2707 </div><div class="long"><p>Fires after the component is shown when calling the <a href="Ext.form.field.Text.html#show" rel="Ext.form.field.Text#show" class="docClass">show</a> method.</p>
2708 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.Component<div class="sub-desc">
2709 </div></li></ul></div></div></div><div id="event-specialkey" class="member inherited"><a href="Ext.form.field.Text.html#event-specialkey" rel="event-specialkey" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Base.html" class="definedIn docClass">Ext.form.field.Base</a><br/><a href="../source/Base.html#Ext-form.field.Base-event-specialkey" class="viewSource">view source</a></div><a name="specialkey"></a><a name="event-specialkey"></a><a href="Ext.form.field.Text.html#" rel="event-specialkey" class="cls expand">specialkey</a>(
2710 <span class="pre">Ext.form.field.Base this, Ext.EventObject e</span>)
2711 </div><div class="description"><div class="short">Fires when any key related to navigation (arrows, tab, enter, esc, etc.) is pressed.
2712 To handle other keys see Ext.pan...</div><div class="long"><p>Fires when any key related to navigation (arrows, tab, enter, esc, etc.) is pressed.
2713 To handle other keys see <a href="Ext.panel.Panel.html#keys" rel="Ext.panel.Panel#keys" class="docClass">Ext.panel.Panel.keys</a> or <a href="Ext.util.KeyMap.html" rel="Ext.util.KeyMap" class="docClass">Ext.util.KeyMap</a>.
2714 You can check <a href="Ext.EventObject.html#getKey" rel="Ext.EventObject#getKey" class="docClass">Ext.EventObject.getKey</a> to determine which key was pressed.
2715 For example:</p>
2716
2717 <pre><code>var form = new Ext.form.Panel({
2718     ...
2719     items: [{
2720             fieldLabel: 'Field 1',
2721             name: 'field1',
2722             allowBlank: false
2723         },{
2724             fieldLabel: 'Field 2',
2725             name: 'field2',
2726             listeners: {
2727                 specialkey: function(field, e){
2728                     // e.HOME, e.END, e.PAGE_UP, e.PAGE_DOWN,
2729                     // e.TAB, e.ESC, arrow keys: e.LEFT, e.RIGHT, e.UP, e.DOWN
2730                     if (e.<a href="Ext.EventObject.html#getKey" rel="Ext.EventObject#getKey" class="docClass">getKey()</a> == e.ENTER) {
2731                         var form = field.up('form').getForm();
2732                         form.submit();
2733                     }
2734                 }
2735             }
2736         }
2737     ],
2738     ...
2739 });
2740 </code></pre>
2741
2742 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Base<div class="sub-desc">
2743 </div></li><li><span class="pre">e</span> : Ext.EventObject<div class="sub-desc"><p>The event object</p>
2744 </div></li></ul></div></div></div><div id="event-staterestore" class="member inherited"><a href="Ext.form.field.Text.html#event-staterestore" rel="event-staterestore" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-event-staterestore" class="viewSource">view source</a></div><a name="staterestore"></a><a name="event-staterestore"></a><a href="Ext.form.field.Text.html#" rel="event-staterestore" class="cls expand">staterestore</a>(
2745 <span class="pre">Ext.state.Stateful this, Object state</span>)
2746 </div><div class="description"><div class="short"><p>Fires after the state of the object is restored.</p>
2747 </div><div class="long"><p>Fires after the state of the object is restored.</p>
2748 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.state.Stateful<div class="sub-desc">
2749 </div></li><li><span class="pre">state</span> : Object<div class="sub-desc"><p>The hash of state values returned from the StateProvider. This is passed
2750 to <b><tt>applyState</tt></b>. By default, that simply copies property values into this
2751 object. The method maybe overriden to provide custom state restoration.</p>
2752 </div></li></ul></div></div></div><div id="event-statesave" class="member inherited"><a href="Ext.form.field.Text.html#event-statesave" rel="event-statesave" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.state.Stateful.html" class="definedIn docClass">Ext.state.Stateful</a><br/><a href="../source/Stateful.html#Ext-state.Stateful-event-statesave" class="viewSource">view source</a></div><a name="statesave"></a><a name="event-statesave"></a><a href="Ext.form.field.Text.html#" rel="event-statesave" class="cls expand">statesave</a>(
2753 <span class="pre">Ext.state.Stateful this, Object state</span>)
2754 </div><div class="description"><div class="short"><p>Fires after the state of the object is saved to the configured state provider.</p>
2755 </div><div class="long"><p>Fires after the state of the object is saved to the configured state provider.</p>
2756 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.state.Stateful<div class="sub-desc">
2757 </div></li><li><span class="pre">state</span> : Object<div class="sub-desc"><p>The hash of state values. This is determined by calling
2758 <b><tt>getState()</tt></b> on the object. This method must be provided by the
2759 developer to return whetever representation of state is required, by default, <a href="Ext.state.Stateful.html" rel="Ext.state.Stateful" class="docClass">Ext.state.Stateful</a>
2760 has a null implementation.</p>
2761 </div></li></ul></div></div></div><div id="event-validitychange" class="member inherited"><a href="Ext.form.field.Text.html#event-validitychange" rel="event-validitychange" class="expand more ar"><span>&nbsp;</span></a><div class="title"><div class="meta"><a href="Ext.form.field.Field.html" class="definedIn docClass">Ext.form.field.Field</a><br/><a href="../source/Field.html#Ext-form.field.Field-event-validitychange" class="viewSource">view source</a></div><a name="validitychange"></a><a name="event-validitychange"></a><a href="Ext.form.field.Text.html#" rel="event-validitychange" class="cls expand">validitychange</a>(
2762 <span class="pre">Ext.form.field.Field this, Boolean isValid</span>)
2763 </div><div class="description"><div class="short"><p>Fires when a change in the field's validity is detected.</p>
2764 </div><div class="long"><p>Fires when a change in the field's validity is detected.</p>
2765 <h3 class="pa">Parameters</h3><ul><li><span class="pre">this</span> : Ext.form.field.Field<div class="sub-desc">
2766 </div></li><li><span class="pre">isValid</span> : Boolean<div class="sub-desc"><p>Whether or not the field is now valid</p>
2767 </div></li></ul></div></div></div></div></div></div></div><div id="pageContent"></div></div></div></div></body></html>