Inserting an Option

To insert an option component:

In the Design Structure Window of the desired file, locate the node in which you wish to insert an option component (e.g., messageChoice, messageList, messageLovChoice, etc).
In the Component Palette, select Form Components from the dropdown list, and then drag and drop the option component to the parent node of your choice.
The option node is inserted and highlighted under the expanded parent node.
In the Property Inspector, set the following attributes for the option component:
- text - Enter the text to display for the item.
- selected - Default is false. Select true to specify that this item is selected. If the parent component is a choice component, then this item is displayed in the choice box when the page is first viewed in a browser. This attribute takes precedence over the selectedIndex attribute of the parent component.
- value - Enter the value that identifies this item when the parent control is submitted to the server. Note that this option will be rendered as selected if the selectedValue attribute of the parent component is equal to this value attribute
- longDesc - Enter a description associated with the item.
Repeat steps 2 and 3 to add any number of option components.

Tip: For an option to be rendered as selected, ADF UIX uses these attributes in this order of precedence: selection attribute on the option container (e.g., messageChoice), selected attribute on the option component, selectedValue attribute on the option container, selectedIndex on the option container.

Note: To use data binding, see Data Binding a Component Attribute.

Example (UIX XML)


...
<messageChoice prompt="Need-by Date"
               messageType="error"
               message="This date has passed."
               name="mcho1">
  <contents>
    <option text="10-JULY-2001" />
    <option text="10-AUG-2001" selected="true"/>
    <option text="10-SEP-2001" />
  </contents>
</messageChoice>
...
...
<messageList name="mylist"
             multiple="true"
             prompt="Choose your options:">
  <contents>
    <option text="Option1" value="value1" />
    <option text="Option2" value="value2" />
    <option text="Option3" value="value3" />
  </contents>
</messageList>
...