tc

Tag suggest

Component Information 
InfoValue
Component Typeorg.apache.myfaces.tobago.Suggest
Handler Classorg.apache.myfaces.tobago.facelets.TobagoComponentHandler
Renderer TypeSuggest
DescriptionNone
Attributes 
NameRequiredTypeDescription
bindingfalsejavax.el.ValueExpression
(must evaluate to javax.faces.component.UIComponent)
The value binding expression linking this component to a property in a backing bean. For Facelets, the component is the outer UIPanel, not the input control.
Type: javax.faces.component.UIComponent
delayfalsejavax.el.ValueExpression
(must evaluate to java.lang.Integer)
Time in milli seconds before the list will be requested (by AJAX).
Type: java.lang.Integer
Default: 200
filterfalsejavax.el.ValueExpression
(must evaluate to org.apache.myfaces.tobago.model.SuggestFilter)
TODO: not implemented yet

Additional 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);


Type: org.apache.myfaces.tobago.model.SuggestFilter
Default: SuggestFilter.ALL
Allowed Values: [all, prefix, contains]
idfalsejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
Type: java.lang.String
maximumItemsfalsejavax.el.ValueExpression
(must evaluate to java.lang.Integer)
The maximum number of item to display in the drop down list.
Type: java.lang.Integer
Default: 10
minimumCharactersfalsejavax.el.ValueExpression
(must evaluate to java.lang.Integer)
Minimum number of characters to type before the list will be requested. If the value is 0, there will be send an initial list to the client. So, if you set
update="false"
this value should be 0.
Type: java.lang.Integer
Default: 1
queryfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
The query is the string typed by the user.
Type: java.lang.String
renderedfalsejavax.el.ValueExpression
(must evaluate to java.lang.Boolean)
Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
Type: boolean
Default: true
suggestMethodfalsejava.lang.String

**** @deprecated. Will be removed in a future version ****

Please use an <tc:selectItems> tag or a list of <tc:selectItem> tags (TODO: not implemented yet).

MethodBinding which generates a list of suggested input values based on the currently entered text, which could be retrieved via getSubmittedValue() on the UIIn. The expression has to evaluate to a public method which has a javax.faces.component.UIInput parameter and returns a List<String>, a List<org.apache.myfaces.tobago.model.AutoSuggestItem> or a org.apache.myfaces.tobago.model.AutoSuggestItems.
totalCountfalsejavax.el.ValueExpression
(must evaluate to java.lang.Integer)
The 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.
Type: java.lang.Integer
Default: -1
updatefalsejavax.el.ValueExpression
(must evaluate to java.lang.Boolean)
TODO: not implemented yet

Should the list be updated while typing (via AJAX). This is the default behaviour. If you set this value to false, please set the minimumCharacters="0".


Type: boolean
Default: true

Output generated by Vdldoc View Declaration Language Documentation Generator.