Faces JSP ファイルへの選択リストの追加

いくつかの型の選択リスト・コンポーネントを Faces JSP ページで使用することができます。 コンボ・ボックス、リスト・ボックス、ラジオ・ボタン、 およびチェック・ボックスをユーザーのページにドラッグしてから、 動的にデータ・ソースにバインドすることができます。
以下の選択リスト・コンポーネントを追加することができます。 これらは、それぞれの「プロパティー」ビュー内ですべて同じプロパティーを持つことに注意してください。
  • コンボ・ボックス (selectOneMenu): ユーザーはドロップダウン・リストから 1 つの項目を選択します。
  • リスト・ボックス - 単一選択 (SelectOneListbox): ユーザーはリストから 1 つの項目を選択します。
  • リスト・ボックス - 複数選択 (SelectManyListbox): ユーザーは、リストから複数の項目を選択します。
  • ラジオ・ボタン・グループ (selectOneRadio): ユーザーは、リストから 1 つのラジオ・ボタンを選択します。
  • チェック・ボックス (selectBooleanCheckbox): ユーザーは 1 つの項目にチェックを付けるか、 またはチェックを外します。
  • チェック・ボックス・グループ (selectManyCheckbox): ユーザーはリストから 1 つ以上の項目にチェックを付けます。

Faces JSP ページへ選択コンポーネントを追加する方法:

  1. 選択リスト・コンポーネントのいずれかを Faces JSP ページへドラッグする。
  2. 選択リスト・コンポーネントの「プロパティー」ビューを開く。
  3. 「値」フィールドで、現行値が表示できるように、 または特定レコード・フィールドの値を変更できるように、データ・ソースにバインドすることができます。 例えば、新しい従業員レコードを作成しようとしている場合、 部門または都市を選択するための選択リストがあり、 選択する値は新しい従業員レコードの一部になります。
  4. チェック・ボックスまたはラジオ・ボタンの場合は、 「プロパティー」ビューの「方向」フィールドに、 「水平」または「垂直」を指定するか、またはデフォルトを受け入れる。 リスト・ボックスには、高さを行数で指定する。
  5. 静的選択項目に加えて、選択コンポーネントに動的選択項目を追加することができます。 動的選択項目の値には、対象のデータ・ソースから入手する。
    1. 「選択項目の追加」または「選択項目のセットを追加」をクリックする。 「名前」列にエントリーが追加されます。
    2. エントリーの名前を編集するには、「名前」列の名前をクリックしてその名前を編集する。
    3. 新しい項目をデータ値にバインドする場合は、 「値」セルの中をクリックしてから、セル内に表示されるボタンをクリックする。 「ページ・データ・オブジェクトの選択」ダイアログが開きます。
    4. 選択項目または選択項目のセットとバインドするために、 レコード・リストからプロパティーを選択して、「OK」をクリックする。 (データ・ソースが定義済みになっていなければならないので、注意してください。) 実行時に、データ・ソースから得られたリストが表示されます。
    5. 選択を除去するには、選択項目を選んでから「除去」をクリックする。 リスト内で選択項目を移動するには、 選択項目を選んでから「上に移動」、 または「下に移動」をクリックする。

その他の詳細:

動的な値の場合、選択項目のリストは 1 つまたは複数の selectitem または selectitems タグによって生成されます。 selectitems タグの value 属性は、 選択項目を含むデータ要素を指し示します。 selectitems タグでは、以下のいずれかのフォームのデータを想定しています。

その他のデータ型の場合、ツールは value を生成して、 データをこれらの必要なフォームのいずれかに変換します。 value のフォームは selectitems.bean.label.value.toArray のようになります。各部位の説明は以下のとおりです。 「ページ・データ」ビューからバインドするときに、フィールドを個別に選択すると、 ラベルと値の両方に同じフィールドを使用する value が必ず作成されます。 UI ラベルと渡される値に異なるストリングを使用するには、上記のパターンに従って 手動で value を修正します。 selectitems タグの value 属性の例を以下に示します。
関連タスク
データ・ソースに接続する入力フォームの作成
Faces JSP ページへの入力コンポーネントの追加
Faces JSP ファイルへのハイパーリンクの追加
Faces JSP ページにおけるナビゲーション規則の使用
ファイル・アップロード・コンポーネントの使用
JavaServer Faces アプリケーションにおけるエラーの管理
Faces JSP ファイルの作成

フィードバック