changes.
| | h2. Overview |
| | | _Since 3.1_ |
| | |
| | _TextAreaEntry_ is a component for entering multi-line text. It has additional styling and functional features. Styling is controlled via the theme style sheet using predefined style classes. Additional attributes add functional features. |
| | |
| | {tip}See the ICEfaces Showcase [Live Demo|http://icefaces-showcase.icesoft.org/showcase.jsf?grp=aceMenu&exp=textAreaEntryBean] of this component, complete with source code.{tip} |
| | |
| | |
| | h2. Getting Started |
| | {panel} |
| | {code:xml|borderStyle=dashed}<ace:textAreaEntry id="firstNameInput" value="#{textAreaEntryBean.firstName}" label="First Name" labelPosition="left" required="true" requiredIndicator="(*)" indicatorPosition="right"/> |
| | {code} |
| | {panel} |
| | |
| | h2. Attributes |
| | |
| | {tip:title=TagLib Documentation}This section covers attributes involved in the typical use-cases for this component. For reference, the complete taglib documentation for this component is available [here|http://www.icefaces.org/docs/v4_latest/ace/tld/ace/textAreaEntry.html].{tip}{panel} |
| | *value* is the input text. |
| | {panel} |
| | {panel} |
| | *label* and *labelPosition* specify the label text and its position relative to the input field. Positions can be "left/right/top/bottom/inField/none". Default is "none". |
| | {panel} |
| | {panel} |
| | *required* indicates whether the user is required to provide a non-empty submitted value for this component. Default = "false". |
| | {panel} |
| | {panel} |
| | Depending on whether input is required, an *optionalIndicator* or *requiredIndicator* can be supplied. The position of the indicator is specified by *indicatorPosition*. Positions can be "left/right/top/bottom/labelLeft/labelRight/none". Default is "labelRight" if labelPosition is "inField", "right" otherwise. |
| | {panel} |
| | {panel} |
| | *rows* and *cols* specify the visible number of lines and width of the text area. |
| | {panel} |
| | {panel} |
| | Text areas can be resizable in browsers that support CSS3. Use the *resizable* attribute to control this. Default = "true". |
| | {panel} |
| | |
| | h2. Event Listeners |
| | |
| | | valueChangeListener | Listener method that will be notified when a new value has been set for this input component. | |
| | |
| | h2. Client Behavior Events |
| | |
| | | blur | Fired when the text input field loses focus (default event). | |
| | |
| | h2. JavaScript API |
| | |
| | The client side text area entry object is exposed through the global variable named by the *widgetVar* attribute, but currently there is no API useful to the user. |
| | |
| | h2. Keyboard Support |
| | |
| | h2. CSS Classes |
| | |
| | The following markup represents the basic HTML structure of the component and the CSS classes it uses. |
| | |
| | {code:xml} |
| | <span> |
| | <span class="ui-textareaentry-container"> |
| | <textarea class="ui-inputfield ui-textareaentry ui-widget ui-state-default ui-corner-all [user defined classes]" style="[user defined styles]"></textarea> |
| | </span> |
| | </span> |
| | {code} |
| | h2. Known Issues |
| | |
| | None. |
| | |
| | h2. Additional Resources |
TextAreaEntry