You see the Properties window for an Add Remove List component when you select the component on a page that you are editing in the Visual Designer.
This component has the following properties.
Type: String
id
attribute. In the page bean, this property's value is the name of the AddRemove
object. Type: String
Available
. Type: String
label
property is not as flexible as the Label component. You can use the Label component if you want more control over the label's appearance, such as positioning of the label relative to the component. Type: boolean
Type: boolean
Type: int
12
. Type: boolean
Type: String
Selected
. Type: String
position: absolute; left: 288px; top: 312px
You can enter values directly or click the ellipsis (...) button to use the Style Editor.
For a list of CSS2 style attributes, see the web page at
Type: String
style
property description for an explanation of why a class added to this property might appear to have no effect on the component. For the defaulttheme.jar
CSS style classes for this component, see Add Remove List Component CSS Classes.
Type: boolean
If selected, arranges the lists vertically, with the Available list on top, the buttons below it, and the Selected list below the buttons. By default, the layout is horizontal.
Type: Converter
selected
property. Type: boolean
Type: Object
com.sun.rave.web.ui.model.Option
objects to populate the Available list. By default, this property is associated with a com.sun.rave.web.ui.model.MultipleSelectOptionsList
object with a name similar to addRemoveList1DefaultOptions
, whose node you can see in the Navigator window. This object serves simply to populate the list with default items and is in the page bean.
Type: boolean
for
property to this component, an error message will be displayed if the user tries to submit the page without adding an item.
If you want to use a validator with this component, you must select this property to ensure that the value is run through the validator.
Type: Object
com.sun.rave.web.ui.model.Option
objects in the Available list. See the items
property for more information. Type: boolean
moveButtons
property, this property has no effect on the Selected list because the user is expected to arrange the items in that list. Type: MethodBinding
Set the event properties by right-clicking the component in the Visual Designer and choosing Edit Event Handler > eventname.
validator
property, right-click the component and choose Edit Event Handler > validate. The default name for the method is component-id_validate
, where component-id is the value of the component's id
property. When you define this method in this way, the validator
and validate
properties are automatically set for you. If you define a validator, also select the required
property to ensure that the validator is used.
validator
property. If you define your own validate method, do not separately change the value of the validator
property, or you will lose the connection to your validate method.null
. You typically define this method in the page bean by right-clicking the component in the Visual Designer and choosing Edit Event Handler > processValueChange. The default name for the method is component-id_processValueChange
, where component-id is the value of the component's id
property. Type: boolean
readOnly
property concerning the effects of using the disabled
property versus the effects of using the readOnly
property. Type: boolean
disabled
property, JavaServer Faces does not detect that any value at all was submitted. Type: String
title
attribute for the component, causing the text value of this property to display if the user hovers the mouse cursor over the component.
Type: boolean
rendered
property. Type: String
Type: boolean
The most common example of an immediate action is a Cancel button. You make it immediate so that the normal validation and update steps can be skipped, but the action handler can still do whatever is necessary. Typically, the action handler will navigate back to some previous page. In some designs the action handler might also enqueue an informational message like "Transaction cancelled". It is possible to do more: for example, an application might record the fact that the user cancelled the current operation.
Type: boolean
visible
property instead of this property.
You can bind this property to a JavaBeans property that determines when the component does get rendered. For example, an airline reservation form might show a component for frequent flyers and not show it for the general public. To bind this property, click the ellipsis button (...) to the right of the property and choose Use Binding in the dialog box.
Type: MethodBinding
valueChange
property above, which provides an easier way to set this property's value. The valueChangeListener
property is the MethodBinding
that underlies the valueChange
event property. The valueChangeListener
property is updated when you set the method for the valueChange
event property.
If you click the ellipsis button next to the valueChange
property, you can use that property's property editor to choose an existing method to bind to, or you can create a new method or unbind an existing method. If you are an expert, instead of using the valueChange
property, you can type a MethodBinding
expression directly into this valueChangeListener
property, for example, if you want to call a method that is not in the page bean.