パッケージ jakarta.faces.model

クラス SelectItemGroup

java.lang.ObjectSE
jakarta.faces.model.SelectItem
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