JSF 1.1 ラジオボタンコンポーネント

関連項目

ラジオボタンコンポーネント ラジオボタンコンポーネントのアイコン を「パレット」の「基本」カテゴリからビジュアルデザイナーにドラッグすることによって、ラベル付きのラジオボタンを 1 つ作成できます。

一般に、ラジオボタンコンポーネントはグループ単位で使用します。ラベルを使って事前にフォーマットされたラジオボタンのセットが必要な場合は、代わりにラジオボタングループコンポーネントを使用します。

ラジオボタンは、表のセルやグループパネルなど、コンテナコンポーネントにドロップすることもできます。

ラジオボタンは、BooleanByteCharacterDoubleFloatIntegerLongShortString などの定義済みのクラスばかりでなく、ユーザーが定義したクラスの任意のオブジェクトを表すことができます。また、プリミティブの値を表すこともできます。

Boolean 型の値は、表の行などの項目が選択されているかどうかを示す場合に便利です。String 型の値は、インタフェースで行われたラジオボタン選択の値を渡す場合に便利です。アプリケーション定義の Object 型の値またはクラスインスタンスを使用すると、ラジオボタン選択に関連する詳細情報を保持できます。

1 つのラジオボタンでは、次の型のデータを表すことができます。

ラジオボタングループでは、次の型のデータを表すことができます。

ラジオボタンコンポーネントは、表の行の中など、ラジオボタングループコンポーネントのレイアウトが適切ではない場合に便利です。

選択状態のラジオボタンの検出

ラジオボタンコンポーネントは、「selected」プロパティーと「selectedValue」プロパティーの両方を使用して、ラジオボタンの選択状態に関する情報を渡します。「selected」プロパティーは、ラジオボタンが選択されていることを示すために使用されます。ボタンが選択されていることがページに表示されます。「selectedValue」プロパティーは、ラジオボタンのデータ値を渡すために使用します。ラジオボタンは、「selected」プロパティーの値が「selectedValue」プロパティーの値と等しいときに選択されているとみなされます。「selectedValue」プロパティーと「selected」プロパティーに同じ値を割り当てることで、ページをはじめて表示するときにラジオボタンを選択状態で表示できます。

selectedValue」プロパティーの値を指定しなかった場合、または値が null の場合、次の項で説明するように、ラジオボタンは Boolean 型コントロールのように機能します。

selected」プロパティーと「selectedValue」プロパティーには、評価した結果がプリミティブの値になる値バインド式を割り当てることができます。

Boolean 型コントロールとしてのラジオボタンコンポーネントの使用

selectedValue」プロパティーの値を指定しなかった場合、または値が null の場合、ラジオボタンは Boolean 型コントロールのように機能します。

ラジオボタンを Boolean 型コントロールとして使用する場合は、「selectedValue」プロパティーの値を指定しないでください。「selected」プロパティーの値が null ではなく、True の Boolean インスタンスまたは Boolean 型のプリミティブの場合、ラジオボタンは選択状態になります。ラジオボタンが選択状態ではない場合、「selected」プロパティーの値は False の Boolean インスタンスまたは Boolean 型のプリミティブになります。

アプリケーション定義の値を表すラジオボタン

selectedValue」プロパティーにアプリケーション定義オブジェクトの値を割り当てることで、選択状態のラジオボタンの値を表すことができます。ラジオボタンが選択されると、「selected」プロパティーの値に、「selectedValue」プロパティーの値が割り当てられます。

selectedValue」プロパティーの値がアプリケーション定義のオブジェクトの場合は、String 型の値との間で変換を行うコンバータを登録する必要があります。このコンバータを使用して、ラジオボタンの値を HTML の <input> 要素の値としてエンコードしたり、要求で送信された値をデコードしたりします。また、アプリケーション定義オブジェクトは、選択状態にあるラジオボタンを検出するために「selectedValue」プロパティーの値と「selected」プロパティーの値が比較されるときに true を返す equals() メソッドをサポートする必要があります。

グループ内の単一のコントロールとしてのラジオボタンの使用

name」プロパティーは、ラジオボタンがグループの構成要素であるかどうかを示します。グループ内のラジオボタンはすべて「name」プロパティーの値が同じです。グループは、ラジオボタンを 1 つだけ選択できる選択リストのように機能します。「name」プロパティーの値は、ラジオボタンが含まれるページのスコープ内で一意である必要があります。

関連項目
ラジオボタンコンポーネントの「プロパティー」ウィンドウ
コンポーネントのプロパティーのバインド
コンポーネントの手順
コンポーネント関連の手順早見表
Visual Web の「パレット」について

著作権と商標について