Properties Methods Events Config Options Direct Link
Observable
  Component
    BoxComponent
      Field
        TextField

Class Ext.form.TextField

Package:Ext.form
Defined In:TextField.js
Class:TextField
Subclasses:NumberField, TextArea, TriggerField
Extends:Field

Basic text field. Can be used as a direct replacement for traditional text inputs, or as the base class for more sophisticated input controls (like Ext.form.TextArea and Ext.form.ComboBox).

Validation

The validation procedure is described in the documentation for validateValue.

Alter Validation Behavior

Validation behavior for each field can be configured:

Config Options

Config OptionsDefined By
 allowBlank : Boolean
Specify false to validate that the value's length is > 0 (defaults to true)
TextField
 allowDomMove : Boolean
Whether the component can move the Dom node when rendering (defaults to true).
Component
 blankText : String
The error text to display if the allowBlank validation fails (defaults to 'This field is required')
TextField
 cls : String
A custom CSS class to apply to the field's underlying element (defaults to '').
Field
 data : Mixed
The initial set of data to apply to the tpl to update the content area of the Component.
Component
 disableKeyFilter : Boolean
Specify true to disable input keystroke filtering (defaults to false)
TextField
 disabledClass : String
CSS class added to the component when it is disabled (defaults to 'x-item-disabled').
Component
 enableKeyEvents : Boolean
true to enable the proxying of key events for the HTML input field (defaults to false)
TextField
 fieldClass : String
The default CSS class for the field (defaults to 'x-form-field')
Field
 focusClass : String
The CSS class to use when the field receives focus (defaults to 'x-form-focus')
Field
 grow : Boolean
true if this field should automatically grow and shrink to its content (defaults to false)
TextField
 growMax : Number
The maximum width to allow when grow = true (defaults to 800)
TextField
 growMin : Number
The minimum width to allow when grow = true (defaults to 30)
TextField
 hidden : Boolean
Render this component hidden (default is false). If true, the hide method will be called internally.
Component
 invalidClass : String
The CSS class to use when marking a field invalid (defaults to 'x-form-invalid')
Field
 maskRe : RegExp
An input mask regular expression that will be used to filter keystrokes that do not match (defaults to null)
TextField
 minLength : Number
Minimum input field length required (defaults to 0)
TextField
 msgFx : String
Experimental The effect used when displaying a validation message under the field (defaults to 'normal').
Field
 pageX : Number
The page level x coordinate for this component if contained within a positioning container.
BoxComponent
 pageY : Number
The page level y coordinate for this component if contained within a positioning container.
BoxComponent
 preventMark : Boolean
true to disable marking the field invalid. Defaults to false.
Field
 regexText : String
The error text to display if regex is used and the test fails during validation (defaults to '')
TextField
 selectOnFocus : Boolean
true to automatically select any existing field text when the field receives input focus (defaults to false)
TextField
 stripCharsRe : RegExp
A JavaScript RegExp object used to strip unwanted content from the value before validation (defaults to null).
TextField
 submitValue : Boolean
False to clear the name attribute on the field so that it is not submitted during a form post. Defaults to true.
Field
 validateOnBlur : Boolean
Whether the field should validate when it loses focus (defaults to true).
Field
 validationDelay : Number
The length of time in milliseconds after user input begins until validation is initiated (defaults to 250)
Field
 value : Mixed
A value to initialize this field with (defaults to undefined).
Field
 vtype : String
A validation type name as defined in Ext.form.VTypes (defaults to null)
TextField
 x : Number
The local x (left) coordinate for this component if contained within a positioning container.
BoxComponent
 y : Number
The local y (top) coordinate for this component if contained within a positioning container.
BoxComponent

Public Properties

PropertyDefined By
 disabled : Boolean
True if this component is disabled. Read-only.
Component
 hidden : Boolean
True if this component is hidden. Read-only.
Component
 initialConfig : Object
This Component's initial configuration specification. Read-only.
Component
 rendered : Boolean
True if this component has been rendered. Read-only.
Component

Public Methods

MethodDefined By

Public Events

EventDefined By