The UI language
The element ui:textarea
The element ui:textarea displays a multi-line text input box. The generated HTML code consists of a TEXTAREA element, whose name attribute is set to a special identifier which is recognized by the system when the form is submitted.
The text box must be tied to a string variable. The contents of the widget is initialized with the current contents of the variable when the page is displayed. Conversely, the contents of the widget are transferred back to the variable when the page is submitted.
Input boxes generated by ui:textarea are very similar to the boxes generated by ui:text; the only major difference is that the boxes accept multi-line texts.
<!ELEMENT ui:textarea EMPTY> <!ATTLIST ui:textarea variable NMTOKEN #REQUIRED index CDATA #IMPLIED rows CDATA #IMPLIED cols CDATA #IMPLIED wrap (off|hard|soft) "off" cgi (auto|keep) "auto" >Additionally, ui:textarea must only occur inside ui:form.
The following attributes have a special meaning:
If there are any other attributes, these are added to the generated TEXTAREA HTML element. This means that especially onblur, onchange, onfocus, and onselect may be specified.
ui:textarea has no subelements (unlike the corresponding HTML element).
Generated HTML code
The ui:textarea element generates HTML code which roughly looks as follows:
<textarea name="..." rows="..." cols="..." wrap="..."> ... </textarea>