パッケージ 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_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

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