ラジオボタングループコンポーネント
を「パレット」の「基本」カテゴリからビジュアルデザイナーにドラッグすることによって、デフォルトで 1 列に 3 つのラジオボタンが含まれる表を作成できます。
ラジオボタンは、HTML の <table> 要素で表形式で描画されます。行数は、ラジオボタン数で定義します。列数は、「columns」プロパティーで定義します。デフォルトのレイアウトは 1 列です。1 行に複数のラジオボタンを配置するには、「columns」プロパティーをラジオボタン数に設定します。
ラジオボタングループでは、次の型のデータを表すことができます。
「items」プロパティーは、配列かコレクション、または com.sun.rave.web.ui.model.Option のリストにコンポーネントを関連付けます。このプロパティーを設定するには、コンポーネントを右クリックし、「データにバインド」を選択します。
「ナビゲータ」ウィンドウには、リストの生成にデフォルトで使用される、radioButtonGroup1DefaultOptions というような名前のオブジェクトが表示されます。デフォルトのリスト項目を簡単に変更する方法としては、後述するようにコンポーネントを右クリックし、「デフォルトオプションを設定」を選択することによって、このオブジェクトを編集する方法があります。
ユーザーが選択した項目を取得するオブジェクトにコンポーネントを関連付けるには、「selected」プロパティーを設定します。コンポーネントがはじめて描画されたとき、「selected」プロパティーの値に対応するオプションがある場合は、そのオプションが選択状態で示されます。ユーザーがラジオボタンを選択すると、そのコンポーネントの「selected」プロパティーには選択された値が含まれます。後述するように、このプロパティーを設定するには、コンポーネントを右クリックし、「プロパティーのバインド」を選択します。
コンポーネントをビジュアルデザイナーにドラッグすると、次の操作を実行できます。
id 属性の値になります。ページ Bean では、このプロパティーの値が RadioButtonGroup オブジェクトの名前になります。for」プロパティーには、グループ内の最初のラジオボタンが設定されます。label」プロパティーで指定されたラベルのスタイルレベルを設定します。値には、「強 (1)」、「中 (2)」、「弱 (3)」が設定できます。デフォルト値は「中 (2)」です。 validate メソッド内にカーソルが置かれた状態で Java エディタが開き、このコンポーネントの値の妥当性を検査するコードを挿入できます。processValueChange メソッド内にカーソルが置かれた状態で Java エディタが開き、このコンポーネントの値に変更があったとき (たとえば、このコンポーネントの値を制御する別のコンポーネントの値をユーザーが変更したとき) に実行するコードを挿入できます。common_timeoutSubmitForm(this.form, '<コンポーネント ID>'); に設定されます。このコードによって、実行時にユーザーがコンポーネントの値を変更した場合に自動的にフォームが送信されます。フォームが送信されたら、サーバーで変換と妥当性検査が行われ、値変更のリスナーメソッドがある場合はそのメソッドが実行されてから、ページが再表示されます。
「変更時に自動送信」が設定されているコンポーネントには、仮想フォームを使用して、フォームの送信時に処理される入力フィールドを制限できます。自動送信するコンポーネントを、仮想フォームを送信するように定義した場合、自動送信時には仮想フォームに含まれるフィールドだけが処理されます。
items」プロパティーを、オブジェクト、データベース表のデータプロバイダ、または JavaBeans オブジェクトのデータプロバイダにバインドします。
items」プロパティーをオブジェクトにバインドするには、「オブジェクトにバインド」タブを選択し、リストの生成に使用する Bean プロパティーを選択します。この Bean プロパティーは、メンバーがすべて com.sun.rave.web.ui.model.Option のサブクラスである Object 型の配列、マップ、またはコレクションである必要があります。
items」プロパティーを、リストの生成に使用するデータベース表または JavaBeans オブジェクトのデータプロバイダにバインドするには、「データプロバイダにバインド」タブを選択し、データプロバイダを選択します。データプロバイダがない場合は、データベース表または JavaBeans オブジェクトをページに追加する必要があります。詳細は、データベースにリストコンポーネントをバインドを参照してください。 selected」プロパティーを Object 配列、プリミティブの配列、または ArrayList にバインドします。配列をプロパティーとしてセッション Bean などの管理 Bean に追加している必要があります。この Bean プロパティーを使用して、ページ送信後にユーザーの選択内容を評価できます。radioButtonGroup#defaultOptions オブジェクトを編集し、表示されるラジオボタンを変更できます。通常は、上記の「データにバインド」の項で説明したように、「items」プロパティーを、使用するデータベースまたはオブジェクトにバインドして、ラジオボタングループの項目を設定します。