PrimeFaces 自动完成

17 Mar 2025 | 阅读 2 分钟

它是一个输入组件,在输入时提供实时建议。

建议通过调用一个服务器端的 completeMethod 来加载,该方法接受一个字符串参数。

PrimeFaces 提供了 <p:autoComplete> 组件,用于创建一个带有建议的文本框。它包括下面表格中的各种属性。

自动完成属性

下表包含自动完成属性的属性。

属性默认值返回类型描述
idnullString它是组件的唯一标识符。
renderedtrueBoolean它返回布尔值以指定组件的渲染。
bindingnullObject它用于将 el 表达式映射到支持 bean 中的服务器端 UIComponent 实例。
nullObject它是组件的值,可以是 EL 表达式或文字文本。
转换器nullObject一个 el 表达式或文字文本,用于为该组件定义转换器。
immediatefalseBoolean当设置为 true 时,它返回布尔值,在该组件的申请请求值阶段执行验证逻辑。
必需falseBoolean它用于将组件标记为必需的。
RequiredMessagenullString它用于设置必填字段验证失败时显示的消息。
下拉falseBoolean当设置为 true 时,它启用下拉模式。
accesskeynullString它用于设置访问键,当按下该键时,焦点转移到输入元素。
自动完成nullString它执行自动完成行为。
LangnullString它用于设置为此组件生成的标记中使用的语言。
onclicknullString输入元素被单击时要执行的客户端回调。
activetrueBoolean定义是否启用自动完成功能。

示例

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

JSF 文件

// autoComplete.xhtml

ManagedBean

// AutoComplete.java

输出

Primefaces Autocomplete 1