View Source

h2. Overview

_TextEntry_ is a component for entering single line text. It has additional styling and functional feature.


h2. Getting Started
{panel}
{code:xml|borderStyle=dashed}<ace:textEntry id="firstNameInput" value="#{textEntryBean.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/v3_latest/ace/tld/ace/TextEntry.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}

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 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. Known Issues

h2. Additional Resources