dataListbox (CAF Tags Documentation)

Description:
A list box control with content that comes from a com.webmethods.caf.faces.data.ITableContentProvider object.

Standard list-like containers are wrapped automatically as an ITableContentProvider. The following containers are wrapped automatically:
- java.lang.Object array
- java.util.List
- javax.sql.rowset.CachedRowset
Each item in the data model is mapped to a row in the list. The content of the list is rendered multiple times, once for each row displayed. The difference between the async list and a regular list is that the async list pages asynchronously. See the Async Table control (caf_h\dataAsyncTable) for more information about configuring its asynchronous properties.

Children

Any.

Component Information
Info	Value
Component Type	`com.webmethods.caf.faces.list.Listbox`
Handler Class	`com.webmethods.caf.faces.component.table.html.DataListHandler`
Renderer Type	`com.webmethods.caf.faces.list.Listbox`
Description	Displays data model as a listbox
Palette Location	`CAF Html/Control/List/Listbox`
Client-Side Model	`CAF.List.Model`

Attributes
Name	Required	Type	Description
`customRowClass`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Binding expression that specifies a custom CSS class name to add to the current row
`dir`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Specifies the directionality of the flow of the content for the current element Valid values are: LTR RTL
`disabled`	`false`	`javax.el.ValueExpression` (must evaluate to `boolean`)	True if control is grayed-out and un-modifiable If not specified, the default value is "false".
`filter`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Filter expression
`filterParamName`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Name of request parameter that specifies table's filter expression
`first`	`true`	`javax.el.ValueExpression` (must evaluate to `java.lang.Integer`)	Index of first item in model to display (zero-based) If not specified, the default value is "0".
`firstParamName`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Name of request parameter that specifies table's first row
`id`	`false`	`java.lang.String`	Control identifier
`lang`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Specifies the language of the enclosed content
`rendered`	`false`	`javax.el.ValueExpression` (must evaluate to `boolean`)	True to render control; false to ignore it If not specified, the default value is "true".
`rowClasses`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	A comma separated list of CSS classes for the table rows. The classes are used for the <tr> elements in the order they are listed, repeating the list over all rows in the table.
`rowHeight`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Row height in pixels (ex '20px') or ems (ex '2em')
`rows`	`true`	`javax.el.ValueExpression` (must evaluate to `java.lang.Integer`)	Number of rows to display per page
`rowsParamName`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Name of request parameter that specifies number of rows for the table to display
`selected`	`false`	`javax.el.ValueExpression` (must evaluate to `boolean`)	True if control is displayed as selected (use an expression to select/unselect on a per-row basis) If not specified, the default value is "false".
`selectedRowClass`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	CSS class name for selected rows
`size`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.Integer`)	Height in lines
`style`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	HTML "style" attribute value
`styleClass`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	HTML "class" attribute value Valid values are: portlet-font portlet-font-dim portlet-msg-status portlet-msg-info portlet-msg-error portlet-msg-alert portlet-msg-success portlet-section-header portlet-section-body portlet-section-alternate portlet-section-selected portlet-section-subheader portlet-section-footer portlet-section-text portlet-form-label portlet-form-input-field portlet-form-button portlet-icon-label portlet-dlg-icon-label portlet-form-field-label portlet-form-field portlet-menu portlet-menu-item portlet-menu-item-selected portlet-menu-item-hover portlet-menu-item-hover-selected portlet-menu-cascade-item portlet-menu-cascade-item-selected portlet-menu-description portlet-menu-caption [any_other_value]
`title`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	HTML "title" attribute value (often displayed as a tooltip)
`value`	`true`	`java.lang.String`	Data model
`var`	`true`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Name of variable reference to the current row object
`width`	`false`	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Pre-defined input width Valid values are: input2 input4 input6 input8 input10 input20 input30 input40 input50 input100

Listbox - caf_h:dataListbox