PrimeFaces SelectOneListbox

17 Mar 2025 | 阅读 2 分钟

它是标准 selectOneListbox 组件的扩展版本。它用于从列表中选择一个值。PrimeFaces 提供了 <p:selectOneListbox> 组件来创建列表框。当我们需要从多个选项中获取用户选择时,它非常有用。它有各种属性,如下表所示。

SelectOneListbox 属性

属性默认值返回类型描述
idnullString它是组件的唯一标识符。
renderedtrueBoolean它用于呈现组件。 它接受布尔值。
bindingnullobject它用于设置一个表达式,该表达式映射到支持 bean 中的服务器端 UIComponent 实例
nullobject它用于设置组件的值,引用列表。
转换器null转换器/字符串它用于设置定义组件转换器的文本。
必需falseBoolean用于将组件设为必需
widgetVarnullString它是客户端小部件的名称。
disabledfalseBoolean它用于禁用组件。
labelnullString它用于设置用户可呈现的名称。
varnullString在自定义内容显示中使用的迭代器名称。
filterfalseboolean显示列表的输入过滤器。
filterMatchModenullString过滤的匹配模式,有效值为 startsWith (默认)、contains、endsWith 和 custom。
filterFunctionnullString在自定义 filterMatchMode 中使用的客户端函数。
caseSensitivefalseBoolean定义过滤是否区分大小写。
scrollHeightnullInteger定义可滚动区域的高度。

示例

在这里,在下面的例子中,我们正在实现 <p:selectOneListbox> 组件。这个例子包含以下文件。

JSF 文件

// listbox.xhtml

ManagedBean

// ListBox.java

输出

PrimeFaces Selectonelistbox 1
PrimeFaces Selectonelistbox 2