Package jakarta.faces.component
Class UISelectOne
- java.lang.Object
-
- jakarta.faces.component.UIComponent
-
- jakarta.faces.component.UIComponentBase
-
- jakarta.faces.component.UIOutput
-
- jakarta.faces.component.UIInput
-
- jakarta.faces.component.UISelectOne
-
- All Implemented Interfaces:
EditableValueHolder
,PartialStateHolder
,StateHolder
,TransientStateHolder
,ValueHolder
,ComponentSystemEventListener
,FacesListener
,SystemEventListenerHolder
,EventListener
- Direct Known Subclasses:
HtmlSelectOneListbox
,HtmlSelectOneMenu
,HtmlSelectOneRadio
@JSFComponent(defaultRendererType="jakarta.faces.Menu") @JSFJspProperty(name="hideNoSelectionOption", returnType="boolean") public class UISelectOne extends UIInput
Component for choosing one option out of a set of possibilities.This component is expected to have children of type UISelectItem or UISelectItems; these define the set of possible options that the user can choose from.
See the javadoc for this class in the Faces Specification for further details.
-
-
Field Summary
Fields Modifier and Type Field Description static String
COMPONENT_FAMILY
static String
COMPONENT_TYPE
static String
INVALID_MESSAGE_ID
-
Fields inherited from class jakarta.faces.component.UIInput
ALWAYS_PERFORM_VALIDATION_WHEN_REQUIRED_IS_TRUE, CONVERSION_MESSAGE_ID, EMPTY_STRING_AS_NULL_PARAM_NAME, REQUIRED_MESSAGE_ID, UPDATE_MESSAGE_ID, VALIDATE_EMPTY_FIELDS_PARAM_NAME
-
Fields inherited from class jakarta.faces.component.UIComponent
ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, FACETS_KEY, VIEW_LOCATION_KEY
-
-
Constructor Summary
Constructors Constructor Description UISelectOne()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description String
getFamily()
String
getGroup()
void
processValidators(FacesContext context)
Check whether a group exists and then visit all the UISelectItem elements within the UISelectOne radio components to check if the submitted value is empty (ie.void
setGroup(String group)
protected void
validateValue(FacesContext context, Object value)
Verify that the result of converting the newly submitted value is equal to the value property of one of the child SelectItem objects.-
Methods inherited from class jakarta.faces.component.UIInput
addValidator, addValueChangeListener, broadcast, clearInitialState, compareValues, decode, getConvertedValue, getConverterMessage, getRequiredMessage, getSubmittedValue, getValidatorMessage, getValidators, getValue, getValueChangeListeners, isEmpty, isImmediate, isLocalValueSet, isRequired, isValid, markInitialState, processDecodes, processUpdates, removeValidator, removeValueChangeListener, resetValue, restoreState, saveState, setConverterMessage, setImmediate, setLocalValueSet, setRequired, setRequiredMessage, setSubmittedValue, setValid, setValidatorMessage, setValue, updateModel, validate
-
Methods inherited from class jakarta.faces.component.UIOutput
getConverter, getLocalValue, setConverter
-
Methods inherited from class jakarta.faces.component.UIComponentBase
addClientBehavior, addFacesListener, encodeAll, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getParent, getPassThroughAttributes, getRenderer, getRendererType, getRendersChildren, invokeOnComponent, isRendered, isTransient, processRestoreState, processSaveState, queueEvent, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, visitTree
-
Methods inherited from class jakarta.faces.component.UIComponent
getClientId, 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, unsubscribeFromEvent
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface jakarta.faces.component.ValueHolder
getConverter, getLocalValue, setConverter
-
-
-
-
Field Detail
-
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
-
INVALID_MESSAGE_ID
public static final String INVALID_MESSAGE_ID
- See Also:
- Constant Field Values
-
-
Method Detail
-
processValidators
public void processValidators(FacesContext context)
Check whether a group exists and then visit all the UISelectItem elements within the UISelectOne radio components to check if the submitted value is empty (ie. not submitted) or if a previous group item has been has failed to be validated (if no so further validation processing is needed)- Overrides:
processValidators
in classUIInput
- See Also:
UIInput.processValidators(jakarta.faces.context.FacesContext)
-
validateValue
protected void validateValue(FacesContext context, Object value)
Verify that the result of converting the newly submitted value is equal to the value property of one of the child SelectItem objects. If this is not true, a validation error is reported.- Overrides:
validateValue
in classUIInput
- See Also:
UIInput.validateValue(jakarta.faces.context.FacesContext,java.lang.Object)
-
getGroup
public String getGroup()
-
setGroup
public void setGroup(String group)
-
-