<textarea>

Used to accept multiple lines of text. As with all XMod tags, the <textarea> tag has a required

child tag: <label> </label> The text you place between that tag pair is the caption that

will be used to identify the textbox. See the example.

 

ATTRIBUTES:

ref

Name of the field whose value you wish to insert (Required) [String value]  

Names must begin with a letter and may only include letters, numbers and the underscore character.

class

Name of the CSS Class used to style the text box (Optional) [String value]

rows

The number of rows that should be displayed in the text box

cols

The number of columns (width) that should be displayed

style

Same as the HTML style attribute.It allows you to apply CSS styling to the element (e.g. "color: red; border: solid 1px black;")  (Optional). [String value]

readonly

If true, the contents of the control cannot be changed. If false (the default), the contents can be changed. (Optional)
(new to version 3.2)

required

If true, the user will be required to enter a value (Optional) [true or false]

errormessage

If the field is required but has not been filled out by the user, XMod will display the contents of this attribute. If this attribute isn't specified, XMod will default to "FieldName Is Required" (Optional) (new to version 3.0)

 

ADDITIONAL ATTRIBUTES (New to Version 4.0)

accesskey

In browsers that support it, this property can be set to a character on the keyboard that can be used to set focus to the control. For instance, setting the value to F allows the user to access the control by pressing Alt+F on their keyboard (for Windows machines)

backcolor

Color of the background of the control.

bordercolor

Color of the border around the control

borderstyle

Style of the border around the control.

borderwidth

Width of the border around the control specified in units

enabled

Whether the control accepts input. May not work in older browsers. Valid values are true and false. The default value is true.

Font Properties

A series of attributes such as font-bold, font-size, etc. that allow you to control how the text in the control is displayed. Click the link for more for the list of properties and their description.

forecolor

Color of the text within the control.

height

The height of the control, specified in units

tabindex

The tab order of the control.

tooltip

In those browsers that support it, this attribute specifies the text displayed in the tooltip when the mouse is over the control.

Client-Side Events

Javascript can be attached to certain events raised by this control. Click the link for more information.

CHILD TAGS

label

The caption used to identify the control

default

The value specified by this attribute will be placed into the control when the form is first loaded. This allows a form builder to pre-fill certain fields in a form to improve the user experience or give hints as to the type of data expected. (new to version 1.2)

 

EXAMPLE

<textarea ref="txtDescription" rows="8" cols="50" default="Enter your description here">

  <label>Description: </label>

  <default>Replace this text with your description...</default>

</textarea>