Text Box
The TextBox component is a sophisticated wrapper of a text box
that performs validation and formatting, as you define them. For
example, if you specify that the text entered must be a Number in
fixed-width format, the text box automatically validates and formats
user input.
Properties
name
- Description: (REQUIRED) Enter unique name of the control. Must exactly match the name of the corresponding JavaScript object on the page.
- Type: String
- Default Value: Textbox1
textBoxName
- Description: (REQUIRED) Enter unique name of TextBox form tag. Must not match the 'name' property.
- Type: String
- Default Value: TextBoxName1
formName
- Description: Enter the name of the form in which the textbox resides.
- Type: String
value
- Description: Enter the default value for the textbox.
- Type: String
size
- Description: Enter the textbox size in characters.
- Type: Number
- Default Value: 20
maxLength
- Description: Enter the textbox value max length in characters.
- Type: Number
- Default Value: 20
isPassword
- Description: Select whether to use password characters *** to protect textbox contents?
- Value Set: true | false
- Type: Boolean
- Default Value: false
format
- Description: Enter the format that should be automatically applied to textbox value.
- Value Set: none | Yes/No | True/False | Percent | Currency | Fixed
- Default Value: none
- Type: String
decPlaces
- Description: Enter the decimal places to which to round numeric type formated values.
- Type: Number
validate
- Description: Select whether validation should be performed.
- Value Set: true | false
- Type: Boolean
- Default Value: true
isRequired
- Description: Select whether this value is required.
- Value Set: true | false
- Type: Boolean
- Default Value: false
valueType
- Description: Select the value type to be used in validation
- Default Value: none
- Value Set: none | IsAlpha | IsAlphaNum | IsAlphaNumOrUnderscore | IsInt | IsNum | IsValid5DigitZip | IsValid5Plus4DigitZip | IsValidEmail | IsValidPhone | IsValidSSN
- Type: String
state
- Description: Select the textbox state.
- Value Set: editable | read-only | hidden
- Default Value: editable
- Type: String
testMode
- Description: Select the test mode.
- Value Set: off | alerts | text
- Type: String
- Default Value: off
- Is Expert: Yes
Methods
Validate Value
- Name: validateValue()
- Description: Validates textbox value.
Render
- Name: render()
- Description: Renders control.
Events
On Blur
- Name: onBlur()
- Description: Event fires on blur (or loss of focus) of value in SelectBox.
On Change
- Name: onChange()
- Description: Event fires on change of value in textbox.
On Focus
- Name: onFocus()
- Description: Event fires on focus of textbox.
On Select
- Name: onSelect()
- Description: Event fires on select of textbox.
On Validate
- Name: onValidate()
- Description: Event fires on attempt to validate textbox value.
On Invalid
- Name: onInvalid()
- Description: Event fires on faliure to validate textbox value.
On Valid
- Name: onValid()
- Description: Event fires on successful validation of textbox value.
On Render
- Name: onRender()
- Description: Event fires on render of textbox.
Other Information
Environment: Client