inputTextarea - Multiline Edit Box

Displays an input field for entering multiple lines of data.

Category

Core Controls

Syntax

<xp:inputTextarea attributes>content</xp:inputTextarea>
Table 1. Essential properties
Property Description
id Defaults to inputTextarea1, inputTextarea2, and so on.
value Binds the control to a data element or other value.
cols Specifies the number of columns if not overridden by the width attribute of style.
rows Specifies the number of rows if not overridden by the height attribute of style.
Table 2. All properties
Category Properties
accessibility accesskey, role, tabindex, title
basics attrs, binding, cols, dir, disabled, htmlFilter, htmlFilterIn, id, immediate, lang, loaded, multipleSeparator, multipleTrim, readonly, rendered, rendererType, required, rows
data converter, defaultValue, disableClientSideValidation, disableModifiedFlag, disableValidators, showReadonlyAsDisabled, validator, validators, value, valueChangeListener, valueChangeListeners
dojo dojoAttributes, dojoType
events onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup, onselect
styling disableTheme, style, styleClass, themeId

Usage

At run time, an edit box appears on the page. The user can enter multiple lines of text in the box. If the user exceeds the size of the box, scrolling devices appear.

Examples

This Multiline Edit Box control is bound to a field on a Domino® form.
<xp:inputTextarea id="inputTextarea1" value="#{document1.description}"
	cols="64" rows="8">
</xp:inputTextarea>