PrimeFaces SelectOneListbox
It is an extended version of the standard selectOneListbox component. It is used to select one value from the list. PrimeFaces provides <p:selectOneListbox> component to create listbox. It is useful when we want to get user choice from the multiple options. It has various attributes that are tabled below.
SelectOneListbox Attributes
Attribute |
Default value |
Return type |
Description |
id |
null |
String |
It is an unique identifier of the component. |
rendered |
true |
Boolean |
It is used to render component. It takes boolean value. |
binding |
null |
object |
It is used to set an expression that maps to a server side UIComponent
instance in a backing bean
|
value |
null |
object |
It is used to set value of the component referring to a List. |
converter |
null |
Converter/String |
It is used to set text that defines a converter for
the component.
|
required |
false |
Boolean |
It is used to make component as required |
widgetVar |
null |
String |
It is a name of the client side widget. |
disabled |
false |
Boolean |
It is used to disable the component. |
label |
null |
String |
It is used to set user presentable name. |
var |
null |
String |
Name of iterator to be used in custom content
display.
|
filter |
false |
boolean |
Displays an input filter for the list. |
filterMatchMode |
null |
String |
Match mode for filtering, valid values are
startsWith (default), contains, endsWith and
custom.
|
filterFunction |
null |
String |
Client side function to use in custom
filterMatchMode.
|
caseSensitive |
false |
Boolean |
Defines if filtering would be case sensitive. |
scrollHeight |
null |
Integer |
Defines the height of the scrollable area. |
Example
Here, in the following example, we are implementing <p:selectOneListbox> component. This example contains the following files.
JSF File
// listbox.xhtml
ManagedBean
// ListBox.java
Output:
|