ZK Component Reference/Input/Textbox

Textbox

• Demonstration: Textbox
• Java API: Textbox
• JavaScript API: Textbox
• Style Guide: Textbox

Employment/Purpose

A textbox is used to let users input text data.

You colud assign value, type, constraint, rows, cols to a textbox by the corresponding properties. When you assigns the property type to a string value 「password」 when multiline is false( multiline will be true if You set rows large then 1 or sets multiline to true directly) then any character in this component will replace by '*'.

You colud also assign a constraint value with a regular expression string or a default constraint expression(available value is 「no empty」). When user change the value of textbox, will cause a validating preocess to valdate the value. If valdation fail, then a notification will poped up.

Example

<textbox value="text..." />
<textbox value="secret" type="password" />
<textbox constraint="/.+@.+\.[a-z]+/: Please enter an e-mail address" />
<textbox rows="5" cols="40">
	<attribute name="value">
text line1... 
text line2...
	</attribute>
</textbox>

To specify multilines value, you can use the attribute element or 
 as shown below

<textbox rows="5" cols="40">
	<attribute name="value">
text line1... 
text line2...
	</attribute>
</textbox>
<textbox value="Line 1&#x0d;Line 2" rows="3"/>

Supported Events

Name	Event Type
None	None

• Inherited Supported Events: InputElement

Supported Children

*NONE

Use Cases

Version	Description	Example Location

Browser Limitations

Browser	description
IE	<textbox value="color" style="color:red !important;" disabled="true"/> There is no way to change the text color in a disabled input in IE.

Version History

Version	Date	Content