org.richfaces.component

Class AbstractSelect

java.lang.Object

javax.faces.component.UIComponent

javax.faces.component.UIComponentBase

javax.faces.component.UIOutput

javax.faces.component.UIInput

javax.faces.component.UISelectOne

org.richfaces.component.AbstractSelectComponent

org.richfaces.component.AbstractSelect

All Implemented Interfaces:

EventListener, javax.faces.component.EditableValueHolder, javax.faces.component.PartialStateHolder, javax.faces.component.StateHolder, javax.faces.component.TransientStateHolder, javax.faces.component.ValueHolder, javax.faces.event.ComponentSystemEventListener, javax.faces.event.FacesListener, javax.faces.event.SystemEventListenerHolder, AutocompleteProps, org.richfaces.component.attribute.CoreProps, org.richfaces.component.attribute.DisabledProps, org.richfaces.component.attribute.EventsKeyProps, org.richfaces.component.attribute.EventsMouseProps, org.richfaces.component.attribute.FocusProps, org.richfaces.component.attribute.SelectItemsProps, org.richfaces.component.attribute.SelectProps, org.richfaces.component.MetaComponentEncoder, org.richfaces.component.MetaComponentResolver, org.richfaces.component.util.SelectItemsInterface

Direct Known Subclasses:

UISelect

public abstract class AbstractSelect
extends AbstractSelectComponent
implements org.richfaces.component.util.SelectItemsInterface, org.richfaces.component.MetaComponentResolver, org.richfaces.component.MetaComponentEncoder, org.richfaces.component.attribute.CoreProps, org.richfaces.component.attribute.DisabledProps, org.richfaces.component.attribute.EventsKeyProps, org.richfaces.component.attribute.EventsMouseProps, org.richfaces.component.attribute.SelectProps, AutocompleteProps, org.richfaces.component.attribute.SelectItemsProps

The <rich:select> component provides a drop-down list box for selecting a single value from multiple options. The <rich:select> component can be configured as a combo-box, where it will accept typed input. The component also supports keyboard navigation. The <rich:select> component functions similarly to the JSF UISelectOne component.

The <rich:select> can optionally be used in an auto-completing mode, where the values in the drop-down list are provided dynamically using either the autocompleteMethod or autocompleteList attributes. If these attributes are omitted, the component operates in the traditional non-auto-completing mode. Refer to the individual attribute documentation to see which attributes are applicable only with an auto-completing select list.

Author:

abelevich, Brian Leathem

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMPONENT_FAMILY
static String	COMPONENT_TYPE
static String	ITEMS_META_COMPONENT_ID

Fields inherited from class javax.faces.component.UISelectOne

INVALID_MESSAGE_ID

Fields inherited from class javax.faces.component.UIInput

CONVERSION_MESSAGE_ID, REQUIRED_MESSAGE_ID, UPDATE_MESSAGE_ID, VALIDATE_EMPTY_FIELDS_PARAM_NAME

Fields inherited from class javax.faces.component.UIComponent

ATTRS_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

Fields inherited from interface org.richfaces.component.MetaComponentResolver

META_COMPONENT_SEPARATOR_CHAR

Constructor Summary

Constructors

Constructor and Description
AbstractSelect()

Method Summary

Methods

