o
Tag dropDownFieldFilter




Tag Information
Tag Classorg.openfaces.taglib.jsp.filter.DropDownFieldFilterJspTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredBinding TypeELDefaultDescription
accesskeyfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullAn access key for the filter component.
allRecordsTextfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"<All>"Text that is displayed instead of "" in the filter's drop-down list.
autoCompletefalsejavax.el.ValueExpression
(must evaluate to boolean)
truetrueSpecifies whether the field completes incompletely entered text as the user types it. The text is completed to the first drop-down item that starts with the typed text. The part that was added as a result of auto-completion is marked as selected. See also the suggestionMinChars and suggestionDelay attributes which define when auto-completion starts.
autoFilterDelayfalsejavax.el.ValueExpression
(must evaluate to int)
true700Specifies the delay in milliseconds when the filtering is performed automatically after the user has entered some value in the filter, or turns off automatic filtering in case -1 is specified as a value for this attribute.
bindingfalsejavax.el.ValueExpression
(must evaluate to org.openfaces.component.table.DataTable)
onlynullA value-binding expression that associates the component with a backing bean property.
buttonAlignmentfalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
true"right"Defines whether the button that opens the drop-down list is positioned to the right or to the left of the text field.
Available values are:
"left"
"right"
buttonClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the drop-down button.
buttonImageUrlfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullURL of the image file for the drop-down button.
buttonStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the drop-down button.
caseSensitivefalsejavax.el.ValueExpression
(must evaluate to boolean)
truefalseSpecifies whether letter case should be exactly matched when obtaining filtering results.
conditionfalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
falsenullThe filtering condition that should be used for comparing the values specified in this filter component to the values specified in data records. It should have a format of "" or "not ", where is one of the following values: equals, contains, beginsWith, endsWith, less, greater, lessOrEqual, greaterOrEqual. This attribute is not effective when the "value" attribute is defined. In case of specifying the "value" attribute, you should specify the condition as part of the ExpressionFilterCriterion object bound to the "value" attribute.
Available values are:
"equals"
"contains"
"beginsWith"
"endsWith"
"less"
"greater"
"lessOrEqual"
"greaterOrEqual"
"not equals"
"not contains"
"not beginsWith"
"not endsWith"
converterfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA converter for the filter value. Should be specified as a value-binding expression or converter identifier.
customValueAllowedfalsejavax.el.ValueExpression
(must evaluate to boolean)
truetrueA flag that indicates whether it is possible to specify only a value that exists in the list of this component's drop-down items ("false"), or whether it is possible to enter any value ("true").
disabledButtonImageUrlfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullURL of the image file for the drop-down button in the disabled state.
emptyRecordsTextfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"<Empty>"Text that is displayed instead of "" in the filter's drop-down list.
expressionfalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
onlynullDefines an expression that is used to obtain a record's value by which records are to be filtered.
fieldClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the text field.
fieldStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the text field.
focusedClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name of the DropDownFieldFilter component when it is focused.
focusedStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style of the DropDownFieldFilter component when it is focused.
forfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
falsenullID of a filterable component that should be filtered with this component. It should be defined in the same way as the "for" property of the standard HTMLOutputLabel component. If this attribute is not specified then this filter component should be located inside of a filterable component (DataTable or TreeTable).
horizontalGridLinesfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for horizontal lines in the drop-down list. Should be specified as the CSS "border" property but without the prefix "border:".
idfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
falsenullThe component identifier.
listAlignmentfalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
true"left"Defines how items in the drop-down list are aligned.
Available values are:
"left"
"right"
listClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the drop-down list.
listItemClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for a list item.
listItemStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for a list item.
listStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the drop-down list.
maxlengthfalsejavax.el.ValueExpression
(must evaluate to int)
trueInteger.MIN_VALUEThe maximum number of characters that can be entered in the filter field. It is still possible to select any text from the drop-down list no matter how long it is.
nonEmptyRecordsTextfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"<Non-empty>"Text that is displayed instead of "" in the filter's drop-down list.
oddListItemClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for an odd list item, if different from listItemClass.
oddListItemStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for an odd list item, if different from listItemStyle.
optionsfalsejavax.el.ValueExpression
(must evaluate to java.util.Collection)
onlynullThe filtering options that appear in the filter's drop-down list instead of displaying all of the possible values.
pressedButtonClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the drop-down button in the pressed state.
pressedButtonStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the drop-down button in the pressed state.
promptTextfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullThis prompt text will be shown when value of component is empty.
promptTextClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the prompt text.
promptTextStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the prompt text.
rolloverButtonClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the drop-down button in the rollover state.
rolloverButtonStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the drop-down button in the rollover state.
rolloverClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the entire DropDownFieldFilter component in the rollover state.
rolloverFieldClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the text field in the rollover state.
rolloverFieldStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the text field in the rollover state.
rolloverListClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the drop-down list in the rollover state.
rolloverListItemClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for a list item in the rollover state.
rolloverListItemStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for a list item in the rollover state.
rolloverListStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the drop-down list in the rollover state.
rolloverStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the entire DropDownFieldFilter component in the rollover state.
stylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the entire filter component.
styleClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the entire filter component.
suggestionDelayfalsejavax.el.ValueExpression
(must evaluate to int)
true0The time period in milliseconds that specifies the delay after the last key press that should pass before starting auto-completion or auto-suggestion. This delay can be used to avoid too much Ajax requests to be sent to the server when the user is typing text, and only send one request when the user has stopped typing.
suggestionMinCharsfalsejavax.el.ValueExpression
(must evaluate to int)
true0The minimal number of characters that should be typed for auto-completion and auto-suggestion features to be activated.
suggestionModefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
true"stringStart"Specifies whether and how the drop-down list with suggestions should be shown when typing in the field. Any value except "none" means that suggestions are displayed. See also the suggestionMinChars and suggestionDelay attributes which define when auto-suggestion starts. Note that it's possible to specify all values except the "custom" suggestion mode (which is only available for DropDownField and SuggestionField components).
Available values are:
"stringStart" — works on the client side. Shows suggestions that begin with the entered value
"substring" — works on the client side. Shows suggestions that contain the entered value
"stringEnd" — works on the client side. Shows suggestions that end with the entered value
"all" — works on the client side. Shows all drop-down items in the list of suggestions
"none" — suggestion mode is turned off
tabindexfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullPosition of the component in the focus transition chain for the current document.
timeoutfalsejavax.el.ValueExpression
(must evaluate to int)
true-1A time period after which the drop-down list is closed automatically. The value "-1" means that the list does not close automatically.
titlefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullAn advisory title for the text field of this filter component.
valuefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
onlynullThe current filtering criterion selected in this filter component.

Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.