パッケージ jakarta.faces.component

クラス UISelectOne

java.lang.ObjectSE
jakarta.faces.component.UIComponent
jakarta.faces.component.UIComponentBase
jakarta.faces.component.UIOutput
jakarta.faces.component.UIInput
jakarta.faces.component.UISelectOne
実装済みのインターフェース一覧:
EditableValueHolder、PartialStateHolder、StateHolder、TransientStateHolder、ValueHolder、ComponentSystemEventListener、FacesListener、SystemEventListenerHolder、EventListenerSE
既知の直属サブクラス
HtmlSelectOneListbox、HtmlSelectOneMenu、HtmlSelectOneRadio
public class UISelectOne extends UIInput

UISelectOne は UIComponent であり、利用可能なオプションの個別のセットの中からユーザーが 0 個または 1 個のアイテムを選択したことを表します。ユーザーは選択した値を変更できます。オプションで、コンポーネントの value プロパティとして保存することにより、現在選択されているアイテムを使用してコンポーネントを事前構成できます。

このコンポーネントは通常、選択ボックスまたはラジオボタンのグループとしてレンダリングされます。

デフォルトでは、rendererType プロパティは "jakarta.faces.Menu" に設定されています。この値は、setRendererType() メソッドを呼び出すことで変更できます。

  • フィールドの詳細

    • COMPONENT_TYPE

      public static final StringSE COMPONENT_TYPE

      このコンポーネントの標準コンポーネント型。

      関連事項:

    • COMPONENT_FAMILY

      public static final StringSE COMPONENT_FAMILY

      このコンポーネントの標準コンポーネントファミリ。

      関連事項:

    • INVALID_MESSAGE_ID

      public static final StringSE INVALID_MESSAGE_ID

      使用可能なオプションと一致しない値が指定された場合に作成される FacesMessage のメッセージ ID。

      関連事項:

  • コンストラクターの詳細

    • UISelectOne

      public UISelectOne()

      デフォルトのプロパティ値で新しい UISelectOne インスタンスを作成します。

  • 方法の詳細

    • getFamily

      public StringSE getFamily()
      クラスからコピーされた説明: UIComponent

      このコンポーネントが属するコンポーネントファミリの識別子を返します。この識別子は、rendererType プロパティの値と組み合わせて、このコンポーネントインスタンスに適切な Renderer を選択するために使用できます。このメソッドは null を返すべきではないことに注意してください

      オーバーライド:
      クラス UIInput の getFamily 
      戻り値:
      コンポーネントファミリ（null 以外）。

    • getGroup

      public StringSE getGroup()

      ラジオボタングループの名前を返します。

      UIForm 親内に同じグループを持つラジオボタンコンポーネントは、チェックされるときに他のすべてのチェックを外します。value 属性がない場合は、グループの最初のコンポーネントの属性が使用されます。UISelectItem の子が存在しない場合は、グループの最初のコンポーネントの子が使用されます。

      戻り値:
      ラジオボタングループの名前。
      導入:
      2.3

    • setGroup

      public void setGroup(StringSE group)

      ラジオボタングループの名前を設定します。

      パラメーター:
      group - ラジオボタングループの名前。
      導入:
      2.3

    • processValidators

      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（処理中のリクエスト）
      関連事項:

    • validateValue

      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 の場合