<textarea/>


Description

The text area widget is similar to the text field widget with two important differences:

  • Although it still supports binding to basic variables or object instance attributes, only string basic types are supported. As a result  text areas do not allow for additional hints, formatting and validation using a datatype XML attribute.
  • The physical widget area is larger, it is scrollable and also allows for users to resize it by dragging the bottom right corner.

The title is specified as a key to a lang file entry and is required. A tooltip can also be specified as a key to a lang file entry but is optional. Visibility bindings are also supported.

A new addition in version 1.57.0 (specific to the new UI) is the description attribute. The description attribute works similarly to the title in that it is specified as a key to a lang file entry, however, its purpose is to allow for additional information related to an input and will appear beneath the input.


Example

The abbreviated code snippets and screenshot below shows the use of <textarea/> with a value binding to an object instance attribute.

View XML
<textarea label="textarea.farm_address">
    <binding variable="farmer">
        <attribute name="farmAddress"/>
    </binding>
</textarea>
Backing unit
Farmer farmer;
 
void init() {
	farmer = Farmer:new();
}
.
.
.
textarea.farm_address = Farm address:

<textarea> example screenshot


scrolling <textarea> screenshot

resized <textarea> screenshot




Additional Mentions and References