Inserting a MessageTextInput
To insert a messageLovInput component:
-
In the Design Structure Window of the desired file, locate the node in
which you wish to insert a messageTextInput component.
-
In the Component Palette, select Form Components
from the dropdown list, and then drag and drop the
messageTextInput component to the parent node of your choice.
The messageTextInput node is inserted
and highlighted under the expanded parent node.
-
In the Property Inspector, set the following attributes for the
messageTextInput component:
-
text - Enter the text value of the input field.
-
name - (Required) Enter a name for the component.
-
columns - Enter the number of columns to display in the
text field. Default is 30. One column is approximately one
character in the user's browser current display font.
-
prompt - Enter the prompt text that displays before the
text field.
-
rows -Enter the number of rows to display in the text
field. Default is one. If the rows attribute is less than the
maximumLength attribute, the text willl scroll.
-
enterClientAction - Enter the clientAction to fire when the
user presses the Enter key. In the right column, click the
icon to open a dialog. In the Advanced tab, you
can enter an EL syntax data binding expression or use the Bind to
Data dialog to select a data source for this complex attribute.
-
maximumLength - Enter the maximum number of characters per
line that can be entered in the text field.
-
onBlurValidater -Enter the client validater to fire on the
client when the text field loses keyboard focus. In the right
column, click the
icon to display the dialog to edit the
onBlurValidater complex attribute.
-
onSubmitValidater - Enter the client validater to fire on
the client when the form containing the text field is submitted.
In the right column, click the
icon to display the dialog to edit the
onSubmitValidater complex attribute.
-
primaryClientAction - Enter the clientAction to fire when
the text in the text field changes. In the right column, click the
icon to enter a ClientAction. See
Editing the PrimaryClientAction Attribute for details. Alternatively, use
the Advanced tab to enter an EL syntax
data binding expression or use the Bind to Data dialog to select a
data source for this complex attribute.
-
secret - Select true or false. For single line text fields
only.
-
wrap - Select the type of wrapping to be used in a
multi-row text field only. By default multi-row text does not wrap
at the edge of the column, but scrolls horizontally instead.
Available options are:
-
hard
- Specifies that the value of the text
should include any carriage returns that are needed to wrap
the lines.
-
soft
- Specifies that the text should wrap
visually but that the value of the text does not include
carriage returns.
Note: To use data binding, see
Data Binding a Component Attribute.
For information about message attributes, see
Setting the Message Attributes for a Message Form Component. For
information about other general attributes of message form components,
see Setting the General
Attributes for a Message Form Component.
Example (UIX XML)
...
<messageTextInput prompt="Enter your coupon code: "
tip="Must begin with the number zero"/>
...
Related topics
About MessageTextInput
About Message Form Components and Attributes
Inserting an End Named Child for a
Message Form Component
Working with Form Components
Copyright © 1997, 2004, Oracle.
All rights reserved.