JavaServer Faces 標準のラジオボタンリストコンポーネント
を「パレット」の「標準」カテゴリからビジュアルデザイナーにドラッグすることによって、デフォルトで 1 行に 3 つのラジオボタンが含まれる表を作成できます。
ラジオボタンリストは複合コンポーネントです。囲みコンポーネント (radioButtonList) はリストそのもののスタイルと動作を管理し、内部コンポーネント (radioButtonListSelectItems) は、リスト内の実際の項目へのバインドに使用されます。3 つ目の関係コンポーネント (radioButtonListDefaultItems) は、ページに追加したラジオボタンリストコンポーネントごとに 1 つ作成され、リストの静的デフォルト項目 (項目 1、項目 2、項目 3) からなる配列を含みます。一般には、この最後のコンポーネントは操作しません。ラジオボタンリストコンポーネントをページに追加すると、「ナビゲータ」ウィンドウでこれらすべてのコンポーネントを確認できます。
ラジオボタンリストは、HTML では、各セルに <input style="radio"> を含む <table> タグになります。各 <input> は、各ボタンのラベルを提供する <label> で囲まれます。
ラジオボタンリストコンポーネントを Visual Web JSF ページに追加すると、次の操作を実行できます。
id 属性の値になります。ページ Bean では、このプロパティーの値が HtmlSelectOneList オブジェクトの名前になります。radioButtonListSelectItems の部分で制御されます。コンポーネントの radioButtonListSelectItems の部分を設定する一般的な方法については、このあとの「データベースにリスト項目をバインド」を参照してください。
「ナビゲータ」ウィンドウで「radioButtonListSelectItems」ノードを右クリックし、「プロパティーのバインド」を選択して、リストを生成するセッション Bean のプロパティーにその「value」プロパティーをバインドすることもできます。詳細は、「ナビゲータ」ウィンドウでセッション Bean の説明を参照してください。
validate メソッド内にカーソルが置かれた状態で Java エディタが開き、このコンポーネントの値の妥当性を検査するコードを挿入できます。processValueChange メソッド内にカーソルが置かれた状態で Java エディタが開き、このコンポーネントの値に変更があったとき (たとえば、このコンポーネントでラジオボタンを選択して制御する別のコンポーネントの値をユーザーが変更したとき) に実行するコードを挿入できます。value」プロパティーをオブジェクトまたはデータプロバイダにバインドします。 common_timeoutSubmitForm(this.form, '<コンポーネント ID>'); に設定されます。このコードによって、実行時にユーザーがコンポーネントの値を変更した場合に自動的にフォームが送信されます。フォームが送信されたら、サーバーで変換と妥当性検査が行われ、値変更のリスナーメソッドがある場合はそのメソッドが実行されてから、ページが再表示されます。
「変更時に自動送信」が設定されているコンポーネントには、仮想フォームを使用して、フォームの送信時に処理される入力フィールドを制限できます。自動送信するコンポーネントを、仮想フォームを送信するように定義した場合、自動送信時には仮想フォームに含まれるフィールドだけが処理されます。