パッケージ jakarta.faces.model

クラス SelectItemGroup

  • 実装済みのインターフェース一覧:
    SerializableSE
    public class SelectItemGroup
extends SelectItem

    SelectItemGroup は SelectItem のサブクラスであり、実際に使用される UISelectMany または UISelectOne レンダラーの要件に応じて、下位の「サブメニュー」または「オプションリスト」として使用できるようになるオプションのセットを識別します。通常、このインスタンスの value プロパティは無視され、このインスタンスの label プロパティを使用してサブメニューにラベルが付けられます。

    このインスタンスの selectItems プロパティに SelectItemGroup インスタンスを組み込むことは可能ですが（これにより、サブメニューのカスケードに適したデータ構造が作成されます）、一部のレンダラーは、サポートするネストのレベルに制限を設ける場合があります。例: <select> 要素を作成する HTML ベースのレンダラーは、通常、このインスタンスを <optgroup> 要素としてレンダリングしますが、HTML 4.01 仕様では、ネストされたオプショングループは許可されていません。

    関連事項:
    連載形式

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

      • SelectItemGroup

        public SelectItemGroup()

        初期化されたプロパティ値を持たない SelectItemGroup を構築します。

      • SelectItemGroup

        public SelectItemGroup​(StringSE label)

        指定されたラベルを使用し、selectItem が関連付けられていない SelectItemGroup を作成します。value プロパティは長さゼロの文字列に設定され、description プロパティは null に設定され、disabled プロパティは false に設定されます。

        パラメーター:
        label - レスポンスでこのグループにレンダリングされるラベル
        例外:
        NullPointerExceptionSE - label が false の場合

      • SelectItemGroup

        public SelectItemGroup​(StringSE label,
                       StringSE description,
                       boolean disabled,
                       SelectItem... selectItems)

        指定されたプロパティで SelectItemGroup を構築します。value プロパティは、長さがゼロの文字列に設定されます。

        パラメーター:
        label - レスポンスでこのグループにレンダリングされるラベル
        description - ツールで使用するためのこのグループの説明
        disabled - このグループが無効になっていることを示すフラグ
        selectItems - このグループで利用可能なアイテムを記述する SelectItem の変数配列
        例外:
        NullPointerExceptionSE - label または selectItems が false の場合

      • SelectItemGroup

        public SelectItemGroup​(StringSE label,
                       StringSE description,
                       boolean disabled,
                       CollectionSE<? extends SelectItem> selectItems)

        指定されたプロパティで SelectItemGroup を構築します。value プロパティは、長さがゼロの文字列に設定されます。

        パラメーター:
        label - レスポンスでこのグループにレンダリングされるラベル
        description - ツールで使用するためのこのグループの説明
        disabled - このグループが無効になっていることを示すフラグ
        selectItems - このグループで利用可能なアイテムを説明する SelectItem のコレクション
        例外:
        NullPointerExceptionSE - label または selectItems が false の場合
        導入:
        4.0

    • メソッドの詳細

      • getSelectItems

        public SelectItem[] getSelectItems()

        このグループの従属 SelectItem のセットを返します。

        戻り値:
        このグループの下位 SelectItem のセット

      • setSelectItems

        public void setSelectItems​(SelectItem... selectItems)

        このグループの従属 SelectItem のセットを変数配列として設定します。

        パラメーター:
        selectItems - 変数配列としての下位アイテムの新しいセット
        例外:
        NullPointerExceptionSE - selectItems が null の場合

      • setSelectItems

        public void setSelectItems​(CollectionSE<? extends SelectItem> selectItems)

        このグループの下位 SelectItem のセットをコレクションとして設定します。

        パラメーター:
        selectItems - コレクションとしての下位アイテムの新しいセット。
        例外:
        NullPointerExceptionSE - selectItems が null の場合
        導入:
        4.0