對於使用 MyFaces 的開發者來說,有一個不錯的選擇:使用 MyFaces Sandbox 中的 InputSuggestAjax 組件,它能輕鬆實現輸入即提示的自動填充表單。以下說明其用法。
後端 Bean 只需提供一個方法,返回根據用戶輸入(keyWord)生成的建議列表即可:
package test;
import java.util.ArrayList;
import java.util.List;
public class Bean {
// 只需指定列表中要顯示的內容
// keyWord 即為用戶已輸入的文字
public List getSuggestedWords(String keyWord) {
List list = new ArrayList();
list.add(keyWord + " Ahmed Saleh");
list.add(keyWord + " Kahki");
list.add(keyWord + " Kourany");
list.add(keyWord + " Kiki");
list.add(keyWord + " Saleh Abouetta");
list.add(keyWord + " Hashim");
return list;
}
private String currentValue;
public String getCurrentValue() { return currentValue; }
public void setCurrentValue(String currentValue) {
this.currentValue = currentValue;
}
}
頁面引入 JSF 的 HTML、Core 與 MyFaces Sandbox 標籤庫,使用 <s:inputSuggestAjax> 組件,並通過 suggestedItemsMethod 綁定到後端方法:
<%@ taglib uri="https://java.sun.com/JSF/html" prefix="h" %>
<%@ taglib uri="https://java.sun.com/JSF/core" prefix="f" %>
<%@ taglib uri="https://myfaces.apache.org/sandbox" prefix="s" %>
<f:view>
<h:form>
<h:outputText value="Enter your name : "/>
<s:inputSuggestAjax suggestedItemsMethod="#{bean.getSuggestedWords}"
value="#{bean.currentValue}" />
<br />
<h:commandButton action="" value="Submit"/>
<br />
<h:outputText value="Your name is #{bean.currentValue}"/>
</h:form>
</f:view>
關鍵的一點是:要把狀態保存方式設為 client,而非默認的 server,這樣組件才能正常工作:
<context-param> <param-name>javax.faces.STATE_SAVING_METHOD</param-name> <param-value>client</param-value> </context-param>
完成以上三步,一個具備自動提示能力的輸入框便告完成,用戶在鍵入時即可看到實時匹配的建議列表。