public class UISelectOne extends UIInput
UISelectOne は UIComponent
であり、利用可能なオプションの個別のセットの中からユーザーが 0 個または 1 個のアイテムを選択したことを表します。ユーザーは選択した値を変更できます。オプションで、コンポーネントの value
プロパティとして保存することにより、現在選択されているアイテムを使用してコンポーネントを事前構成できます。
このコンポーネントは通常、選択ボックスまたはラジオボタンのグループとしてレンダリングされます。
デフォルトでは、rendererType
プロパティは "javax.faces.Menu
" に設定されています。この値は、setRendererType()
メソッドを呼び出すことで変更できます。
修飾子と型 | フィールドと説明 |
---|---|
static StringSE | COMPONENT_FAMILY このコンポーネントの標準コンポーネントファミリ。 |
static StringSE | COMPONENT_TYPE このコンポーネントの標準コンポーネント型。 |
static StringSE | INVALID_MESSAGE_ID 使用可能なオプションと一致しない値が指定された場合に作成される FacesMessage のメッセージ ID。 |
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
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
コンストラクターと説明 |
---|
UISelectOne() デフォルトのプロパティ値で新しい UISelectOne インスタンスを作成します。 |
修飾子と型 | メソッドと説明 |
---|---|
StringSE | getFamily() このコンポーネントが属するコンポーネントファミリの識別子を返します。 |
StringSE | getGroup() ラジオボタングループの名前を返します。 |
void | processValidators(FacesContext context)
|
void | setGroup(StringSE group) ラジオボタングループの名前を設定します。 |
protected void | validateValue(FacesContext context, ObjectSE value) UIInput から継承された標準的な検証動作に加えて、任意の指定された値が利用可能なオプションの 1 に等しいことを確認してください。 |
addValidator, addValueChangeListener, clearInitialState, compareValues, decode, getConvertedValue, getConverterMessage, getRequiredMessage, getSubmittedValue, getValidator, getValidatorMessage, getValidators, getValue, getValueChangeListener, getValueChangeListeners, isEmpty, isImmediate, isLocalValueSet, isRequired, isValid, markInitialState, processDecodes, processUpdates, removeValidator, removeValueChangeListener, resetValue, restoreState, saveState, setConverterMessage, setImmediate, setLocalValueSet, setRequired, setRequiredMessage, setSubmittedValue, setValid, setValidator, setValidatorMessage, setValue, setValueChangeListener, updateModel, validate
getConverter, getLocalValue, setConverter
addClientBehavior, addFacesListener, broadcast, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getPassThroughAttributes, getRenderer, getRendererType, getRendersChildren, getValueBinding, invokeOnComponent, isRendered, isTransient, processRestoreState, processSaveState, queueEvent, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding, subscribeToEvent, unsubscribeFromEvent
encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression, visitTree
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
getConverter, getLocalValue, setConverter
public static final StringSE COMPONENT_FAMILY
このコンポーネントの標準コンポーネントファミリ。
public static final StringSE INVALID_MESSAGE_ID
使用可能なオプションと一致しない値が指定された場合に作成される FacesMessage
のメッセージ ID。
public UISelectOne()
デフォルトのプロパティ値で新しい UISelectOne
インスタンスを作成します。
public StringSE getFamily()
UIComponent
このコンポーネントが属するコンポーネントファミリの識別子を返します。この識別子は、rendererType
プロパティの値と組み合わせて、このコンポーネントインスタンスに適切な Renderer
を選択するために使用できます。このメソッドは null
を返すべきではないことに注意してください
public StringSE getGroup()
ラジオボタングループの名前を返します。
UIForm
親内に同じグループを持つラジオボタンコンポーネントは、チェックされるときに他のすべてのチェックを外します。value
属性がない場合は、グループの最初のコンポーネントの属性が使用されます。UISelectItem
の子が存在しない場合は、グループの最初のコンポーネントの子が使用されます。
public void setGroup(StringSE group)
ラジオボタングループの名前を設定します。
group
- ラジオボタングループの名前。public void processValidators(FacesContext context)
getGroup()
が設定されていて、UIInput.getSubmittedValue()
が空で、UIForm
親内に同じグループを持つ少なくとも 1 つの他のコンポーネントが空でない UIInput.getSubmittedValue()
を持っているか、UIInput.isLocalValueSet()
で true
を返すか、UIInput.isValid()
で false
を返す場合、現在のコンポーネントの検証をスキップし、それ以外の場合は実行 super.processValidators(context)
による標準スーパークラス処理。
UIInput
の processValidators
context
- FacesContext
(処理中のリクエスト)PreValidateEvent
, PostValidateEvent
protected void validateValue(FacesContext context, ObjectSE value)
UIInput
から継承された標準的な検証動作に加えて、任意の指定された値が利用可能なオプションの 1 に等しいことを確認してください。各オプションを比較する前に、式言語の強制ルールに従って、オプションの値の型をこのコンポーネントの値の型に強制します。指定された値がどのオプションとも等しくない場合は、エラーメッセージをエンキューし、valid
プロパティを false
に設定します。
UIInput.isRequired()
が true
を返し、現在の値が UISelectItem.isNoSelectionOption()
メソッドが true
を返す内部 UISelectItem
の値と等しい場合は、エラーメッセージをキューに入れ、valid
プロパティを false
に設定します。
UIInput
の validateValue
context
- 現在のリクエストの FacesContext
value
- メンバーシップをテストするために変換された値。NullPointerExceptionSE
- context
が null
の場合 Copyright © 2019 Eclipse Foundation.
Use is subject to license terms.