Modifier and Type	Method and Description
void	encodeMetaComponent(javax.faces.context.FacesContext context, String metaComponentId)
abstract String	getActiveClass()
abstract String	getChangedClass()
abstract String	getClientFilterFunction() A javascript function used to filter the list of items in the select popup
abstract String	getDisabledClass()
abstract Object	getItemLabel() Label to be displayed to the user for the corresponding option.
abstract Object	getItemValue() Value to be returned to the server if the corresponding option is selected by the user.
Object	getItemValues()
abstract String	getMaxListHeight() The maximum height of the list
abstract String	getMinListHeight() The minimum height ot the list
abstract String	getVar() Expose the values from either the autocompleteList or autocompleteMethod attributes under a request scoped key so that the values may be referred to in an EL expression while rendering this component.
abstract boolean	isEnableManualInput() If "true" Allows the user to type into a text field to scroll through or filter the list.
abstract boolean	isSelectFirst() If "true" as the user types to narrow the list, automatically select the first element in the list.
abstract boolean	isShowButton() When "true" display a button to expand the popup list
void	processEvent(javax.faces.event.ComponentSystemEvent event)
String	resolveClientId(javax.faces.context.FacesContext facesContext, javax.faces.component.UIComponent contextComponent, String metaComponentId)
String	substituteUnresolvedClientId(javax.faces.context.FacesContext facesContext, javax.faces.component.UIComponent contextComponent, String metaComponentId)
protected void	validateValue(javax.faces.context.FacesContext facesContext, Object value) Override the validateValue method in cases where the component implements SelectItemsInterface
boolean	visitTree(javax.faces.component.visit.VisitContext context, javax.faces.component.visit.VisitCallback callback)

Methods inherited from class org.richfaces.component.AbstractSelectComponent

getOnchange, getOnlistclick, getOnlistdblclick, getOnlisthide, getOnlistkeydown, getOnlistkeypress, getOnlistkeyup, getOnlistmousedown, getOnlistmousemove, getOnlistmouseout, getOnlistmouseover, getOnlistmouseup, getOnlistshow, getOnselectitem

Methods inherited from class javax.faces.component.UISelectOne

getFamily

Methods inherited from class javax.faces.component.UIInput

addValidator, addValueChangeListener, clearInitialState, compareValues, decode, getConvertedValue, getConverterMessage, getRequiredMessage, getSubmittedValue, getValidator, getValidatorMessage, getValidators, getValue, getValueChangeListener, getValueChangeListeners, isEmpty, isImmediate, isLocalValueSet, isRequired, isValid, markInitialState, processDecodes, processUpdates, processValidators, removeValidator, removeValueChangeListener, resetValue, restoreState, saveState, setConverterMessage, setImmediate, setLocalValueSet, setRequired, setRequiredMessage, setSubmittedValue, setValid, setValidator, setValidatorMessage, setValue, setValueChangeListener, updateModel, validate

Methods inherited from class javax.faces.component.UIOutput

getConverter, getLocalValue, setConverter

Methods inherited from class javax.faces.component.UIComponentBase

addClientBehavior, addFacesListener, broadcast, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getRenderer, getRendererType, getRendersChildren, getValueBinding, invokeOnComponent, isRendered, isTransient, processRestoreState, processSaveState, queueEvent, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding, subscribeToEvent, unsubscribeFromEvent

Methods inherited from class javax.faces.component.UIComponent

encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.richfaces.component.attribute.CoreProps

getStyle, getStyleClass, getTitle

Methods inherited from interface org.richfaces.component.attribute.DisabledProps

isDisabled

Methods inherited from interface org.richfaces.component.attribute.EventsKeyProps

getOnkeydown, getOnkeypress, getOnkeyup

Methods inherited from interface org.richfaces.component.attribute.EventsMouseProps

getOnclick, getOndblclick, getOnmousedown, getOnmousemove, getOnmouseout, getOnmouseover, getOnmouseup

Methods inherited from interface org.richfaces.component.attribute.SelectProps

getDefaultLabel, getItemClass, getListClass, getListHeight, getListWidth, getSelectItemClass

Methods inherited from interface org.richfaces.component.attribute.AutocompleteProps

getAutocompleteList, getAutocompleteMethod, getAutocompleteMethodWithOneParameter, getMinChars, getMode, setAutocompleteMethod, setAutocompleteMethodWithOneParameter

Methods inherited from interface org.richfaces.component.attribute.FocusProps

getOnblur, getOnfocus, getTabindex

Methods inherited from interface javax.faces.component.ValueHolder

getConverter, getLocalValue, setConverter

Field Detail

ITEMS_META_COMPONENT_ID

public static final String ITEMS_META_COMPONENT_ID

See Also:

Constant Field Values

COMPONENT_TYPE

public static final String COMPONENT_TYPE

See Also:

Constant Field Values

COMPONENT_FAMILY

