Class UISuggest
java.lang.Object
javax.faces.component.UIComponent
javax.faces.component.UIComponentBase
org.apache.myfaces.tobago.internal.component.AbstractUISuggest
org.apache.myfaces.tobago.component.UISuggest
- All Implemented Interfaces:
- EventListener,- javax.faces.component.behavior.ClientBehaviorHolder,- javax.faces.component.PartialStateHolder,- javax.faces.component.StateHolder,- javax.faces.component.TransientStateHolder,- javax.faces.event.ComponentSystemEventListener,- javax.faces.event.FacesListener,- javax.faces.event.SystemEventListenerHolder
Renders a list of suggested texts for a given input field.
  Basic features:
  
- provide a list directly while rendering (not AJAX needed) [todo]
- update by typing (AJAX)
- minimum number of typed characters (to avoid useless requests)
- update delay (useful for optimization)
- filter on client side (useful for optimization) [todo]
component.stg with class
 SuggestTagDeclaration.- 
Field SummaryFieldsFields inherited from class javax.faces.component.UIComponentATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptiongetDelay()Time in milliseconds before the list will be requested (by AJAX).Additional client side filtering of the result list.The maximum number of item to display in the drop-down list.Minimum number of characters to type before the list will be requested.The real size of the result list.booleanIf a suggest menu is available, it will be rendered on the component, not in the '.tobago-page-menuStore'.booleanisUpdate()Should the list be updated while typing (via AJAX).voidrestoreState(javax.faces.context.FacesContext context, Object state) voidvoidsetFilter(SuggestFilter filter) voidsetLocalMenu(boolean localMenu) voidsetMaximumItems(Integer maximumItems) voidsetMinimumCharacters(Integer minimumCharacters) voidsetTotalCount(Integer totalCount) voidsetUpdate(boolean update) Methods inherited from class org.apache.myfaces.tobago.internal.component.AbstractUISuggestgetQuery, setQueryMethods inherited from class javax.faces.component.UIComponentBaseaddClientBehavior, addFacesListener, broadcast, clearInitialState, decode, encodeAll, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getParent, getPassThroughAttributes, getRenderer, getRendererType, getRendersChildren, getValueBinding, invokeOnComponent, isRendered, isTransient, markInitialState, processDecodes, processRestoreState, processSaveState, processUpdates, processValidators, queueEvent, removeFacesListener, restoreAttachedState, saveAttachedState, saveState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding, visitTreeMethods inherited from class javax.faces.component.UIComponentgetClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getListenersForEventClass, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression, subscribeToEvent, unsubscribeFromEventMethods inherited from class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface javax.faces.component.behavior.ClientBehaviorHolderaddClientBehavior, getClientBehaviors, getDefaultEventName, getEventNames
- 
Field Details- 
COMPONENT_TYPE
- 
COMPONENT_FAMILY- See Also:
 
 
- 
- 
Constructor Details- 
UISuggestpublic UISuggest()
 
- 
- 
Method Details- 
getFamily- Overrides:
- getFamilyin class- AbstractUISuggest
 
- 
getFilterAdditional client side filtering of the result list. This is useful when sending the full list initially to the client and setting update=false.Possible values are: - all
- no filtering
- prefix
- checks if the suggested string starts with the typed text
- contains
- checks if the typed text is inside of the suggested string
 The filter will only applied on the client side and only if server updated (by AJAX) are turned off ( update=false);
 Default:contains
 Allowed Values:all,prefix,contains- Specified by:
- getFilterin class- AbstractUISuggest
 
- 
setFilter- Specified by:
- setFilterin class- AbstractUISuggest
 
- 
getDelayTime in milliseconds before the list will be requested (by AJAX).
 Default:200- Specified by:
- getDelayin class- AbstractUISuggest
 
- 
setDelay- Specified by:
- setDelayin class- AbstractUISuggest
 
- 
getMinimumCharactersMinimum number of characters to type before the list will be requested. If the value is 0, there will be sent an initial list to the client. So, if you setupdate="false" this value should be 0.
 Default:1- Specified by:
- getMinimumCharactersin class- AbstractUISuggest
 
- 
setMinimumCharacters- Specified by:
- setMinimumCharactersin class- AbstractUISuggest
 
- 
isUpdatepublic boolean isUpdate()Should the list be updated while typing (via AJAX). This is the default behavior. 
 Default:true- Specified by:
- isUpdatein class- AbstractUISuggest
 
- 
setUpdatepublic void setUpdate(boolean update) 
- 
getTotalCountThe real size of the result list. Typically, the result list will be cropped (in the backend) to save memory. This value can be set, to show the user there are more results for the given string. If the value is -1, no hint will be displayed.
 Default:-1- Specified by:
- getTotalCountin class- AbstractUISuggest
 
- 
setTotalCount
- 
isLocalMenupublic boolean isLocalMenu()If a suggest menu is available, it will be rendered on the component, not in the '.tobago-page-menuStore'. 
 Default:false- Specified by:
- isLocalMenuin class- AbstractUISuggest
 
- 
setLocalMenupublic void setLocalMenu(boolean localMenu) 
- 
getMaximumItemsThe maximum number of item to display in the drop-down list.
 Default:10- Specified by:
- getMaximumItemsin class- AbstractUISuggest
 
- 
setMaximumItems
- 
restoreState- Specified by:
- restoreStatein interface- javax.faces.component.StateHolder
- Overrides:
- restoreStatein class- javax.faces.component.UIComponentBase
 
 
-