Description

The textinput control creates a browser input text widget. Depending on the numer of rows, this control either maps to a textfield (for single row controls) or textarea (for multiple row text controls). If the input should be hidden from the user while displayed, such as for passwords, the secret property should be used.

Text will be entered in numeric format (right aligned for most locales) if a DecimalValidater is attached.

Example

Simple text input box with the some default text.

   <form name="myform" method="GET">
    <contents>
     <textInput text="Some text " name="textbtn1"/>
    </contents>
   </form>

A slightly more interesting example showing a text box twenty five characters in length with hidden input text.

   <form name="myform" method="GET">
    <contents>
     <textInput name="SecretTextVar"
                columns="25"
                required="no"
                secret="true"
                text="secret text:"/>
    </contents>
   </form>

A text input box which will display three rows of wrapped input text, with a vertical scrollbar. If the text is changed, an alert will say so.

   <form name="myform" method="GET">
    <contents>
     <textInput name="ChangeNotifiedTextBox"
                rows="3"
                wrap="soft"
                onChange="alert('ChangeNotifiedTextBox has changed.')"
                text="Alert on change."/>
    </contents>
   </form>

A text input, the contents of which will be in numeric format (right aligned for most locales). The validater ensures the contents is a number as user leaves box.

   <form name="myform" method="GET">
     <contents>
       <textInput name="numeric format" required="yes">
           <onBlurValidater>
               <decimal/>
           </onBlurValidater>
           <contents/>
       </textInput>
     </contents>
   </form>