| |||||||
| FRAMES NO FRAMES | |||||||
The list Component is based on the standard HTML tag <SELECT>.
The list Component has the following capabilities :
| Tag Information | |
| Tag Class | org.rcfaces.core.internal.taglib.ListTag |
| TagExtraInfo Class | org.rcfaces.core.internal.taglib.CameliaTagExtraInfo |
| Body Content | JSP |
| Display Name | None |
| Attributes | ||||
| Name | Required | Request-time | Type | Description |
| id | false | true | java.lang.String | A string specifying the identifier for this component. This value must be unique within the closest parent component that is a naming container. |
| binding | false | false | javax.el.ValueExpression
(must evaluate to javax.faces.component.UIComponent)
| The value binding expression linking this component to a property in a backing bean. |
| value | false | false | javax.el.ValueExpression
(must evaluate to java.lang.Object)
| A string value holding the current value of the component. |
| rendered | false | false | javax.el.ValueExpression
(must evaluate to boolean)
| A boolean value indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. |
| converter | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| The converter id to use. as specified in faces-config.xml. |
| helpMessage | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value specifying the message to be shown by a helpMessageZone Component. |
| helpURL | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| An URL that points to a help page for the component. it is used for example by a helpButton Component. |
| toolTipText | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value specifying the tooltip for the component (shown when the pointe hover the component). |
| blurListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| Executed when the focus quits the component. A string that represent a javascript expression to evaluate and eventually a server action to execute. the two parts are separated by a semi-column. If the javascript evaluation return false (by using the return keyword) the server action is not executed. The server action is represented by a binding. |
| focusListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| Executed when the component gets the focus. A string that represent a javascript expression to evaluate and eventually a server action to execute. the two parts are separated by a semi-column. If the javascript evaluation return false (by using the return keyword) the server action is not executed. The server action is represented by a binding. |
| backgroundColor | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A color value (as specified by CSS) for the background. |
| foregroundColor | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A color value (as specified by CSS) for the text. |
| visible | false | false | javax.el.ValueExpression
(must evaluate to boolean)
| A boolean value indicating wether the composant is visible. |
| errorListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| No Description |
| disabled | false | false | javax.el.ValueExpression
(must evaluate to boolean)
| A boolean value that represents the disabled state of the component. |
| validationListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| No Description |
| fontBold | false | false | javax.el.ValueExpression
(must evaluate to java.lang.Boolean)
| A boolean value indicating the bold property for the specified font. |
| fontItalic | false | false | javax.el.ValueExpression
(must evaluate to java.lang.Boolean)
| A boolean value indicating the italic property for the specified font. |
| fontName | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value indicating the name of the font used for this component. |
| fontSize | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string indicating the size to use for the selected font. (or any other CSS accepted value for font size). values [xx-small|x-small|small|medium|large|x-large|xx-large|smaller|larger|length for example 10px|%] |
| fontUnderline | false | false | javax.el.ValueExpression
(must evaluate to java.lang.Boolean)
| A boolean value indicating the underline property for the specified font. |
| mouseOutListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| Executed when the pointer leaves the area of the component. A string that represent a javascript expression to evaluate. |
| mouseOverListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| Executed when the pointer hover the component's area. A string that represent a javascript expression to evaluate. |
| unlockedClientAttributeNames | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value holding a comma separated list of the client modifiable properties. |
| tabIndex | false | false | javax.el.ValueExpression
(must evaluate to java.lang.Integer)
| An int value specifying the position of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767. |
| propertyChangeListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| Executed when a component's property is changed (by javascript). A string that represent a javascript expression to evaluate and eventually a server action to execute. the two parts are separated by a semi-column. If the javascript evaluation return false (by using the return keyword) the server action is not executed. The server action is represented by a binding. |
| marginBottom | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value specifying the margin size for the component's bottom (compliant to CSS margin-bottom). |
| marginLeft | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value specifying the margin size for the component's left (compliant to CSS margin-left). |
| marginRight | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value specifying the margin size for the component's right (compliant to CSS margin-right). |
| marginTop | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value specifying the margin size for the component's top (compliant to CSS margin-top). |
| keyUpListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| Executed when the component detects a key up event. A string that represent a javascript expression to evaluate and eventually a server action to execute. the two parts are separated by a semi-column. If the javascript evaluation return false (by using the return keyword) the server action is not executed. The server action is represented by a binding. |
| keyDownListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| Executed when the component detects a key down event. A string that represent a javascript expression to evaluate and eventually a server action to execute. the two parts are separated by a semi-column. If the javascript evaluation return false (by using the return keyword) the server action is not executed. The server action is represented by a binding. |
| keyPressListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| Executed when the component detects a key pressed event. A string that represent a javascript expression to evaluate and eventually a server action to execute. the two parts are separated by a semi-column. If the javascript evaluation return false (by using the return keyword) the server action is not executed. The server action is represented by a binding. |
| x | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value (as specified by CSS) for the x position of the component. |
| y | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value (as specified by CSS) for the x position of the component. |
| userEventListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| Executed when the component is called. A string that represent a javascript expression to evaluate and eventually a server action to execute. the two parts are separated by a semi-column. If the javascript evaluation return false (by using the return keyword) the server action is not executed. The server action is represented by a binding. |
| styleClass | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A space-separated list of CSS style class(es) to be applied to the component. This value will be passed through as the "class" attribute on generated markup. |
| lookId | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value specifying the choosen look of the component. |
| width | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value (as specified by CSS) for the width of the component. |
| height | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value (as specified by CSS) for the height of the component. |
| textAlignment | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value specifying the alignement for the text in the component :
|
| accessKey | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string that indicates the alphanumeric key used to execute an action from the keyboard (in conjunction with a alteration key ex : Alt). |
| waiRole | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| No Description |
| initListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| Executed when the component is intialized. A string that represent a javascript expression to evaluate and eventually a server action to execute. the two parts are separated by a semi-column. If the javascript evaluation return false (by using the return keyword) the server action is not executed. The server action is represented by a binding. |
| hiddenMode | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value specifying the management of invisible state on the client. Authorized values are :
|
| valueLocked | false | false | javax.el.ValueExpression
(must evaluate to boolean)
| No Description |
| immediate | false | false | javax.el.ValueExpression
(must evaluate to boolean)
| A boolean value indicating that this component's value must be converted and validated immediately (that is, during Apply Request Values phase), rather than waiting until Process Validations phase. |
| margins | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A string value specifying the margins for the component (compliant to CSS margin). |
| selectionListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| Executed when the component is selected. A string that represent a javascript expression to evaluate and eventually a server action to execute. the two parts are separated by a semi-column. If the javascript evaluation return false (by using the return keyword) the server action is not executed. The server action is represented by a binding. |
| required | false | false | javax.el.ValueExpression
(must evaluate to boolean)
| A boolean value indicating that the user is required to provide a submitted value for this input component. |
| focusStyleClass | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A space-separated list of CSS style classes to be applied when this component get the focus. This value will be passed through as the "class" attribute on generated markup. |
| errorStyleClass | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A space-separated list of CSS style class(es) to be applied for Error Messages. This value will be passed through as the "class" attribute on generated markup. |
| fatalStyleClass | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A space-separated list of CSS style class(es) to be applied for fatal messages. This value will be passed through as the "class" attribute on generated markup. |
| infoStyleClass | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A space-separated list of CSS style class(es) to be applied for info messages. This value will be passed through as the "class" attribute on generated markup. |
| warnStyleClass | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A space-separated list of CSS style class(es) to be applied for warning messages. This value will be passed through as the "class" attribute on generated markup. |
| styleClass | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| A space-separated list of CSS style class(es) to be applied to the component. This value will be passed through as the "class" attribute on generated markup. |
| filterProperties | false | false | javax.el.ValueExpression
(must evaluate to org.rcfaces.core.model.IFilterProperties)
| A binded object that hold the filters to use on the server side. This property is often set via javascript code. |
| multipleSelect | false | false | javax.el.ValueExpression
(must evaluate to boolean)
| A boolean value indicating wether multiple selection is permitted. |
| doubleClickListener | false | false | javax.el.ValueExpression
(must evaluate to java.lang.String)
| Executed when the component is double-clicked. A string that represent a javascript expression to evaluate and eventually a server action to execute. the two parts are separated by a semi-column. If the javascript evaluation return false (by using the return keyword) the server action is not executed. The server action is represented by a binding. |
| rowNumber | false | false | javax.el.ValueExpression
(must evaluate to int)
| An int value specifying the number of rows to be displayed. |
| Variables | No Variables Defined. |
| |||||||
| FRAMES NO FRAMES | |||||||