public static final String COMPONENT_FAMILY

See Also:

Constant Field Values

Constructor Detail

AbstractSelect

public AbstractSelect()

Method Detail

getItemValues

public Object getItemValues()

Specified by:

getItemValues in interface org.richfaces.component.util.SelectItemsInterface

isEnableManualInput

public abstract boolean isEnableManualInput()

If "true" Allows the user to type into a text field to scroll through or filter the list. Implicitly true when using an auto-completing select list.

Default is "false"

isSelectFirst

public abstract boolean isSelectFirst()

If "true" as the user types to narrow the list, automatically select the first element in the list. Applicable only when enableManualInput is "true".

Default is "true"

isShowButton

public abstract boolean isShowButton()

When "true" display a button to expand the popup list

Default is "true"

getMinListHeight

public abstract String getMinListHeight()

The minimum height ot the list

getMaxListHeight

public abstract String getMaxListHeight()

The maximum height of the list

getClientFilterFunction

public abstract String getClientFilterFunction()

A javascript function used to filter the list of items in the select popup

getActiveClass

public abstract String getActiveClass()

Specified by:

getActiveClass in interface org.richfaces.component.attribute.SelectProps

getChangedClass

public abstract String getChangedClass()

Specified by:

getChangedClass in interface org.richfaces.component.attribute.SelectProps

getDisabledClass

public abstract String getDisabledClass()

Specified by:

getDisabledClass in interface org.richfaces.component.attribute.SelectProps

getItemValue

public abstract Object getItemValue()

Value to be returned to the server if the corresponding option is selected by the user. Used only with an auto-completing select, where the list of items comes from either the autocompleteList or autocompleteMethod attributes.

Specified by:

getItemValue in interface org.richfaces.component.attribute.SelectItemsProps

getItemLabel

public abstract Object getItemLabel()

Label to be displayed to the user for the corresponding option. Used only with an auto-completing select, where the list of items comes from either the autocompleteList or autocompleteMethod attributes.

Specified by:

getItemLabel in interface org.richfaces.component.attribute.SelectItemsProps

getVar

public abstract String getVar()

Expose the values from either the autocompleteList or autocompleteMethod attributes under a request scoped key so that the values may be referred to in an EL expression while rendering this component. Used only in an auto-completing select component.

Specified by:

getVar in interface AutocompleteProps

Specified by:

getVar in interface org.richfaces.component.attribute.SelectItemsProps

validateValue

protected void validateValue(javax.faces.context.FacesContext facesContext,
                 Object value)

Override the validateValue method in cases where the component implements SelectItemsInterface

Overrides:

validateValue in class javax.faces.component.UISelectOne

Parameters:

facesContext -

value -

processEvent

public void processEvent(javax.faces.event.ComponentSystemEvent event)
                  throws javax.faces.event.AbortProcessingException

Specified by:

processEvent in interface javax.faces.event.ComponentSystemEventListener

Overrides:

processEvent in class javax.faces.component.UIComponent

Throws:

javax.faces.event.AbortProcessingException

resolveClientId

public String resolveClientId(javax.faces.context.FacesContext facesContext,
                     javax.faces.component.UIComponent contextComponent,
                     String metaComponentId)

Specified by:

resolveClientId in interface org.richfaces.component.MetaComponentResolver

visitTree

public boolean visitTree(javax.faces.component.visit.VisitContext context,
                javax.faces.component.visit.VisitCallback callback)

Overrides:

visitTree in class javax.faces.component.UIComponent

encodeMetaComponent

public void encodeMetaComponent(javax.faces.context.FacesContext context,
                       String metaComponentId)
                         throws IOException

Specified by:

encodeMetaComponent in interface org.richfaces.component.MetaComponentEncoder

Throws:

IOException

substituteUnresolvedClientId

public String substituteUnresolvedClientId(javax.faces.context.FacesContext facesContext,
                                  javax.faces.component.UIComponent contextComponent,
                                  String metaComponentId)

Specified by:

substituteUnresolvedClientId in interface org.richfaces.component.MetaComponentResolver