Setting the General Attributes for a Message Form Component
To set the general attributes for a message form component:
-
In the Design Structure Window of the desired file, select the desired
message form component node (e.g., messageTextInput).
-
In the Property Inspector, set the following general attributes for
the component:
-
accessKey - Enter the character to use for quick access to
the form element specified by the labeledNodeId, if set. If the
same access key appears in multiple locations in the same page of
output, the rendering user agent will cycle among the elements
accessed by the similar keys. The character specified by this
attribute must exist in the prompt attribute of the component. If
it does not, the user will not receive a visual indication of the
existence of the accessKey.
-
contentStyleClass - Enter the CSS style of the content area
of the messaging component. This area includes both the direct
contents and the end child.
-
disabled - Select "true" or "false" to specify whether to
disable the component or not.
-
inlineStyle - Enter the inline CSS style for this
component. In the right column, click the
icon to open a dialog, then click New to enter the
CSS property values. The property element defines a single
name/value pair. The name is defined by the Name attribute, and
the Value by the plain-text contents of the element. For example,
you can enter 'color' for Name, and 'red' for Value. 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.
-
name - Enter a unique name for the component.
-
prompt - Enter the prompt text to display for the component.
-
promptAndAccessKey - Enter the prompt text using the
ampersand ('&') notation to specify both the prompt and access
key. For example, setting this attribute to "P&rompt" will set the
prompt to "Prompt" and the access key to 'r'.
-
readOnly - Select "true" or "false" to specify whether to
render the component as read only.
-
required - Select a value to specify whether the component
requires user input. An asterisk displays before the prompt to
indicate that user input is required. Depending on the component,
these values are supported:
-
yes
- User input is required. Any attached
validater must also succeed. Visual indication is displayed
(asterisk).
-
no
- Default. User input is not required or any
attached validater must succeed.
-
uiOnly
- The user interface indicates that user
input is required (asterisk), but the constraint is not
enforced.
-
validaterOnly
- Validation success is dependent
on the validater and not whether any input has been entered.
Any attached validater must succeed.
-
vAlign - Select the vertical alignment of the prompt and
other contents. The available options are "middle", "top", and
"bottom".
Note: To use data binding, see
Data Binding a Component Attribute.
Note: When you create or edit a message form component,
the Property Inspector shows a complete list of the supported
attributes. A message form component also supports special attributes
that determine the behavior of the component. These attributes are
described in the procedural topic for the component, e.g., the
procedural topic "Inserting a MessageCheckBox" describes the special
checked attribute for a messageCheckBox component.
Related topics
About Message Form Components and
Attributes
Inserting an End Named Child for a
Message Form Component
Setting the Message Attributes for a Message Form Component
Working with Form Components
Working with Layout Components
Copyright © 1997, 2004, Oracle.
All rights reserved.