预先输入补全组件

将此组件与 inputText 字段相连后,当用户在该字段中输入内容时,系统将构造建议内容列表并将其显示在与该字段相连的弹出列表框中。此外,当用户输入内容时,建议内容可以自动地对该字段进行补全,用户也可以使用键盘选择其他建议内容。在构建建议内容列表时,预先输入补全组件通过 AJAX 请求与服务器进行通信。因此,构建列表时,页面将保留在屏幕上,而不会进行提交/重新绘制。构建列表时,用户界面保持处于活动状态。
注: 由于 Web 浏览器的局限性,对 <h:inputText> 的预先输入支持不支持 DBCS(多字节)字符。

呈示

此组件的可视呈示根据所选组件的不同而变化。

快速编辑视图

使用“快速编辑”视图配置此组件。要打开“快速编辑”视图,请单击窗口 > 显示视图 > 快速编辑

下表列示了 <hx:inputHelperTypeahead> 组件的常用属性。

表 1. 预先输入补全组件属性

属性名称

描述

value

指定在运行时显示的组件的初始文本值。包含要显示的信息,它采用指定值或者指向动态值的指针的形式。

binding

该表达式将组件的实例(通常为用户界面组件)与 Bean 属性(通常在备份文件中)绑定。

id

对组件指定一个名称。它在 JSP 内应该是唯一名称。

inProgress

属性尚不可用。

matchWidth

如果为 true,则建议下拉菜单与输入字段一样宽。如果为 false,则其宽度由下拉菜单的 CSS 来确定。

maxSuggestions

显示的最大建议数目。

rendered

可设置为 true 或 false:
  • false - 将不会在运行时向浏览器呈示组件。
  • true - 将呈示组件。这是缺省值。

size

控件的宽度(以字符计)。可以通过 CSS 更精确地指定宽度。

startCharacters

在提出建议之前输入字段中必须具有的最小字符数。

startDelay

提出建议之前的延迟时间(以毫秒计),即,如果用户在 startDelay 毫秒内输入第二个字符,则不会对第一个字符提出建议。

styleClass

当呈示此元素时要应用的以空格分隔的 CSS 样式类列表。此值必须作为生成标记上的类属性来传递。定义所选组件的类,例如,样式表。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的类来完成。

类型

对话框的类型。模态对话框阻止使用键盘或鼠标在对话框下面的窗口中进行输入,必须填充该对话框并单击“确定”或“取消”,然后才能在页面中执行任何其他操作。非模态对话框:不是以块方式在对话框“下面”的窗口中输入。
注: 一次可能可以显示多个非模态对话框。如果同时显示了多个模态对话框,则这些对话框将叠放,只有最前面的对话框才是活动的。

oncomplete

如果请求成功,则替换面板的内容后,将执行此 JavaScript™ 函数。此函数没有任何有意义的参数。

onerror

如果提供,则当 onblur 触发且字段值验证失败时,将执行 JavaScript 函数。该函数在操作执行之前执行。如果该函数返回 false,则不运行操作并中止事件处理(如果 DOM 中止事件处理)。

onstart

当行为开始执行时,将执行此 JavaScript 函数。此函数没有任何有意义的参数。如果它返回 false,则将中止执行。此函数可以与 oncomplete 配合使用来定制执行请求过程中所显示的内容。


反馈