<dsp:textarea bean="property-spec"[name="input-name"][default="value"][priority=integer-value]/>
property-specSpecifies a property value, where
property-specincludes a Nucleus path, component name, and property name. For example:param="name" beanvalue="Student_01.name"
Attributes
bean
Specifies the Nucleus path, component name, and name of the property to update from the user-entered data. If this property has data, it displays in the multi-line text box as the default value unless the default attribute specifies another value.
The property specification can also include a tag converter, such as date or null. For more information, see Tag Converters in Chapter 2.
name
Assigns a name to this text box, which enables access to it during form processing. If no name is provided, the ATG platform automatically supplies one. For all input types other than radio and checkbox, the assigned name must be unique.
default
Specifies a default value to display in the text box. The default attribute can be set to a bean property, page parameter, or constant value.
You can omit the default attribute and instead embed default text (dynamic or static) between the start and end dsp:textarea tags. If you use both methods, the text in the default attribute has precedence.
priority
Specifies the priority of this text box field during form processing, relative to other input fields. This attribute can be especially helpful when making changes to an item’s repository ID and the properties it contains. If you first update the supplemental properties and then the repository ID, the new property values can be flushed when the repository ID change occurs. By default, priority is set to –10.
For more information on how the ATG platform can prioritize tag processing, see Order of Tag Processing
Usage Notes
dsp:textarea lets you create an extended text box that for multi-line input. If you use start and end tag, they should be closely spaced together; any text between the two tags (including white space and line returns) is rendered as the text box’s default value.
This tag must be enclosed in a dsp:form tag.
Note: The dsp:textarea tag uses the iclass attribute instead of the cascading stylesheet class attribute to avoid using a Java reserved word in Java code.
Example
<dsp:textarea bean="Student_01.disciplinaryAction" default="None"/>
This tag inserts a multi-line text box on a form page. The text box displays the default value None despite the data in the disciplinaryAction property. The default value or any changes made to it are saved to the disciplinaryAction property of the Student_01 component.
