如何使用自动完成组件
通过使用自动完成组件,用户可以使用 AJAX 交互实时地执行自动完成。该组件使用受管 Bean 来配置高级属性以及检索产生的完成数据。可以使用以下声明来访问自动完成组件的标记库:
<%@taglib prefix="ui" uri="http://java.sun.com/blueprints/ui/14"%>
使用 JSF 自动完成组件的示例如下所示:
<ui:autoComplete size="40"
maxlength="100" id="cityField"
completionMethod="#{ApplicationBean.completeCity}"
value="#{SessionBean.city}" required="true" ondisplay="function(item) {
return extractCity(item); }"
onchoose="function(item) { return chooseCity(item); }"/>
JSP 标记属性
评级组件支持以下属性。
- ID - 此组件的组件标识符。该值在最近的父组件(作为命名容器)中必须是唯一的。
- accesskey - 访问键,在按下此键时可将焦点移至该元素。
- completionMethod - 方法绑定表达式,它指向接收一个 FacesContext 和一个字符串前缀的方法,并返回一个作为给定前缀完成结果的、用于显示的 String[]。
- onchoose - JavaScript 代码,为其提供一个用户选择的字符串,并且应在给定文本字段中对其进行设置。此属性是可选的;如果未设置,则在自动完成文本字段中设置文本,但是,可以使用它来执行某些更高级的操作,如将字符串拆分为子部分并在不同的文本字段中设置这些子部分。
- title - 有关为此组件生成的标记元素的建议性标题信息。
- valueChangeListener - 用于表示值更改侦听程序方法的方法绑定,将在为此输入组件设置了新值时得到通知。表达式相当于采用 ValueChangeEvent 参数的公共方法,其返回类型为 void。
- converter - 与此组件一起注册的转换器实例。
- dir - 未继承方向的文本的方向指示符。有效值为 "LTR"(从左到右)和 "RTL"(从右到左)。
- disabled - 用于指明该元素必须从未接收焦点或被包含在后续提交中的标志。
- immediate - 一个用于指明情况的标志:如果此组件是由用户激活的,则会立即将通知传送到相关的侦听程序和操作(即,在“应用请求值”阶段),而不是一直等到“调用应用程序”阶段才进行传送。
- lang - 用于描述为此组件生成的标记中使用的语言的代码。
- maxlength - 该元素失去焦点时执行的 Javascript 代码。
- onblur - 该元素失去焦点时执行的 Javascript 代码。
- onchange - 元素值自获得焦点后被修改,当该元素失去焦点时执行的 Javascript 代码。
- onclick - 单击指向该元素的按钮时执行的 Javascript 代码。
- ondblclick - 双击指向该元素的按钮时执行的 Javascript 代码。
- ondisplay - JavaScript 代码,将为其提供一个从服务器中返回的字符串项,在将该字符串置于显示给用户的完成之前,提供一次与之通信的机会。
- onfocus - 元素接收到焦点时执行的 Javascript 代码。
- onkeydown - 在该元素上按下某个键时执行的 Javascript 代码。
- onkeypress - 在该元素上释放某个键时执行的 Javascript 代码。
- onmousedown - 在该元素上发生按下操作时执行的 Javascript 代码。
- onmousemove - 将指针按钮从该元素中移开时执行的 Javascript 代码。
- onmouseover - 将指针按钮移到该元素上时执行的 Javascript 代码。
- onmouseup - 在该元素上释放指针按钮时执行的 Javascript 代码。
- onselect - 用户选中该元素中的文本时执行的 Javascript 代码。
- readonly - 用于指明禁止用户更改此组件的标志。除非元素也被禁用,否则元素可以接收焦点。
- rendered - 该标志指明是否应呈现(在“呈现响应”阶段)此组件,或在任何后续表单提交中处理此组件。
- required - 该标志指明用户必须为此输入组件提供一个用于提交的值。
- style - 呈现此组件时应用的 CSS 样式。
- styleClass - 呈现该元素时应用的以空格分隔的 CSS 样式类列表。必须将此值作为生成的标记中的 "class" 属性进行传递。
- binding - 页面 Bean 中组件的绑定。
© Sun Microsystems 2006。Java BluePrints Solutions Catalog 中的所有内容受版权保护,未经 Sun Microsystems 的明确书面许可,不得在其他产品中发布。