selectInputText

The selectInputText component provides an inputText component enhanced with auto-complete functionality. As the user enters text into the component it provides a popup list of possible matching values that the user may select from. The component predicts a word or phrase that a user wants to type in without the user actually completely typing it in. The selectInputText component requires developers to implement the matching list search algorithm in their backing bean.

The selectInputText component can generate one of two types of lists:

1. A list of String data
2. A list of arbitrarily complex child components

1. String data:  To generate a list of values as Strings, the <f:selectItem> and <f:selectItems> element could be used separately or in combination as a child of selectInputText component(e.g.)

   <ice:selectInputText rows="15" width="300" valueChangeListener="#{myBean.updateList}">
      <f:selectItems value="#{myBean.list}" />
   </ice:selectInputText>
   
   

2. Child components: This mode allows the developer to add a child component as a list of values. By using a panelGroup to contain a set of components, multiple components may be used to represent each row of list data. The first child must be a facet with the name attribute set to a specific label as "selectInputText".

<ice:selectInputText listVar="city" listValue="#{myBean.list}" valueChangeListener="#{myBean.updateList}">
   <f:facet name="selectInputText">
      <h:panelGrid columns="2">
        <h:graphicImage url="images/flags/#{city.image}.gif" width="30" height="30" alt="#{city.country}"/>
        <h:outputText value="#{city.city}"/>
        <h:outputLink value="http://www.google.com/search?q=#{city.country} country">
           <h:outputText value="#{city.country}"/>
        </h:outputLink></h:panelGrid>
   </f:facet>
</ice:selectInputText>